What goes wrong most often, what it actually means, and what to do about it. For anything not listed, set Config.Debug = true for a while: every step is printed to the server and F8 consoles.
Installation#
The server console closes right after starting
The console prints The console will close because qs-motorhome changed its name! first. The resource folder was renamed. Rename it back to exactly qs-motorhome.
Errors about a missing table or the motorhome_inside column
The SQL was not imported, or the wrong file was. Import [sql]/esx.sql on ESX (it alters users) or [sql]/qb.sql on QBCore (it alters players).
Nothing works and the console mentions GetIdentifier or ESX/QBCore being nil
The framework was not detected — it starts after qs-motorhome, or it is renamed. Move it above in server.cfg. On Qbox, add ['qbx_core'] = 'qb' to the frameworks table in config/main.lua.
The interior is invisible, or the player falls through the floor
The shell model is not streamed. Make sure K4MB1-Motorhomes and K4MB1-StarterShells are started, and that every model in Config.Shells is a shell your server actually streams.
The cleaning robot or junk shows as a missing model
The Motorhome [props] resource is not installed or not started. It is a separate download in the CFX Portal.
Entering and Leaving#
No prompt appears at the door
Either the vehicle's model is not in Config.Vehicles, or its doorOffset points somewhere else — the prompt only shows within 1.5 metres of that point. Turn on Config.Debug and use /motorhome:offsets to see where the door is. With Config.UseTarget on, look for the option on the vehicle itself.
"Enter Van" is greyed out for the owner
The plate is not registered to that player in owned_vehicles or player_vehicles. Vehicles spawned with an admin menu have no owner. Buy or register the vehicle, or have the owner use /vanGivekey.
A friend's key stopped working
Correct behaviour. Shared keys are kept in memory and cleared when the resource or the server restarts. Give the key again.
A camera opens instead of the interior
That tier has no exit point yet. Aim at a spot inside the interior and press Enter; it is saved to shell_offsets.json for everyone and the next entry works normally. A point outside the interior is refused. Only tier 1 ships with an exit, so do this once per tier after installing.
Saving the exit point does nothing
The server could not write shell_offsets.json. Check that the file is not read-only and that the server user can write inside the resource folder.
The player is alone in an empty world, or other players are invisible
They were left in a motorhome's routing bucket — usually after a crash or a restart while inside. /rt puts them back in bucket 0.
The visitor is not let in after the bell
The visitor walked away from the door. [G] Open door only lets them in while they are within 2 metres of where they rang.
Storage and Wardrobe#
The stash does not open
No supported inventory was detected, so there is no stash to open. Start your inventory before qs-motorhome, or map it in the inventories table. If the stash asks for a code, someone set a vault code on it.
"You cannot create more vault codes in this house"
The motorhome already holds ten codes. Remove one from a stash you no longer need to lock.
The wardrobe opens the wrong menu, or nothing
Your clothing script was not detected and the default wardrobe is being used. Start it earlier, or add it to the wardrobes table.
Decoration and Furniture#
"Decoration is not available, someone using it"
Another player inside already has the editor open. It frees itself when they close it or disconnect.
The editor will not open while a robot is out
Correct behaviour. Stop the cleaning robot and wait for it to reach its dock first.
Placed doors do not open
Add setr game_enableDynamicDoorCreation "true" to server.cfg, keep Config.DynamicDoors = true, and restart the server.
"This model is not loaded" in the console
A furniture item points at an object your server does not stream. Fix the object name in config/furniture.lua or the furniture creator, or start the resource that streams it.
The player is kicked or flagged by the anticheat while decorating
The free camera looks like noclip. On FiveGuard, set Config.FiveGuard to its resource name. For other anticheats, whitelist freecam for qs-motorhome.
"FiveManage token is not set" in the furniture creator
Put your token in config/fivemanage.lua and restart, and make sure screenshot-basic is running. Or paste image URLs instead of photographing.
"Cannot delete config items, only database items"
Correct behaviour. Furniture from config/furniture.lua is removed by deleting it from the file; the creator only deletes what it created.
Break-ins and Camping#
The lockpick does nothing
Stand within 1.5 metres of the motorhome's door. If the player sees a police message, fewer than Config.ReqPoliceCount officers are online (on QBCore, on duty) — set it to 0 to allow break-ins at any time. If the item is not usable at all, it does not exist in your inventory under the name in Config.LockpickingItem.
Camp objects disappear
Correct behaviour. They are removed when the motorhome is more than 30 metres away, and they are not saved across sessions. Placement is also cancelled if you walk more than Config.MaxSpawnDistance (15 m) away while placing.
Still stuck? Open a ticket and include your framework and inventory, your
server.cfgload order, and the server and F8 console output withConfig.Debug = true.



