FourFury
FourFury is a Python library for reading, inspecting, extracting, and editing Grand Theft Auto IV data files. It provides typed APIs for the game's archives, world placements, collision resources, drawables, textures, navigation graphs, animation dictionaries, and related metadata.
[!IMPORTANT] FourFury is under active development. Read support is broader than write support, and some resource types intentionally permit only fixed-size edits.
Format support
| Format | Read | Write | Notes |
|---|---|---|---|
| RPF2 | Yes | Yes | Search, extraction, creation, and unencrypted output |
| RPF3 | Yes | No | Audio archives with hash-only member identities |
| RAGE AUD | Yes | No | Extensionless banks and streams, typed codecs, metadata, PCM/IMA decoding, WAV export, and raw Vorbis access |
| IMG3 | Yes | Yes | Search, extraction, creation, and resource padding handling |
| CUT | Yes | Lossless text | Cutscene clocks, scene and asset resolution, flags, models, effects, variations, attachments, and preserved IMG padding |
| carcols.dat | Yes | Lossless source | Vehicle colors, scanner descriptors, and 3/4-channel model combinations |
| GXT | Yes | Yes | GTA IV text databases, named and flat layouts, hash lookup, 8/16-bit text, and cache integration |
| IDE | Yes | Yes | Lossless definitions with typed archetypes, MLO topology, and model-bound 2DFX lights |
| IPL | Yes | Yes | Lossless sectioned text with typed GTA IV OCCL boxes |
| gta.dat | Yes | Yes | Lossless level manifests, typed directives, device paths, and multi-path entries |
| images.txt | Yes | Yes | Ordered archive lists with explicit placement-sidecar modes |
| water.dat | Yes | Yes | Lossless water triangles and quads, runtime flags, geometry queries, and neutral mesh export |
| WPL | Yes | Yes | Placements, MLO and IDE-light resolution, explicit LOD hierarchies, world portals, and instance flags |
| GTXD | Yes | Yes | Texture-parent chains and cycle detection |
| NOD | Yes | Yes | Navigation nodes, links, costs, and topology validation |
| WNV | Yes | Limited | Navigation meshes, portals, edges, cover points, and quadtrees |
| WBN | Yes | Limited | Collision bounds and fixed-size edits |
| WBD | Yes | Limited | Collision dictionaries and fixed-size edits |
| TUNE | Yes | Lossless text | Fragment physics source configuration |
| WAD | Yes | No | Animation dictionaries, tracks, chunks, and decoded channels |
| WBS | Yes | No | Facial blend shapes, sparse vertex deltas, and same-container WDD/WDR bindings |
| WDD | Yes | No | Hash-addressed drawable dictionaries and neutral model projection |
| WDR | Yes | No | Drawables plus neutral model projection |
| WFT | Yes | No | Fragment drawables, physics hierarchy, embedded lights, collision bounds, neutral projection, and IDE light binding |
| WTD | Yes | No | Texture dictionaries and DDS export |
See DOCUMENTATION.md for examples, field behavior, writer constraints, and current limitations.
Installation
FourFury requires Python 3.11 or newer. Install the latest release from PyPI:
python -m pip install fourfury
For an editable installation:
git clone https://github.com/Hancapo/fourfury.git
cd fourfury
python -m pip install -e .
Quick start
Open an archive and read one of its entries:
from pathlib import Path
from fourfury import RpfArchive
game = Path(r"D:\Program Files (x86)\Steam\steamapps\common\Grand Theft Auto IV\GTAIV")
with RpfArchive.from_path(game / "pc/data/game.rpf") as archive:
entry = archive.find_entry("data/taskparams.txt")
if entry is not None:
print(entry.read().decode("utf-8"))
Index an entire installation when assets may live in different archives:
from fourfury import GameFileCache, GameFileType
with GameFileCache(game) as cache:
cache.scan()
asset = cache.require_asset("bm_nylamp1", kind=GameFileType.WFT)
fragment = cache.load(asset)
Episode installations can be scanned as effective base-game overlays:
from fourfury import GameEpisode
with GameFileCache.for_episode(game, GameEpisode.THE_LOST_AND_DAMNED) as cache:
cache.scan()
city = cache.map_structure
print(city.summary())
print(city.delta.changed_paths)
Documentation
The complete documentation covers every supported format, resource APIs, neutral WDR models, editing constraints, and known limitations.
Release notes live in CHANGELOG.md.
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file fourfury-0.9.1.tar.gz.
File metadata
- Download URL: fourfury-0.9.1.tar.gz
- Upload date:
- Size: 334.6 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/7.0.0 CPython/3.11.15
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
2fc94df96fd5252f7a1454bc8b4b7ebdf032a0c612754c11e54b0071b925ccdc
|
|
| MD5 |
7331ce5103466350223b1da1eb8d5e49
|
|
| BLAKE2b-256 |
60aaa939f0e53f7951bb1e5968b5723c2f051149a5ea8f9e27b55b5d950e8840
|
File details
Details for the file fourfury-0.9.1-cp311-abi3-win_amd64.whl.
File metadata
- Download URL: fourfury-0.9.1-cp311-abi3-win_amd64.whl
- Upload date:
- Size: 313.8 kB
- Tags: CPython 3.11+, Windows x86-64
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/7.0.0 CPython/3.11.15
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
eb1e7e9c3b9ab851298d6f1334e9a64794935429efa8c5a13d2f36377c64f26e
|
|
| MD5 |
119d49e5f408b9c33957eafe50200f3c
|
|
| BLAKE2b-256 |
ff04163758d08d25ce1350995450bbfcec7cd0f4790edaf53f8db57e1816a6df
|
