FAQs

The editor does not open (/mapeditor or F7)

• Confirm cdev_mapeditor starts after oxmysql.

• ACE: add_ace group.admin command.mapeditor allow (or your license ACE). On Qbox prefer permissions.cfg.

• Default command is /mapeditor. Name comes from MapEditorConfig.Command.

• From another resource (client): exports['cdev_mapeditor']:OpenEditor().

• From server: exports['cdev_mapeditor']:OpenEditorFor(source) with a valid online player.

• Set MapEditorConfig.Debug = true, restart, and check F8 plus the server console.

Permission denied / no access

• ACE must match command.<Command> unless you set a custom MapEditorServerConfig.Permissions.ace.

• Framework admin alone works only when useFrameworkAdmin = true.

• Job name alone is not enough. This resource uses ACE (and optional framework admin flags).

Database tables missing

• oxmysql must be running with valid MySQL credentials.

• Tables are created automatically on boot. There is no SQL file to import.

• After fixing the database: ensure cdev_mapeditor or restart the server.

Other players do not see my props

• Set the map to Go Live / production in the Maps panel.

• Players need to be within live sync / runtime distance of the map content.

• With the editor closed, runtime streams by spawnRadius / despawnRadius.

• Check server console for WorldSync / bundle errors with Debug on.

A GTA world prop I erased came back

• Erased props use model hide. They reapply when you enter the area again.

• Opening the editor far away, then closing, used to clear hides without restamping. Current builds reapply loaded hides on close.

• Clearing production or switching live maps changes what stays hidden.

• Some official props only fully return after a reconnect.

Loading / unloading toasts spam or never show

• Controlled by MapEditorConfig.Runtime.showLoadToast, showObjectsToast, showUnloadToast, showHideApplyToast.

• Set them to false for a quieter live server.

• Soft-cache revive still counts for the objects toast when that flag is on.

Array Enter or click feels wrong

• Enter applies while Array is active (including inside Count / Spacing / Heading).

• Clicking the world while a field is focused only blurs the input. It does not pick a prop.

• You must click a placed map prop first so selection is not empty.

Catalog images blank

• Check Catalog.imagePath, fallbackImagePath, and defaultImage.

• Custom props can set their own image URL or local resource path.

• Pleb Masters fallback needs network access from the client CEF.

PropShot button missing

• Start cdev_propshot and restart or reopen the map editor.

• See cdev-propshot.md for capture permissions and screenshot resource requirements.

Exports from another resource fail

• Resource name: cdev_mapeditor

• Start order: ensure map editor before scripts that call it.

• Server exports need a valid source where required.

• See the Exports pages for client vs server examples.

---