From c9a3dfb7ccd1bb5e2602d0de8463b92e50b351fa Mon Sep 17 00:00:00 2001 From: Valentin Date: Tue, 16 Aug 2022 14:35:10 +0200 Subject: [PATCH] Updated Getting Started (markdown) --- Getting-Started.md | 28 +++++++++++++++++++++++++--- 1 file changed, 25 insertions(+), 3 deletions(-) diff --git a/Getting-Started.md b/Getting-Started.md index 3677d0c..405e375 100644 --- a/Getting-Started.md +++ b/Getting-Started.md @@ -1,6 +1,6 @@ **FModel is a [Freeware](https://www.gnu.org/philosophy/free-sw.html)** made to explore Unreal Engine games archives. This means that you don't have to pay for it and this won't change. Its [code](https://github.com/4sval/FModel) is open and available to everyone and reusable under certain conditions (see the [license text](https://github.com/4sval/FModel/blob/master/LICENSE) for more information). -FModel –of course– does not contain any malware, spyware, advertisements or undesired third-party programs. +FModel –of course– does not contain any malware, spyware, advertisements, or undesired third-party programs. ## Get Started Once FModel is installed and launched, it will verify the integrity of a bunch of files and folders before any window appears. @@ -44,7 +44,7 @@ We've spent a lot of time engineering the UX of this window in order to make the As said before, not to waste space, we bundled all navigation-related views into a single panel. Each view has its own information area to show stuff like archive's GUID, folder's package count, or package compression used. You can easily switch between views thanks to the shortcuts set under your [settings](). ### Archives -This view will display your game archives, whether they are encrypted or not. **FModel doesn't allow you to load exported game packages, but you can use [CUE4Parse](https://github.com/FabianFG/CUE4Parse)** to do so. If your game archives are encrypted, you will need an [AES encryption key]() in order to decrypt them. If done correctly, your archives able to be loaded will have archive_enabled next to them, otherwise it will be archive_disabled. +This view will display your game archives, whether they are encrypted or not. **FModel doesn't allow you to load exported game packages, but you can use [CUE4Parse](https://github.com/FabianFG/CUE4Parse)** to do so. If your game archives are encrypted, you will need an [AES encryption key]() in order to decrypt them. If done correctly, your archives able to be loaded will have archive_enabled next to them, otherwise it will be archive_disabled. You can choose to load a single archive, several or all of them, but also compare 2 states and only show new or modified packages. If you choose to compare, you will need a [backup file]() older than the state of your current game archives. @@ -55,11 +55,33 @@ This view will display your archives folder tree structure. You can open folders This view will display packages stored under your selected folder. You can extract, export, and save the properties of all game packages no matter their type. ## Property -In order to see packages' properties, you have at your disposal **up to 25 tabs**. Each tab is cut in half between the text area and the image area, both resizable. +In order to see packages' properties, you have at your disposal **up to 25 tabs**. Each tab is cut in half between the text area and the image area, both resizable. ### Text +Packages are made out of multiple exports that will all be displayed here and depending on the package extension, you will see different human-readable data formats (`INI`, `XML`, `TXT`, ...). Most of the time though, you will see the `JSON` format. If you don't know what is JSON or how to read it, you better [learn now](https://www.json.org/json-en.html). Since it is the most commonly seen, we've tweaked it a little bit: +- ![#FFCB6B](https://via.placeholder.com/15/FFCB6B/FFCB6B.png) Represents an object name +- ![#C3E88D](https://via.placeholder.com/15/C3E88D/C3E88D.png) Represents an object value as string +- ![#DDA0DD](https://via.placeholder.com/15/DDA0DD/DDA0DD.png) Represents a package, you can Left Click it +- ![#FFDAB9](https://via.placeholder.com/15/FFDAB9/FFDAB9.png) Represents a color, you can Mouse Hover it +- ![#FFF8DC](https://via.placeholder.com/15/FFF8DC/FFF8DC.png) Represents a link, you can CtrlLeft Click it +- ![#F78C6C](https://via.placeholder.com/15/F78C6C/F78C6C.png) Represents an object value as a number +- ![#61AFEF](https://via.placeholder.com/15/61AFEF/61AFEF.png) Represents an object value as a boolean + +With a Right Click on the tab, you can open a dedicated window where you will be able to fold/unfold the data. Keyboard shortcuts are as follow: +- CtrlKJ to unfold all regions +- CtrlKL to toggle fold the region your mouse cursor is in +- CtrlK0-9 to toggle fold a region by its index + ### Image +Whether the image is [generated by FModel]() or is a `Texture2D` embedded in the package, you will have the possibility to open it on a bigger window with a Double Left Click. On this new window, you can Hold Left Click to zoom in the image or Hold Left ClickScroll to zoom even deeper. + ### Sound +A package that triggers the Audio Player (AD) is a package that holds audio. Supported types are either `SoundWave` or `AkMediaAssetData`, so if you are expecting to see the AD pops up, the package you selected simply doesn't have any of these export types. The AD is made out of 2 panels. +1. The first panel displays your available output devices, the volume set, as well as a playlist containing your audio files set to be played one after the other. **DO NOT close the AD if you don't want your playlist to be cleared**. +2. The second panel displays **a timeline to seek to a position** in your currently playing audio file. But most importantly, it contains an audio spectrum just so you don't get bored while listening to your favorite audio files. + +Each individual audio file or the whole playlist can be saved with a Right Click on any of the files in your playlist. + ### Mesh ### Material ### Animation