> 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)](/files/ZoGgoTRu5fvEqcCwQtiU)

## 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.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://fiveos.gitbook.io/fiveos-docs/guides/3d_model.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.