What goes wrong most often, what it actually means, and what to do about it. Most problems come from load order, permissions or a missing token — start by reading the server console from the top.
Installation and Access#
"You don't have permission to do this"
The player is neither a framework admin nor in a job listed in Config.CreatorJobs with an allowed grade.
ESX: the player's group must be
adminorsuperadmin.QBCore / Qbox: the
godoradminpermission, or thecommandace.Jobs: the job name must match exactly, and
gradeis a list of grade numbers — orfalsefor all.
Police or EMS players can open the builder
The example entries in Config.CreatorJobs are still there. Remove police and ambulance (or empty the table) and restart.
The resource does not start, or errors about the framework
City Builder needs OneSync, ox_lib, oxmysql, screenshot-basic and ESX, QBCore or Qbox, all started before it. A framework that starts later is not found, and the resource cannot load its bridge.
Errors about qs_city_objects or qs_citybuilder_decorations
The tables do not exist. Import [sql]/database.sql into the database your mysql_connection_string points at, and restart. Avoid XAMPP: it drops connections under FiveM.
The catalogue shows no pictures
The resource folder was renamed. Pictures are loaded from nui://qs-citybuilder/web/, so the folder must be called qs-citybuilder. For a single custom prop, check that its image URL opens in a browser.
The player is stuck with a cursor or a frozen camera
Press F5 to toggle the cursor, then Esc. If the resource was restarted while someone was building, they may need to reconnect.
Decoration Mode#
"You are too far from the decoration area"
The camera flew more than Config.MaximumDistanceForDecorate metres (350 by default) from your character, so the builder closed. Walk or teleport your character closer to where you want to build and open it again — or raise the value, or set it to false.
"The entity selection is disabled, you need to go stash category first"
You clicked an object that is already placed while the Objects tab is open. Placed objects are selected from the Stash tab — open it, then click the object.
"Focus object is not supported in the mouse decoration mode"
Camera focus (F) only works in gizmo mode. Press M to switch.
Moved objects jump back to their old place
Moving an already placed object is not saved until you press Save Location in its management panel. Move everything you need, then save once before closing.
Placed objects are not visible
Objects only spawn within
Config.SpawnDistance(30 m) of the player. Walk closer.The object was put away: find it in the Stash tab — it shows In Stash — and bring it back.
The console prints "This model is not loaded": the model no longer exists — a custom prop pack was removed. Restore it, or sell the object.
I can only see the Stash tab, not the catalogue
Config.EnableF3Shop is false. Set it to true and restart.
Prices are hidden, or selling pays nothing
Correct behaviour with Config.EnableMoney = false, the default. Turn it on to charge and pay out.
The anticheat kicks or bans the builder
The free camera looks like freecam or noclip to an anticheat. With FiveGuard, set Config.FiveGuard to its resource name; with any other, whitelist your builders in it.
Stashes, Wardrobes and Doors#
[E] - Open stash does nothing
No supported inventory was detected — it is missing or starts after City Builder. Move its ensure line above qs-citybuilder, or force it with Config.Inventory (see Integrations).
The wardrobe opens the wrong menu, or none
Your clothing script was not detected and the default bridge is in use. Fix the load order, or set Config.Wardrobe by hand — mAppearance always needs this.
A prop I made a wardrobe has no [E] prompt
In config/furniture.lua the type is spelled 'gardrobe'. 'wardrobe' is ignored. Also check that it has an offset.
Doors stay frozen
All three are needed: setr game_enableDynamicDoorCreation "true" in server.cfg, Config.DynamicDoors = true, and isDoor = true on the prop in the catalogue.
Furniture Creator and Photos#
"Object name is not valid, are you sure it is in the game?"
The model does not exist on this client: a typo in the spawn name, or a custom prop whose resource is not streamed. Check the exact name in a prop browser such as PlebMasters Forge, and make sure the prop pack is started.
"The Object name … is already in this category"
Another custom prop in that category uses the same model. Edit that one instead, or pick another category.
"Cannot delete config items, only database items"
The prop comes from config/furniture.lua. Remove it from the file and restart.
"FiveManage token is not set"
Paste your token in config/fivemanage.lua and restart. The photo studio also needs the player to have Furniture Creator permission. Until it works, paste image URLs by hand.
The photo studio does nothing, or the picture is black
Make sure
screenshot-basicis started and up to date — replace it with the latest from cfx-server-data and delete the servercachefolder.On a slow PC, raise
Config.FurniCreator.intervalso the prop finishes loading before the capture.
A new prop does not appear in decoration mode
Props are sent to everyone the moment they are created. If the builder was already open, close it and open it again. After a restart, a console line "Category not found" means the prop's category was removed from config/furniture.lua — add the category back.
Still stuck? Open a ticket and include the server console from the start of
qs-citybuilder, your framework and inventory, and the F8 console of the player with the problem. Turning onConfig.Debugfor a moment gives far more detail.



