Packages

The Packages view (Ctrl+1) has three panes:

1. Packages: every package of the game folder. Filter by name, and narrow to Content, Maps or Script packages. A dot means the package has edits; edited marks a game file saved in place earlier, copy one with an exported copy, ext a package opened from outside the game folder.
2. Exports: the objects of the selected package as a tree (groups, then objects). Filter by path or by class. The ⓘ button shows the package's summary, imports and name table.
3. The inspector: the selected object.

Arrow keys move through both lists: Up/Down select, Right expands a group or enters it, Left collapses it or goes to its parent, Home/End jump to the ends.

Packages are opened as needed and stay in memory while they have edits. Opening a 65,000-object script package takes under a second.

The inspector

The header shows the object's path, class, size and flags. Its toolbar:

Button	What it does
Export	Writes the asset to a file: PNG/DDS for textures, glTF/FBX/OBJ for meshes, Ogg/WAV for sounds, GFX for movies.
Replace…	Replaces the asset from a file (see below), or its raw serialized data on the Raw payload tab.
Raw	Extracts the object's raw serialized data, for tools that work on bytes.
Rename	Renames the object; references to it follow.
Duplicate	Copies the object next to it as …_copy (Ctrl+D). Sub-objects are not copied.
Copy to…	Copies the object, and optionally its sub-objects, into another package.
Delete…	Turns the object and its sub-objects into empty placeholders and clears references to them.
file	Shows the package file in your file manager.

The tabs:

• Preview: what the object looks like or sounds like (below).
• Properties: every property, editable in place. References are links (Ctrl+click opens a new tab). Arrays have add, duplicate and remove buttons; top-level properties have a reset to the default.
• Native: what the engine stores outside the properties (the native payload type and size).
• References: what this object uses and what uses it.
• Dump: the object as text, for reading or copying.
• Source: on classes, functions, states, structs and enums, the decompiled UnrealScript (see Scripts below).

Textures

The preview shows any mip, zoomed to fit or at actual size, over a checkerboard or a plain background. Replace… takes a PNG or DDS. A PNG is re-encoded to the texture's pixel format (or the one you pick); a DDS in a supported format is stored as is. The mip chain is kept like the original, generated in full, or reduced to the top level. The new image is stored inside the package, so the texture cache files (.tfc) never need editing.

Materials

Materials and material instances preview on a lit sphere, cube or plane with their base colour, normal and emissive maps. The side panel lists the parent chain, every texture (click to open it) and the parameters: scalars and vectors are editable. Editing an instance adds an override to it; editing a material changes its default.

Meshes

Static and skeletal meshes open in a 3D viewer: orbit with the mouse, switch LODs, toggle textures, wireframe, the skeleton and the grid, change the background, and Fit to frame the model.

• Export writes glTF (.glb, metres), FBX (centimetres, textures embedded, skeleton and skin) or OBJ. Exported skeletons point their bones along the limbs, so they look right in Blender.
• Replace… takes glTF, GLB, FBX or OBJ for static and skeletal meshes. Keep the skeleton of the original for skeletal meshes.

Sounds

Sound waves have a player and an Edit button. The editor shows the waveform: drag to select, then trim, fade in or out, change the gain, normalise, switch mono/stereo and pick the Vorbis quality. Play the result, then Apply and replace. Replace… takes Ogg (stored as is), WAV and Wwise .wem files.

Wwise audio

Most of the game's voice lines and effects are Wwise media in .pck files next to the packages. Selecting an AkEvent or AkBank object shows what it plays: each media file can be played, exported (Ogg, WAV, wem), replaced (Ogg, WAV, wem) and edited with the same editor.

The Wwise audio button in the activity bar browses every .pck of the game folder; selecting an event filters the media it plays. Replaced .pck files are written right away, in place or into a folder of your choice (the Write replaced packages switch).

Particles

Particle systems, emitters and modules preview the whole effect, simulated live: sprites with their material and sub-UV sheets, mesh particles, spawn rates and bursts, lifetime, size, colour, velocity, acceleration, rotation and orbit. Beams, ribbons, collision and events are listed as not simulated.

The game stores each module's curves as baked lookup tables. Select a module to edit them in the curve editor: drag the points, resample, scale the time, or type the values. The preview follows as you edit; Apply writes the table into the module.

UI movies

Scaleform movies (SwfMovie, the game's menus and HUD) have six tabs:

• Player plays the movie, with its shared libraries, fonts and images taken from the game folder.
• Texts: the initial text of every text field, editable.
• Scripts: the ActionScript; the strings it uses are editable, the bytecode is shown as a listing.
• Images: the textures the movie uses, linked to them; references can be renamed.
• Linkage: what the movie exports and imports.
• Tags: every tag of the file.

Apply writes the movie back. To change an image, replace the texture it points to, not the movie.

Scripts

Script packages (ChaosGame.upk, TgGame.upk and the like) hold the game's compiled UnrealScript. On a class or anything inside one, the Source tab shows the decompiled class. Edit it and click Compile: the whole package is rebuilt from source with your class swapped in, the result replaces the package in memory, and it is saved or built into a mod like any other edit. Compiling needs the package to have no other pending edits, so save or discard property edits first.

Export the class sources of this script package… (Tools) writes every class as a .uc file.

INFO

The game checks the hash of its script packages. The launcher writes the hash of every script package a mod replaces into the game when it starts it, so recompiled packages load. This works on Windows; on Wine the launcher prints a notice.

Searching and bulk edits

• Search every package (Ctrl+F): finds objects by path in every package of the folder, optionally of one class. The first search indexes the folder (a few seconds), later ones are instant.
• Find and replace (Ctrl+H): finds text in every string, name, enum value and reference of the open package, optionally in object names too, shows a preview table, then replaces all.
• Batch import (Tools): imports a folder of files named <package>.<object>.<ext>, for example BODY_TYPE_UI_SF.skinicon_kasumi.collection_kasumi_default.png. Each file is matched to its object and imported by type. When the files touch several packages you choose which ones to write.

Other tools

• Verify this package: reads and rewrites every object and reports anything that does not come back identical. Useful before trusting an edit to a rare object type.
• Rewrite this package compressed / uncompressed: writes the package with or without the game's compression.
• Prepare a mod folder from packages: the older way to make a mod folder from saved packages. The mod cooker replaces it for most uses.