Skip to main content

Build

Build in the project view produces a resource from the whole project. The project is saved first, a progress bar shows the work, and Open Folder appears when it is done.

Build window

Resource type​

  • FiveM writes a stream folder with an fxmanifest.lua.
  • AltV writes a stream folder with the alt:V resource TOML.
  • Singleplayer writes a dlc.rpf with its content.xml and creature metadata, split into several packs when it would exceed 4 GB.

Game edition​

FiveM builds ask for the game edition:

  • Legacy for GTA V Legacy servers.
  • Enhanced for GTA V Enhanced servers. Models and textures are written in the gen9 format.

The project can mix both formats. Legacy files are converted for an Enhanced build and Enhanced files for a Legacy build, so one project builds for either edition. Converted files are cached in the project folder, which makes the second build of the same edition much faster. When the project contains both formats the drawable list shows LEGACY and ENHANCED badges.

Options​

  • Project name: 3 to 50 characters, lowercase letters, digits and underscores. It names the resource and every meta file.
  • Output folder: defaults to build_output inside the project folder.
  • Build addons as separate resources: one resource per addon instead of one for the whole project.
  • Split into escrow-ready resources: for FiveM, splits the models into resources under a size limit so they fit Keymaster escrow protection, and puts all textures into one unprotected resource. The limit defaults to 900 MB.

What gets written​

  • The shop ped apparel meta for every addon, with the cost, shop, restriction tags and component links from each drawable's Meta file tab.
  • mp_creaturemetadata files for high heels and hair scale.
  • first_person_alternates_<project>.meta and the _1.ydd files for drawables with a first person model.
  • pedalternativevariations_<project>.meta for masks that hide hair.
  • Every texture set to optimize at build time, and every drawable set to repack, is processed on the way out. The source files are not touched.
  • Addons are split automatically when a type reaches the limit set in Settings.

Incremental builds​

Every output file is stored in a build cache inside the project folder, keyed by the source file, its settings and the game edition. On the next build, drawables and textures whose inputs did not change are copied from that cache instead of being converted, optimized or repacked again, so rebuilding a project after a small change takes seconds. The cache is limited to 8 GB and can be cleared together with the other caches in Settings.

Singleplayer packs larger than 4 GB​

A single .rpf archive cannot exceed 4 GB. When a singleplayer build would, it is split automatically: the first folder keeps dlc.rpf with the shop metas, and the extra folders named _part2, _part3 and so on carry more models and textures. A README.txt next to the first pack lists the dlclist.xml lines to add. Every part must be installed, the first one carries the metas the others rely on.

Before building​

The build is blocked while the project name is invalid, no drawables exist, or files are missing. Every case is shown in the window with its reason.