What goes wrong most often, what it actually means, and what to do about it. Most problems come from the load order or a missing item — read the first section before anything else.
Installation and Access#
The resource does not start
The console names the missing dependency. qs-housing needs oxmysql, ox_lib, bob74_ipl and screenshot-basic started before it, and game build 3095 or newer:
sv_enforceGameBuild 3095If the console says You have renamed the script!, rename the folder back to qs-housing.
/realestate (F7) does nothing
The player is not allowed, and the creator fails silently. They need one of:
A job and grade in
Config.CreatorJobs(defaultrealestate). On QBCore and Qbox the job must exist in your jobs file.ESX group
admin/superadmin, or QBCoregod/admin, withConfig.AllowAdminsToCreateHouses = true.On standalone, their identifier in the
Adminstable ofserver/custom/framework/standalone.lua.
Also check that F7 was not rebound in the player's FiveM key settings, and that no other interface has the mouse.
SQL error near "IF NOT EXISTS" when importing
esx.sql and qb.sql use MariaDB syntax so they can be re-run safely. Use MariaDB, or on MySQL 8 run each statement without IF NOT EXISTS and skip the columns you already have.
"Duplicate entry 'realestate'" at the end of esx.sql
The job already exists from a previous import. Harmless — everything above that line was applied.
"Illegal mix of collations" importing qb.sql on Qbox
Fixed in 5.5.41. Download the current version and import its qb.sql.
Duplicate key errors importing the preset houses
mirror_park.sql is part of all_houses.sql, or the houses were already imported. Import only one of the two, once.
"Waiting for houses to be initialized" in the console
A player joined before the houses finished loading. If it repeats, look above it for SQL errors: the schema was not imported or the database is unreachable. A player who joined too early can type /houseload.
Keys, lockpicks or pet bowls do nothing
The items are not registered in your inventory. Add housekey, lockpick, police_stormram, pet_food and pet_water as shown in Installation, plus the food from items.lua for cooking. The house key must be unique (not stackable). Pet bowls only work outside, on your own property.
The text shows in English, or the console warns about the locale
The locale code does not exist, or a custom translation is missing newer lines (those fall back to English). Use one of the 41 codes in locales/ and restart the resource. The warning is labelled [GARAGES] but comes from qs-housing.
Houses and Interiors#
Black screen or falling when entering a shell
The shell model is not streamed. Ensure the [shells] resources before qs-housing, and check that the shell's model in Config.Shells matches the streamed name. On slow connections raise Config.DefaultRequestModelTimeout. The creator refuses a model that is not streamed with "Model is not valid".
An IPL house sends me back inside, or exits in the wrong place
IPL interiors with a zone keep the player inside it, and their exit comes from Config.IplData. Make sure bob74_ipl starts first and that you run the latest version.
"Please add PolyZone / exit coords" in the console
A house is missing a required point and is skipped. Open it in the creator and place the missing point, or recreate it. For houses written by hand in Config.Houses, complete their coords.
MLO doors do not lock, or only from one spot
Only key holders can lock MLO doors. Update to the latest version, give the player a key, and tune Config.DoorDistance and Config.DoorDuplicateDistance for wide or double doors. Furniture doors need setr game_enableDynamicDoorCreation "true".
A player is stuck inside or spawns in the void
Their "inside" flag survived a crash. From the server console or a script:
exports['qs-housing']:ClearPlayerInsideByIdentifier('char1:xxxx')"Unknown column 'inside'" means the SQL file was not imported. OneSync must be on: interiors use routing buckets.
A player cannot buy a house
Read the notification. Usually they reached Config.MaxOwnedHouses, lack money in the house's payment method (price plus 20% fees by default), or the house was taken off the market with SetHouseForSale. From the phone app they must also be within 48 m.
Rent is never charged, or charged at an odd time
The default Config.RentScheduler.Mode charges once a real month, on the day the rental started. Config.RentTime only applies with Mode = 'interval'.
A player's house disappeared
Check the Discord log for "Auto Eviction": Config.Bills.AutoEviction removes owners after MaxUnpaidBills unpaid bills (400 by default). Raise it or disable it, and reassign the house with AssignHouseToPlayer if needed.
The house is dark
The lights are off (Door Menu → lights) or there is more than one unpaid bill. Pay them in F3 → Bills.
Decoration and Furniture#
Decorate will not open
The notification says why:
Not the owner —
Config.DecorateOnlyAccessForOwneris on.No key, or the key holder lacks furniture access in F3 → Settings → Permissions.
Bills not paid — pay them in F3.
Robot not docked — stop the cleaning robot first.
"You are too far from the decoration area"
The camera went beyond Config.MaximumDistanceForDecorate (350 m). Stay closer, raise it, or set it to false.
Cannot buy more furniture
The house reached Config.FurnitureLimits — 50 pieces, or 150 with the Furniture Upgrade. Stored pieces count too: sell the ones you do not use.
Furniture moved back to where it was
Moving a piece you own is only kept when you press Save before selecting another one or closing.
Furniture is invisible
Its model is not streamed: ensure [props] and the [dlc] packs you use. Furniture also only appears within Config.SpawnDistance (100 m).
Furniture packs from [dlc] are missing in the catalogue
They started before qs-housing. Ensure them after it, one by one — not with ensure [housing].
"Category does not exist in furniture settings"
Furniture was added to a category that is not in config/furniture.lua. Use an existing category. AddFurniture is a server export; the client one only prints that it moved.
"FiveManage token is not set" or photos fail to upload
Put your token in config/fivemanage.lua. "Failed to get presigned url" means the token is wrong or expired.
Furniture missing after updating from a very old version
Back up the database, run revert_decorations in the server console, and restart when it asks.
Integrations#
The stash does not open
No supported inventory was found at start. Ensure your inventory before qs-housing, or set it by hand — on plain ESX, Config.Inventory = 'esx_inventory'. If players get "you do not have keys", that is Config.StashNeedsKey.
Houses have no garage
No supported garage script was running when qs-housing started, so garages are off. Ensure it first, or set Config.Garage by hand. Apartments never have garages.
Target options do not appear
Set Config.UseTarget = true and run ox_target or qb-target. Config.ZoneDebug = true draws the zones so you can see where they are.
The real estate commission never arrives (QBCore)
Config.Society defaults to 'esx_society'. Set it to 'qb-management', your banking script, or 'none' — see Integrations.
The wardrobe, phone or dispatch is not used
Same cause: it started after qs-housing or was renamed. Fix the order or set the value by hand.
FiveGuard bans in the creator, decorate mode or when entering
Set Config.FiveGuard to your FiveGuard resource name. "FiveGuard SetTempPermission failed" in the console means the name is wrong. If the doorbell sound is blocked, set Config.DisableInteractSound = true.
House music does not play
It needs mx-surround, qs-3dsound or xsound, files (not links) in qs-housing/music/, and a shell or IPL house.
"Do not use qb-houses exports anymore"
Another script still calls qb-houses. It keeps working; move it to the qs-housing exports when you can.
Performance#
The console is full of [DEBUG] lines
Config.Debug ships on. Set it and Config.ZoneDebug to false on a live server; that also removes the developer commands.
Low FPS near many houses
Lower Config.SpawnDistance, keep Config.ShowClosestBlips on, and avoid huge apartment buildings (Config.MaxApartmentCount).
Version check messages
"New version available" lists what changed — download it from the CFX Portal. "API is not available" only means the version check could not be reached and is harmless.
Still stuck? Open a ticket with your framework, inventory and garage names, your server.cfg ensure order, and the console output from the start of the server.



