udk-manip/README.md
2026-01-20 16:14:46 -05:00

58 lines
1.6 KiB
Markdown

# udk-manip
A command-line tool for manipulating UDK/UE3 coalesced config and localization files.
Tested with Army of Two: The 40th Day (Xbox 360).
## Features
- Extract all files from coalesced archives
- Repack directories back into coalesced format
- List contents of an archive with file sizes
- Extract individual files by index or name
- Drag & drop support for quick extraction/packing
- Auto-detect language extension when repacking (int, jpn, deu, fra, ita, etc.)
## Supported Formats
- `coalesced.ini` - Config files
- `coalesced.int` - English localization
- `coalesced.jpn` - Japanese localization
- `coalesced.deu` - German localization
- `coalesced.fra` - French localization
- `coalesced.ita` - Italian localization
- `coalesced.esn` - Spanish localization
- And other UE3 localization formats
## Usage
```
udk-manip list <file> - List archive contents
udk-manip unpack <file> [output_dir] - Extract all files
udk-manip pack <input_dir> <output_file> - Create coalesced file
udk-manip info <file> - Show archive info
udk-manip extract <file> <index> [output] - Extract single file
```
### Drag & Drop
- Drag a coalesced file onto the exe to extract to `./<name>_<ext>/`
- Example: `coalesced.ini` extracts to `coalesced_ini/`
- Drag a folder onto the exe to pack into `./<name>.<ext>`
- Example: `coalesced_ini/` packs to `coalesced.ini`
## Building
Requires Qt 6 and a C++17 compiler.
```bash
qmake udk-manip.pro
make
```
## Notes
- Preserves original file format for game compatibility
- Maintains directory structure when extracting
- Big-endian binary format (Xbox 360 / PS3)