ZIP bundles

When to use a ZIP

GLB to FiveM accepts a ZIP when a model needs other files next to it. The common cases:

• An OBJ with its MTL file and texture images.
• A glTF with its separate .bin and images.
• An FBX whose textures were exported as separate image files.

A GLB never needs a ZIP. Upload it as it is.

Which model gets converted

GLB to FiveM converts one model per ZIP. If there are several model files inside, it picks the first in this order and ignores the rest:

.glb, .gltf, .fbx, .usd/.usdc/.usda/.usdz, .dae, .obj, .stl, .ply

So a ZIP with a whole asset pack gives you one prop, not the pack. Upload each model on its own. Folders inside the ZIP are fine, and hidden files such as the __MACOSX folder of a Mac are skipped.

Limits

• ZIP file size

  Value:100 MB
  Message when crossed:Refused before the upload starts.

• Files inside

  Value:256
  Message when crossed:Archive has 384 members, exceeds cap of 256

• Unpacked size

  Value:200 MB
  Message when crossed:Archive expands to 260548011 bytes, exceeds cap of 209715200

The numbers in the messages are those of the refused ZIP.

What is refused

• Another archive (.zip, .rar, .7z and similar)

  Message:Nested archives are not allowed: 'source/model.zip'
  Fix:Unpack the inner archive and ZIP the model files directly.

• A Blender file or a program (.blend, .py, .exe, .bat and similar)

  Message:Blocked file type in archive: 'model.blend'
  Fix:Remove it. Export the model from Blender instead.

• No model in a supported format

  Message:No recognized 3D file found in archive
  Fix:Add the model file, for example the GLB or OBJ.

• A damaged or renamed file

  Message:Corrupt ZIP archive: File is not a zip file
  Fix:Create the ZIP again. A .rar renamed to .zip is not a ZIP.

The job page names the file the check stopped at:

1

1. 11. Nested archives are not allowed: the reason, in plain text