# Common Issues / FAQ

## The UI does not open when I use `/mapeditor`

Check the following:

* `ox_lib` is installed and started before the resource.
* `ensure sb-map-editor` is present in `server.cfg`.
* `Config.EditorCommand` matches the command you are trying to use.
* `ui/dist` exists if you are using a source checkout.
* There are no startup errors in the client or server console.

## My objects list is empty

The editor only shows models listed in `configs/config.lua` under `Config.Models`.

Add the props you want to use and restart the resource.

## Projects or zones are not being saved

The resource saves to MySQL only when a supported database resource is detected.

If no database is detected, it falls back to JSON files:

* `data/projects.json`
* `data/zones.json`

If neither mode appears to work, check the server console for database or file write errors.

## I get `NO_PERMISSIONS`

Review `configs/server_config.lua` and make sure your player matches one of the configured permission entries.

You can grant access through:

* framework groups
* player identifiers
* ACE permissions

## I cannot move the camera or object far enough

Two limits can block movement:

* `Config.MaxCameraDistance`
* `Config.MaxObjectDistance`

You can either raise those limits or grant these permissions:

* `camera.ignoreDistanceLimit`
* `object.ignoreDistanceLimit`

## I cannot place objects inside a zone

There are two common reasons:

* the zone is marked as a blacklist zone
* the current project is linked to another zone and the object is outside its allowed polygon bounds

Also make sure the zone has at least 3 points and valid `minZ` / `maxZ` values.

## Auto-spawned maps are not appearing after restart

Check that:

* `autoSpawn` is enabled for that project
* the project saved successfully
* the resource restarted cleanly without DB/file errors

## The wrong locale is loaded

The UI locale comes from:

* `ox:locale` convar when available
* otherwise `Config.DefaultLanguage`

Make sure the matching file exists in `locales/`, for example `locales/en.json`.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://squirrel-bracket.gitbook.io/squirrel-bracket-documentation/map-editor/common-issues-faq.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.