> For the complete documentation index, see [llms.txt](https://atiysus-organization.gitbook.io/aty-scripts/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://atiysus-organization.gitbook.io/aty-scripts/map-editor/getting-started/installation.md).

# Installation

## Installation

Follow these steps in order. A missing dependency or a missing convar is the most common cause of a broken install.

**1. Extract**

Place the resource in your server's resources folder:

```
resources/[aty]/aty_mapeditor
```

Keep the folder name **`aty_mapeditor`** exactly — exports and NUI paths depend on it.

**2. Install dependencies**

These must start **before** `aty_mapeditor`:

* `aty_lib`
* `ox_lib`

**3. Add the required convar**

```cfg
# Dynamically created doors will not open or sync without this
setr game_enableDynamicDoorCreation "true"
```

{% hint style="danger" %}
This convar is not optional if you intend to place doors. Without it, gates and interior doors placed through the editor refuse to open, fail to synchronise between players, or break outright.
{% endhint %}

**4. Start order**

```cfg
ensure ox_lib
ensure aty_lib
ensure aty_mapeditor
```

**5. Grant yourself access**

```cfg
add_ace group.admin aty_mapeditor.admin allow
```

Or grant one player directly:

```cfg
add_ace identifier.license:YOUR_LICENSE_HERE aty_mapeditor.admin allow
```

See Permissions for framework-native options and for the diagnostic the server prints when access is denied.

**6. Open the editor**

In game:

```
/opencreator
```

The freecam takes over and the editor panel appears at the bottom of the screen.

### Verifying the install

| Check                   | Expected                                  |
| ----------------------- | ----------------------------------------- |
| `/opencreator`          | Freecam activates, panel opens            |
| Catalogue count         | 15,946 objects on the **All Objects** tab |
| Vehicle filter          | 843 entries                               |
| Ped filter              | 830 entries                               |
| Server console on start | No `couldn't find file` warnings          |

If the catalogue is empty or the counts are far off, the resource did not finish loading — check the server console for a Lua error.

### Updating

Replace the folder and restart the resource. Placements live in the database, not in the files, so an update never costs you a map.

```
refresh
restart aty_mapeditor
```

`refresh` is only needed when the file list changed — which it does on every version update, so run both.