Asset troubleshooting

Resource is ignored

Confirm the directory is directly below client/resources/ and contains resource.toml. Check main points to an existing stream manifest.

Unsafe path error

All manifest paths are resource-relative. Remove absolute prefixes, drive letters, .., and paths that escape the resource directory.

Unsupported extension or type

Check supported files. Use map for YMAP/YTYP/collision content and dlc for add-on vehicle/model content. Extract RPF archives.

Duplicate streaming name

Two files resolve to the same GTA streaming name. Rename or remove one and update any metadata references. Also check collisions across resources.

Package changed while mounted

Exit GTA completely and reconnect. Restarting only the game server or returning to a menu does not unload all mounted GTA data.

Asset mounts but is invisible

Inspect client logs, then verify model names, YTYP archetypes, YMAP placement, LOD relationships, textures, collision, and dimension. Successful VIMP validation proves package structure, not the internal correctness of every GTA asset reference.

Client download fails

Verify that the server process can read every client file, the manifest has no duplicate paths, and the connecting client has enough disk space. Retry with a clean test cache only after preserving logs from the failed attempt.