RageKit

GTA V modding glossary: file formats and terms

GTA V stores its files in RPF archives. Models are .ydr, .ydd and .yft files, textures are .ytd, collision is .ybn, and the map is .ymap placements of .ytyp archetypes. This glossary defines each format and the terms FiveM and singleplayer modders use, with a link to the tool that opens it.

Archives and packs

RPF.rpf, RPF7

The archive format GTA V stores its files in (version 7, RPF7). An RPF holds folders and files, including other RPFs, and can be unencrypted (OPEN) or encrypted (AES or NG).

OPEN, AES and NG encryption

The three RPF encryption modes. OPEN is unencrypted and is used for FiveM and mods; NG is what the unmodified game expects for its archives and DLC packs; AES is a third mode some archives use. An OPEN dlc.rpf loads only with OpenIV's ASI loader.

Mods foldermods/

A mods folder inside the GTA V folder that holds edited copies of the game's archives, so the originals stay untouched. The game reads it only when a mods-folder loader is installed.

DLC packdlcpack, dlc.rpf

An addon content pack in update/x64/dlcpacks/<name>/dlc.rpf, with setup2.xml and content.xml describing what it adds. The game loads the packs listed in dlclist.xml.

dlclist.xml

The list of DLC packs the game loads, in order, inside update.rpf. Adding a pack to it turns the pack on.

setup2.xml and content.xml

The two files at the root of a dlc.rpf: setup2.xml names the pack and its content file; content.xml lists the data files and which changesets load them.

OIV.oiv package

An installable mod package format introduced by OpenIV: a zip with an assembly.xml that lists the files to add, replace or edit. RageKit installs OIV format 2.0 to 2.2 and builds .oiv packages.

Models and textures

YDR.ydr, drawable

A drawable: one model with its shaders, LODs and optionally embedded textures. Props and most static objects are .ydr files.

YDD.ydd, drawable dictionary

A drawable dictionary: several drawables in one file. Ped clothing, heads and hair are .ydd files.

YFT.yft, fragment

A fragment: a model with physics. Vehicles are .yft files (with an HD _hi.yft), as are breakable and physical objects.

YTD.ytd, texture dictionary

A texture dictionary: a set of textures with their compression format and mipmaps, used by models' shaders. Vehicles have an HD +hi.ytd too.

YBN.ybn, bounds

Static collision (bounds): the shapes players and vehicles collide with. Collision can also be embedded in a model.

LOD and SLOD

Level of detail. Lower-detail versions of a model (LOD, then SLOD1 to SLOD4) are drawn at a distance so the map stays fast.

Shader

How a material is drawn: which textures it uses (diffuse, normal, specular) and effects such as emissive, decal, cutout or glass.

BC1, BC3, BC5, BC7 (DXT)

Block texture compression formats. BC1 (DXT1) suits textures without alpha, BC3 (DXT5) textures with alpha, BC5 normal maps, and BC7 higher-quality colour.

Mipmaps

Smaller copies of a texture stored with it and used at a distance. Textures without mips shimmer and cost more memory bandwidth.

Livery

A vehicle paint design, stored as a texture in the vehicle's .ytd (often named <model>_sign_N) or as a livery part in its mod kit.

Maps and world

YMAP.ymap, map data

Map placement data: entities of archetypes placed in the world with position, rotation, scale, LOD distance and flags, plus car generators and other map data.

YTYP.ytyp, archetype definitions

Archetype definitions: what an object is (its drawable, texture dictionary, bounds and flags). Interiors (MLOs) are defined here too.

Archetype

The definition of a placeable object, named by a hash. A ymap places entities that point to archetypes.

Entity

One placement of an archetype in a ymap, with its own position, rotation, scale and LOD settings.

MLOinterior

An interior archetype made of rooms connected by portals, with entity sets and time-cycle settings per room.

YND.ynd, path nodes

Path node files (nodesN.ynd) that define the roads and walkways vehicles and peds follow, with links, speeds and flags.

YNV.ynv, navmesh

Navigation meshes peds use to find their way around the world.

Scenario

A point or chain where peds or vehicles perform an activity (sitting, smoking, parking), stored in scenario .ymt files.

Car generator

A spot in a ymap where a parked vehicle can spawn.

Timecycle

The weather and lighting settings per time of day: sky, sun, fog, lights and colour grading. Modifiers change them locally or from a script.

Data files

META.meta

XML data files the game reads, such as handling.meta and vehicles.meta.

YMT.ymt

Binary metadata (PSO or RBF). Clothing variation info, scenarios and some vehicle data use it. It can be read as XML and converted back.

handling.meta

Vehicle handling: mass, drive force, top speed, gears, brakes, steering, traction and suspension, one entry per handlingName.

vehicles.meta

Vehicle definitions: model name, texture dictionary, handling name, class, flags and more.

carcols.metacarcols.ymt

Mod kits, siren settings and light settings for vehicles.

carvariations.meta

Each vehicle's colour combinations, mod kits, lights and sirens ids.

weapons.meta

Weapon definitions: damage, fire rate, range, clip size, ammo and the rest.

peds.meta

Ped definitions. Addon peds need an entry here.

GXT2.gxt2

Text tables: the labels and strings shown in game, keyed by hash.

Joaat hashjenkins one-at-a-time

The 32-bit hash GTA V uses for names (models, archetypes, labels), computed on the lowercased name. Shown as hex, unsigned or signed decimal.

YPT.ypt, particle dictionary

A particle effects dictionary: effect, emitter and particle rules with their textures and models.

Audio

AWC.awc

An audio wave container: sound data as wave banks or streams.

dat54.rel and dat151.rel

Audio config files. dat54 describes sounds (sound data); dat151 holds game audio data such as a car's audio settings.

FiveM

FiveM resource

A folder a FiveM server loads, with an fxmanifest.lua, streamed assets in stream/ and data files. Started with ensure <name> in server.cfg.

fxmanifest.lua

A resource's manifest: its files, scripts, dependencies and data_file lines.

data_file

A manifest line that registers a data file with the game, such as data_file 'HANDLING_FILE' 'data/handling.meta'.

stream folder

The stream/ folder of a resource. Files in it (models, textures, ymaps) are streamed to players under their file names, so two resources streaming the same name conflict.

EUP

Short for Emergency Uniforms Pack. In FiveM the name is widely used for addon clothing packs for the freemode peds.

Freemode pedmp_m_freemode_01, mp_f_freemode_01

The male and female multiplayer characters. Their clothing is made of component drawables and props, and addon clothing targets them.

txAdmin

The web panel commonly used to run FiveM servers. RageKit can reload resources through it when deploying.

General

GTA V Legacy and Enhanced

The two PC editions of GTA V. RageKit is tested on Legacy; it opens and exports Enhanced files but writes files for Legacy only.

Addon and replacement

An addon adds something new under its own name; a replacement overwrites a stock asset, which then disappears.