Skip to content

Maps and MLOs

Use type = "map" for YMAP worlds and MLO interiors.

toml
type = "map"
main = "stream.toml"
toml
files = ["stream"]

[meta]
"timecycle.xml" = "TIMECYCLEMOD_FILE"

Place loose files below the directory referenced by files. Map resources may contain ymap, ytyp, ybn, ynv, yft, ytd, ydr, ycd, ydd, gfx, and _manifest.ymf content.

VIMP automatically registers streamed YTYP files as map type data and inspects map manifests for required archetype dependencies. Keep the original _manifest.ymf beside the resource's map content when the package supplies one.

Use [meta] for supported extra data such as a timecycle modifier:

toml
[meta]
"timecycle.xml" = "TIMECYCLEMOD_FILE"

Do not label a map as dlc: YMAP, YTYP, and collision extensions are rejected for that resource kind. Convert RPF archives to loose files before packaging.

Test collision, portals, timecycles, exterior LODs, and entry points after a clean GTA restart. A package can mount successfully while still containing asset-level references that are invalid inside GTA.

VIMP developer documentation