> For the complete documentation index, see [llms.txt](https://fiveos.gitbook.io/fiveos-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://fiveos.gitbook.io/fiveos-docs/guides/3d_model.md).

# 3D Model → FiveM

Have a 3D model (`.glb`, `.fbx`, `.obj`, and more)? Drop it here and FiveOS turns it into a prop you can place in your server — or a weapon a player can hold.

![The 3D Model tab (Props)](https://1633569348-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnD6KsLHmOXfppEdw7gXN%2Fuploads%2Fgit-blob-8b870927e7c3878cc9e900bbde35803c2e98b515%2Fguide-3dmodel.png?alt=media)

## How to use it

1. Drag your model onto the preview area.
2. Move, rotate, or scale it with the handles. Press **W** to move, **E** to rotate, **R** to scale.
3. Check the size numbers. If they turn red, your model is too heavy — see the Optimize tab to shrink it.
4. Type a name at the bottom (or leave it to fill in from the file name).
5. Click **Convert**.

Your finished files go to your Documents folder, under **FiveOS\Output**. Drop them into your server's `resources`.

## Making a weapon instead

Flip the top switch from **3D Model** to **Weapons**. Pick the weapon type (pistol, rifle, and so on), give it a name, and click Convert. FiveOS adds the extra files a weapon needs so players can pull it out right away.

## Tips

* A person-shaped figure stands next to your model so you can check it's the right size.
* Use the **Match** button to snap your prop to a normal height.
* Toggle **Wireframe** at the bottom-right to see the shape without colors.

## If it doesn't work

* **Model is tiny or huge:** it was saved in the wrong units — re-export it from your 3D program in metres.
* **No texture showing:** use **Add Textures** from the File menu and add the picture files.
* **Convert button greyed out:** you haven't loaded a model yet — drag one in first.