3D models
Purpose
This page is the library of 3D models your game will use. You upload a model; the server converts it to the glb format the game can read and validates it. You publish the ready model and bind it to an item or a character; the game sees the change without redeploying the game.
When to use
- To add a new vehicle, weapon or character model to the game.
- To check the status of a model whose conversion is in progress or has failed.
- To inspect a model’s published version, the definitions that use it or its version history (click the row; see Model profile).
Step by step
Upload a model
- Press Model yükle (Upload model). Only admins with model write permission see the button.
- Choose the Yükleme türü (Upload type): single file or zip package.
- Choose the file. The file cannot exceed 50 MiB.
- If you wish, write a name. For obj, stl, 3mf, dxf files and zip packages, Birim (Unit) and Yukarı eksen (Up axis) also appear; defaults are filled in by file format, check the values.
- Press Yükle (Upload). A progress bar shows during upload; you can stop it with Yüklemeyi iptal et (Cancel upload).
- The model passes through the Sırada (Queued) and Dönüştürülüyor (Converting) states in the list and becomes Hazır (Ready). The list refreshes by itself in the meantime.
Publish a model
A ready model does not go to the game immediately. Open the model row and Yayınla (Publish) the version from the Sürümler (Versions) table on the Model profile.
Note
Formats that carry no animation (obj, stl, 3mf, dxf) appear in the list with the note “Bu biçim animasyon taşımaz” (This format carries no animation). Clips cannot be added to these models.
Fields and options
Upload form
| Field | Required | Description |
|---|---|---|
| Upload type | Yes | Single file or zip package |
| File | Yes | At most 50 MiB |
| Name | No | If empty, the file name is used, at most 200 characters |
| Main file | No | Only in zip mode; the path inside the zip if there is more than one model file |
| Unit | Depends on format | Micron, millimeter, centimeter, inch, foot, meter |
| Up axis | Depends on format | Y up or Z up |
List columns
The Name, Format, Last version (with status), Published, Versions and Added columns are shown by default. You can turn on the Last version number and Lifecycle columns from the table’s column menu. Lifecycle: Active, Archived.
Common situations
| Situation | What to do |
|---|---|
| The model is in the “Başarısız” (Failed) state | Open the model’s row; under the version the reason is written as a plain sentence (for example a reference to an external file or a 2D dxf). Fix the file and upload again. |
| I uploaded a zip and it does not know which file is the main file | Write the model file’s path inside the zip in the Ana dosya (Main file) field. |
| The model looks too big or too small | You chose the wrong unit during upload; upload the model again. |
| The Upload model button is missing | Your account’s role has no model write permission. |
| Conversion never starts, “glb only” warning | The converter runs only on amd64 servers; in this environment you can upload only glb. |
| The library list is empty | Check the selected game and environment; if the Scenes module is off, the model library cannot be used in this environment. |