RageKit

What is a GTA V meta file and how do you edit one?

A .meta file is a GTA V data file written as XML. handling.meta sets how a vehicle drives, vehicles.meta defines vehicles, carcols.meta and carvariations.meta set mod kits and colours, weapons.meta defines weapons and peds.meta defines peds. RageKit opens any .meta in a text editor, and its studios edit the common ones with forms and a live preview instead of raw XML.

.meta · meta data file · Reviewed

No installer is published yet.
Vehicle Studio
Vehicle Studio with a car in the 3D preview and the handling editor open

What's inside a .meta file

  • XML: one entry per vehicle, weapon, ped or other item, with named fields.
  • Names that link files together, such as the handlingName shared by vehicles.meta and handling.meta.
  • On FiveM, each meta is registered with a data_file line in the resource's fxmanifest.lua.

How to open a .meta file

  1. Open where the file is

    In the RPF Explorer choose Open GTA V to browse the game's archives, Open RPF… (Ctrl+O) for a single archive, or Open folder… for loose files such as a FiveM resource. Dropping an .rpf or a folder onto the window opens it too.

  2. Select the .meta

    It opens in a text editor with find and replace.

  3. Or open it in a studio

    Vehicle Studio edits handling.meta, vehicles.meta, carcols.meta and carvariations.meta; Weapon Studio edits weapons.meta; Ped Studio edits peds.meta.

  4. Save

    Game files are read-only. To change one, choose Copy to mods first: the archive is copied into the mods/ folder and the original stays as it was.

What RageKit does with .meta files

  • Edit any .meta or .xml as text, with find and replace
  • Edit vehicle metas with forms and the car in a 3D preview in Vehicle Studio (Premium)
  • Edit weapon and ped metas in their studios (Premium)
  • Search inside META files across an archive
  • Build a FiveM resource with the data_file lines written for you (Premium)

Tools that read and write .meta

RageKit tools that handle .meta files
ToolRageKitNotes
Vehicle StudioReads and writesHandling, with raw XML for SubHandlingData
Weapon StudioReads and writesWeapon info and ammo
Ped StudioReads and writesRegistered as PED_METADATA_FILE
RPF ExplorerReads and writesText editor with find and replace
Find Usages and hash lookupReadsVehicle, ped, weapon and mod kit references
Tattoo & Overlay StudioWritesOnly when tattoos are sold

Questions

What program opens .meta files?

They're XML, so any text editor reads them. RageKit's RPF Explorer opens them inside game archives, and Vehicle Studio edits the vehicle metas without hand-writing XML.

Where is handling.meta in GTA V?

The base game's is in update.rpf under common/data, and each DLC pack has its own under its common/data folder. Opening a vehicle in Vehicle Studio finds the right entry for you.

Why isn't my edited meta loading on FiveM?

The resource's fxmanifest.lua needs a data_file line for it, such as data_file 'HANDLING_FILE' 'data/handling.meta', and the file listed under files.

What's the difference between .meta and .ymt?

A .meta is XML text. A .ymt holds the same kind of data in a binary form.

Guides

Open .meta files with RageKit

Free download for Windows 10 and 11. No account needed for the free tools.

There's no Windows installer on the latest release yet. Check the changelog for when it lands.