Resource manifests

Each directory directly below client/resources/ is an independent resource. Directories without resource.toml are ignored by GTA asset discovery.

resource.toml

type = "dlc"
main = "stream.toml"

type is dlc or map. main is a safe relative path to the stream manifest and defaults to stream.toml.

stream.toml

files = ["stream"]

[meta]
"stream/vehicles.meta" = "VEHICLE_METADATA_FILE"

Each files entry is a literal file or directory relative to the resource root. Directories are expanded recursively and deterministically. The meta table maps a relative file path to a supported GTA data-file type.

Paths must remain inside the resource directory. Absolute paths, parent traversal (..), invalid components, missing files, duplicate streaming names, and unsupported extensions fail resource mounting.

Keep related models, textures, and metadata in one resource. File names are part of GTA's streaming namespace, so collisions between resources can cause mount failure or unintended overrides.