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.

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