GitHub
❤️

UE 4.0 - 5.6 .NET 8.0 CUE4Parse LocresCSV
UEExtractor Terminal
UEExtractor.exe "C:\Games\Cronos New Dawn"




C:\Games>

UE 4.0–5.6 Support

Extract text from a wide range of Unreal Engine versions. Auto-detection included, with optional -v override.

DataTable & StringTable

Now fully functional extraction for DataTable & StringTable assets—ideal for games that store dialogue/UI in tables.

LocresCSV Output

Generates locresCSV with key, source, and Translation columns—ready for translators and tools.

Smart CSV Merging

Re-run extraction in the same folder to merge new strings while preserving existing translations during game updates.

AES Key Workflow

Provide AES keys via aes.txt (game folder) or --aes=0x… for encrypted archives.

ZenLoader + .usmap

For modern UE4–UE5 ZenLoader titles, drop a .usmap into the game folder—UEExtractor will find it automatically.

Supported File Formats

Common Unreal Engine archives and assets supported via CUE4Parse

.uassetAsset Files
.umapMap Files
.locresLocalization
.uexpExport Data
.ubulkBulk Data
.utocTOC Index
.pakPackage Archive
.usmapSchema Map

How It Works

01

Prepare

--aes=0x32CHARHEXKEY
02

Extract

Drag & drop the game folder onto UEExtractor.exe, or run in CMD with optional flags.

UEExtractor.exe "C:\MyGame" -v=5.3
03

Translate

Get a <dir_name>.csv. Use the Translation column and optionally import it via UE4localizationsTool.

key,source,Translation

Usage

Drag & drop for speed, CLI for control, and a predictable CSV format

Folder → CSV

Drag the game directory onto UEExtractor.exe to extract and export <dir_name>.csv.

CSV → .locres

Drag a locresCSV onto UEExtractor.exe to convert it back into a .locres file.

Extract LocresCSV from game:

UEExtractor.exe <dir_path> <output_csv>

Create .locres from CSV file:

UEExtractor.exe <csv_path>

LocresCSV Structure

UEExtractor exports a standard CSV structure suitable for importing or converting back to .locres:

keysourceTranslation
4A6FDB1549E45F6C5D8D739129686E2F Default (your translation)
9F2E3C4A1B567890D1234567890ABCDE Start Game (your translation)

Tip: Importing a Translation column from CSV is possible via UE4localizationsTool.

CLI Reference

Searchable argument list

-v=UE5.1or--version=Stalker2
Specify the Unreal Engine version used in the game. Overrides auto-detection.
-a=[key]or--aes=[key]
32-character hex string as AES key. Key must start with 0x.
--skip-uexp
Skip .uexp files during the extraction process.
--skip-uasset
Skip .uasset files during the extraction process.
--locres
Write .locres file after parsing the directory.
--underscore
Do not skip lines with underscores (e.g., ex_string).
--upper-upper
Skip lines that are UPPERCASE (e.g., EXAMPLE).
--table-format
Replace standard separator comma (,) with pipe symbol (|) in CSV.
--headmark
Include header and footer rows in the CSV output.
--autoexit
Automatically exit after all processes complete.
--invalid
Include invalid data in the output CSV.
--qmarks
Forcibly add quotation marks between text strings in CSV.
--hash
Include hash of string for locres (format: [key][hash],[string]).
--picky
Picky mode: displays more detailed information.
--url
Include path to source file (format: [url][key],[string]).
--api
--api:model
--lang:from
--lang:to
--help
Show help information with all available arguments.

Preparation Guide

AES key and USMAP setup by archive type

1

AES Key (if needed)

Some games require AES decryption, some do not. If needed, obtain a 32-character hex key.

Tip: Try extracting without a key first.
2

UE Version (Optional)

You can specify an engine version (e.g. -v=5.1). Auto-detection works, but the argument takes priority.

UEExtractor.exe "MyGame" -v=5.1
Note: UE version values come from CUE4Parse. You can find the right one via FModel.
3

Provide AES Key

Method 1: aes.txt

Place aes.txt in the game directory. One line: 32-char hex string.

📁 MyGame/
📄 aes.txt
📁 Content/

Method 2: CLI

Provide key via command line:

UEExtractor.exe "MyGame" --aes=0x012345...
First complete Pre-ZenLoader steps, then continue below
4

USMAP File Required

ZenLoader games require a .usmap to access resources and archives.

Tip: Check NexusMods and modding forums for USMAP availability.
📁 MyGame/
📄 game.usmap
📄 aes.txt (optional)
📁 Content/
Note: Place the .usmap in the main directory or a subdir—UEExtractor finds it automatically.
Preparation complete — you can now extract localization data.

Smart CSV Merging

When you re-run extraction in the same folder, UEExtractor merges with the previous CSV to keep translations safe while adding new lines.

Source changedOld source becomes Translation
Source matchesTranslation preserved
New keysAdded automatically

Ready to Extract?

Download UEExtractor and start extracting localization text from Unreal Engine games.

.NET 8.0 Runtime Windows 10/11 Open Source