> For the complete documentation index, see [llms.txt](https://docs.rainmad.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.rainmad.com/resources/map-editor-place-anything/installation.md).

# Installation

{% stepper %}
{% step %}

### Install the Dependencies

{% hint style="info" %}
Make sure everything on the [Dependencies](/resources/map-editor-place-anything/dependencies.md) page is installed and starting **before** this resource.
{% endhint %}
{% endstep %}

{% step %}

### Add the Resource

Download the package from [Portal](https://portal.cfx.re/assets/granted-assets), unzip it, and put the folder in your server's `resources` directory:

* `rm_mapeditor`

{% hint style="danger" %}
Do **not** rename the folder. The resource reads its own files by name: the catalogue, the thumbnails, the locale. A renamed folder is a resource that finds none of them.
{% endhint %}
{% endstep %}

{% step %}

### Start It

Add it to your `server.cfg`, below `oxmysql`:

```cfg
ensure oxmysql

ensure rm_mapeditor
```

{% endstep %}

{% step %}

### Grant Access

Nobody can open the editor until they are allowed to. Two tiers, and the broad `command` ace counts as both:

```cfg
# a builder: their own layouts, and nothing of anybody else's
add_ace group.builder command.map_editor allow

# every layout, and the switch that stands one up for the whole server
add_ace group.admin rm_mapeditor.admin allow
```

Or by identifier, for one or two people without touching aces, in `cfg.lua`:

```lua
cfg.authorizedIdentifiers = {
    ['license:110000112a4b6c8'] = true,
}
```

Both ace names are settings, not fixed strings. See [Configuration](/resources/map-editor-place-anything/configuration.md).
{% endstep %}

{% step %}

### Database

Nothing to run. The `rm_mapeditor_layouts` table is created on the first save, and only if the layout library is switched on.
{% endstep %}

{% step %}

### Try It

In game:

```
/map_editor
```

The layout browser opens. **New layout** drops you into the editor with a free camera and the prop picker along the bottom.

```
/prop_inspect
```

The same session with nothing to place: click anything in the world to read what it is.
{% endstep %}
{% endstepper %}

## About the Prop Pictures

The picker draws around 30000 thumbnails, packed into sprite sheets. They are **not** downloaded when a player joins: they arrive the first time somebody opens the picker (about 80 MB) and are cached by hash from then on, so it is one wait, once, per version.

If you would rather serve them yourself, point `cfg.nui.imageBaseUrl` at a host you control and copy `assets/props/` across. Details in [Configuration](/resources/map-editor-place-anything/configuration.md).