> 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/troubleshooting.md).

# Troubleshooting

Work down the list. Everything here is something the resource says out loud, in the server console, the client console (**F8**) or on screen.

## The Command Does Nothing

**"You are not allowed to use the map editor."**: the permission. Grant `command.map_editor`, or add the identifier to `cfg.authorizedIdentifiers`. See [Installation](/resources/map-editor-place-anything/installation.md).

**Nothing at all, not even that**: the command is switched off (`cfg.commands.editor = false`), or the resource isn't running. Check the console for `rm_mapeditor` at start.

## The Editor Opens but the Tiles Are Empty or Wrong

**Empty tiles, everything else fine**: the thumbnails haven't arrived yet. They are fetched the first time somebody opens the picker, about 80 MB, and cached by hash after. The console says `propImages did not arrive` if it timed out; check the player's download and try again.

**Every tile shows the wrong picture**: a mix of files from two versions. The console says so:

```
N catalogue rows carry no picture reference; this install mixes data and image files
from different versions
```

Replace the whole folder rather than some of it. `data/catalog.json` and `assets/props/` are a matched pair.

**Serving them yourself and nothing loads**: `cfg.nui.imageBaseUrl` must serve either `atlas.json` plus the sheets, or one `<model>.webp` per prop with no `atlas.json`. Anything half-mirrored looks like this.

## A Prop Won't Place

The message says which case it is:

| Message                                                                          | What it means                                                 |
| -------------------------------------------------------------------------------- | ------------------------------------------------------------- |
| This server does not stream that model                                           | nothing on this server carries it                             |
| This prop came with a game update your server does not run                       | it needs a newer gamebuild                                    |
| Not available where you are: this prop belongs to an interior that is not loaded | its archetype is only mounted near that interior. Walk closer |
| Nothing under the crosshair to stand it on                                       | aim at something                                              |
| Outside the area this session is building in                                     | the boundary. Widen it in the session settings, or move       |
| Placement limit reached (N)                                                      | `cfg.editor.limit`                                            |

## The Map's Own Props

**"This is part of the map itself and cannot be re-made."**: the archetype has no name in any catalogue, and nothing can spawn a copy of a nameless one. Most walls, floors and kerbs are like that. It can still be taken out of view.

**A hidden piece comes back after a while**: hides are re-applied when the layout is active. If the layout isn't active, the hide belongs to the session and ends with it.

## Layouts

**"That layout belongs to somebody else."**: the builder tier sees only its own. Grant `rm_mapeditor.admin` for the full library.

**"Only an admin can activate a layout."**: the same ace.

**The list is empty on a server that has layouts**: the table exists but this player is a builder, so they see their own. Or `cfg.layouts = false`, which switches the library off entirely.

## Exporting

**"Could not write it. The server may not be allowed to write into the resource."**: the resource folder is read-only, or the server runs as a user that can't write into it. The export folders ship empty for exactly this write.

**"%s rows are runtime features, which no map file can hold. Left out."**: not an error. A ymap can't carry lights, hidden pieces, collision or embedded light colour, so those rows were left out. Use the layout file or the generated resource if you need them.

## Importing

See the table in Import & Export. Every refusal there's a different file problem, and the message names which one.

## Sessions with Other People

**The invitation card never arrives**: they were already in a session of their own, or the invitation timed out before it was answered. A guest needs no permission: whoever invited them has it.

**A guest sees no props**: they are given their own session holding the host's rows, so this means the host's snapshot never arrived. Check the server console for a warning at the moment they joined.

**"That session has ended."**: the host closed it, dropped, or the resource restarted.

## Still Stuck

Open a ticket in the [Discord](https://discord.gg/rainmad) with:

* what you did, and what happened instead
* the **server** console from the moment the resource started
* the **client** console (**F8**) if it is a UI or placement problem
* your `cfg.lua`