Skip to content

Getting Started

Valentin edited this page Aug 16, 2022 · 16 revisions

FModel is a Freeware 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 is open and available to everyone and reusable under certain conditions (see the license text for more information).

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.

flowchart LR

A(Launch)-->B{Settings Exist}
B-->|Yes| C[Deserialize]
B-.->|No| D[Create]
E{Output Dirs Exists}
C-->E
D-.->E
E-->|Yes| F[Nice!]
E-.->|No| G[Create]
H(Window Appearance)
F-->H
G-.->H
Loading

Directory Selector

FModel has to ability to auto-detect installed games on your computer. These games will be prompted to you if none is selected yet. If your game is not on the list, you can add it manually at the bottom of the window. You can then press OK once you selected the game you want to load.

Main Window

We've spent a lot of time engineering the UX of this window in order to make the most out of it. We ended up with 3 panels, for ease of use, and to counter previous FModel versions' flaws, which were mainly based on a waste of space.

  1. Navigation
    1. Archives
    2. Folders
    3. Packages
  2. Property
    1. Text
    2. Image
    3. Sound
    4. Mesh
    5. Material
    6. Animation
  3. Console

image

Navigation

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 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.

Folders

This view will display your archives folder tree structure. You can open folders with either a Left Click on the arrow next to them or Double Left Click on the folder name. If you Double Left Click a folder that doesn't have any subfolder, you will automatically switch to the package view.

Packages

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. Double Left Click will extract the selected package and show you all its properties.

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.

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. Since it is the most commonly seen, we've tweaked it a little bit:

  • #FFCB6B Represents an object name
  • #C3E88D Represents an object value as string
  • #DDA0DD Represents a package, you can Left Click it
  • #FFDAB9 Represents a color, you can Mouse Hover it
  • #FFF8DC Represents a link, you can CtrlLeft Click it
  • #F78C6C Represents an object value as a number
  • #61AFEF Represents an object value as a boolean

With a Double Left 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 (AP) is a package that holds audio. Supported types are either SoundWave or AkMediaAssetData, so if you are expecting to see the AP pops up, the package you selected simply doesn't have any of these export types. The AP 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 AP 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.

image

Mesh

A package that triggers the Mesh Viewer (MV) is a package that holds some kind of 3D model. Supported types are either StaticMesh or SkeletalMesh, so if you are expecting to see the MV pops up, the package you selected simply doesn't have any of these export types. The MV is made out of 2 panels.

  1. The first panel displays the list of models you loaded. Models can contain 1 or more sections, each section will have its own material, and each material can be overwritten with a Right Click. You also have the ability to hide or make that section a wireframe with buttons right next to them.
  2. The second panel is the viewport where you can rotate, pan, or zoom around the selected model.

You can save the loaded models as .psk for use in other programs such as Blender or 3DS Max.

image

Material

There is no "Material Viewer" per se. Instead, we use the Model Viewer (MV) to display materials. Everything works the same, the only difference is that the model used will simply be a cube. The only supported type is MaterialInstance, so if you are expecting to see the MV pops up, the package you selected simply doesn't have any of this export type.

When saving a material, you will get a .mat file as well as all its textures as .png.

Animation

There is currently no Animation Viewer and no possibility to preview animations in FModel. Instead, if one of your package's exports type is a AnimSequence, it will automatically be saved as .psa.

Console

A little panel to display warnings, errors, and other information about what FModel does in the background. There is much more information in log files but less is more, so here you go. If needed, you can close this panel but we do not recommend doing so as you won't be able to see, if any, the cause of issues.

Clone this wiki locally