$ show DurtyFree/gta-v-data-dumps
This repository is a comprehensive data dump of Grand Theft Auto V (GTA V) game assets, structured as a reference library for modding, scripting, and reverse engineering. It contains no executable application logic; instead, it provides thousands of JSON, INI, and TXT files detailing internal game constants, entity flags, vehicle definitions, pedestrian data, weapon configurations, and precise spatial coordinates for world objects. The data is extracted from the RAGE engine binaries and enhanced with community research, specifically targeting version v3717.0 (Online 1.72). It serves as a critical resource for FiveM server administrators, mod developers, and game analysts who need to understand the game's internal data structures without access to the source code. The repository is organized into logical categories: core entity lists (vehicles, peds, weapons), world object placement data (objectslocations/), audio event mappings, and rendering/animation flags. While the data itself is static and version-locked, the structure is highly consistent, using standard JSON schemas for spatial data (Position/Rotation) and flat arrays for enumerations. The primary value lies in the 'Data Truth Layer'—the ground truth of internal game names and hashes that are otherwise undocumented. However, the data is inherently volatile; any official game patch that alters internal hashes or map geometry will invalidate specific entries, requiring regeneration of the dumps. For AI agents and engineers, this repository is a high-fidelity knowledge base for GTA V modding. It is not a tool to be run, but a dataset to be consumed. The quality is exceptional for a community-maintained data dump, with consistent naming conventions and comprehensive coverage of game systems. The lack of code means there is no technical debt in terms of software engineering, but there is significant drift risk regarding game version compatibility.
The LLM identified 4 files worth highlighting for reuse:
Contains precise 3D coordinates (X, Y, Z) and rotation data for thousands of traffic light props. This demonstrates a reusable pattern for static world object placement in open-world games. The consistent schema (Name, Position, Rotation) allows for generic parsers to load environmental assets without hardcoding logic. Highly reusable for server scripts that need to detect or manipulate world props.
Maps human-readable vehicle names (e.g., 'adder') to internal game hash integers (e.g., '3078201489'). This is a critical pattern for modding tools that need to reference game assets by their internal identifiers rather than display names. The INI format provides a simple, efficient lookup table that is easily parseable by any language.
Defines the behavior and rendering flags for game entities (e.g., FLAG_IS_FIXED, FLAG_DONT_CAST_SHADOWS). This serves as a documentation of the game's internal logic system. It is reusable for understanding how entities interact, how AI behaves, and how rendering is controlled. The inclusion of community credits and _UNK_ markers indicates an ongoing reverse engineering effort.
Technical guide for deserializing the binary navigation mesh data (MessagePack/Lz4). This is a reusable pattern for handling complex binary game assets that cannot be easily represented in JSON. It provides C# class models and serialization options, serving as a template for developers needing to parse proprietary binary formats.