FiveFury
A Python library for research and education around GTA V asset formats.
FiveFury provides typed models and binary readers and writers for studying resource structures, inspecting their relationships, and experimenting with data. It supports GTA V Legacy and Enhanced, with coverage depending on the format and edition.
Installation
python -m pip install fivefury
Requires Python 3.11+. Prebuilt wheels are available for Windows x64. Building the native extension from source requires a C++20 compiler.
Examples
These examples create their own sample data.
Create a small map
from fivefury import Vector3, Ymap
ymap = Ymap(name="example")
ymap.entity(
"prop_tree_pine_01",
position=Vector3(100, 200, 30),
)
ymap.save("example.ymap", auto_extents=True)
Read, inspect and edit it
from fivefury import Vector3, Ymap
ymap = Ymap.from_path("example.ymap")
entity = ymap.entities[0]
print(entity.archetype_name, entity.position)
entity.position = Vector3(110, 200, 30)
ymap.save("edited.ymap", auto_extents=True)
For experiments in memory, use ymap.to_bytes() and Ymap.from_bytes(data). The fivefury.meta module exposes META schemas, data blocks and decoded fields for inspecting the underlying representation.
Scope
| Area | Formats |
|---|---|
| Maps and world data | YMAP, YTYP, YMF, GTXD, gta5_cache_y.dat, heightmap.dat, water.xml |
| Geometry and textures | YDR, YDD, YFT, YTD |
| Collision and navigation | YBN, YND, YNV |
| Animation and scenes | YCD, YED, .cut |
| Audio and text | AWC, REL, GXT2 |
| Archives and metadata | RPF7, DLC metadata, YMT, META, PSO, RBF |
Support includes reading, writing and validation for the modeled structures. Some variants remain partially understood, particularly within YFT, REL, YED and YMT. Console CDR and PS3 RPF support is focused on reading and extraction.
Use GameTarget where an API exposes edition-specific behavior. Validation checks the implemented binary contracts; newly authored assets still need verification in the target game.
Development
0.5.1 is the last planned feature release of the current Python implementation. Core development is moving to .NET.
The source code and tests provide further examples and format-specific contracts. See the changelog for release history.
Released under The Unlicense.
1 maintainer
Metadata
1 maintainer
Release files for fivefury 0.5.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| fivefury-0.5.1.tar.gz | 3.9 MB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| fivefury-0.5.1-cp311-abi3-win_amd64.whl | CPython 3.11 | abi3 | Windows x86-64 | Details |
Total release size: 7.8 MB
Release files / fivefury-0.5.1.tar.gz
| Download URL | fivefury-0.5.1.tar.gz |
|---|---|
| Size | 3.9 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
721ce66a388c1fed2e402dfa474305e59062c515dcb49b90b855cb0df15532ba
|
|
BLAKE2b-256 checksum How to use checksums |
b283a33062a944e154553383e3a32fbd61a5e6ed1337dd87fcb6928061995148
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.11.15
|
Release files / fivefury-0.5.1-cp311-abi3-win_amd64.whl
| Download URL | fivefury-0.5.1-cp311-abi3-win_amd64.whl |
|---|---|
| Size | 3.9 MB |
| Tags | CPython 3.11 Windows x86-64 abi3 |
|
SHA-256 checksum How to use checksums |
529142f9ffa08443e424d0ef32ddc47e56e1b826698736aaff3341a9ba15972c
|
|
BLAKE2b-256 checksum How to use checksums |
b672b645b06a61c46f77965517f0e00d8b0c5789057fea42832a0b9f5312a73b
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.11.15
|
