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; hash-only names remain hexadecimal
IMG3	Yes	Yes	Search, extraction, creation, and resource padding handling
IDE	Yes	Yes	Lossless definitions with explicit MLO entities, rooms, portals, and validation
IPL	Yes	Yes	Lossless sectioned text with typed GTA IV OCCL boxes
water.dat	Yes	Yes	Lossless water triangles and quads, runtime flags, geometry queries, and neutral mesh export
WPL	Yes	Yes	Placements, MLO 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, edges, cover points, and quadtrees
WBN	Yes	Limited	Collision bounds and fixed-size edits
WBD	Yes	Limited	Collision dictionaries and fixed-size edits
WAD	Yes	No	Animation dictionaries, tracks, chunks, and decoded channels
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, collision bounds, and complete neutral fragment projection
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"))

Documentation

The complete documentation covers every supported format, resource APIs, neutral WDR models, editing constraints, and known limitations.

Release notes live in CHANGELOG.md.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

fourfury-0.2.2.tar.gz (166.2 kB view details)

Uploaded Jul 25, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

fourfury-0.2.2-cp311-abi3-win_amd64.whl (156.8 kB view details)

Uploaded Jul 25, 2026 CPython 3.11+Windows x86-64

File details

Details for the file fourfury-0.2.2.tar.gz.

File metadata

Download URL: fourfury-0.2.2.tar.gz
Upload date: Jul 25, 2026
Size: 166.2 kB
Tags: Source
Uploaded using Trusted Publishing? No
Uploaded via: twine/6.2.0 CPython/3.14.6

File hashes

Hashes for fourfury-0.2.2.tar.gz
Algorithm	Hash digest
SHA256	`b134b5e1ba236b8dfb7aed214de114f855038c368e51dbc052f40a648433a818`
MD5	`0ad79627fa44bddc620346a7d96511c0`
BLAKE2b-256	`d5cabba4d1bc7413d73aed99a0d792fa9fb1ac9af869c4437139d787755a2dd2`

See more details on using hashes here.

File details

Details for the file fourfury-0.2.2-cp311-abi3-win_amd64.whl.

File metadata

Download URL: fourfury-0.2.2-cp311-abi3-win_amd64.whl
Upload date: Jul 25, 2026
Size: 156.8 kB
Tags: CPython 3.11+, Windows x86-64
Uploaded using Trusted Publishing? No
Uploaded via: twine/6.2.0 CPython/3.14.6

File hashes

Hashes for fourfury-0.2.2-cp311-abi3-win_amd64.whl
Algorithm	Hash digest
SHA256	`86d60ef83704703dbc8f8af2f507384d89501f8446d235ca688e07a45f1709d2`
MD5	`6b408b8a357b3cdaa90cd3e726600be1`
BLAKE2b-256	`3423ca4e911ef9531dd98db57419593fc8517fb35849b9cbf3fe49346172c3c9`