What goes wrong most often, what it actually means, and what to do about it. With Config.Debug = true, most of these also leave a line in the server console or the F8 console that names the cause.
Installation#
The resource does not start
The manifest depends on ox_lib and screenshot-basic. If either is missing or starts later, FXServer refuses to start qs-yacht. Ensure both, plus oxmysql, above it in server.cfg.
An error about loading custom.none.client / custom.none.server
No framework was detected. es_extended, qb-core or qbx_core must be started before qs-yacht. A renamed framework resource has to be added to the frameworks list at the top of config/main.lua.
Table 'qs_yachts' doesn't exist, or Unknown column 'yacht_inside'
The SQL was not imported, or only half of it. Run database/main.sql and then esx.sql or qb.sql, and restart. See Installation.
esx.sql fails on the datastore line
Your server has no esx_datastore. That row is only used by the built-in ESX wardrobe — skip it if you use a clothing script such as illenium-appearance or qs-appearance.
The console is full of yacht messages
Config.Debug ships as true. Set it to false once the install works; that also removes the /createyacht test command.
The Shop and Buying#
"No available yacht"
All 42 berths are owned. A berth only frees up when its yacht is sold to the bank. Lower Config.MaxYachtsPerPlayer if a few players are holding most of them.
"You don't have enough money" although the player has cash
Yachts, upgrades, flags and furniture are charged from Config.MoneyType, which is bank by default. Change it to money (ESX) or cash (QBCore) to charge cash instead.
"You can only purchase 1 yachts"
The player reached Config.MaxYachtsPerPlayer. A Tebex purchase ignores the limit when bypassMaxOwnedCount is on.
The weather flickers while previewing
Your weather script is not one the shop knows how to pause. Add its pause and resume events to client/custom/weather/weather.lua.
On Board#
A yacht berth is empty, or the yacht is invisible
Berths 36 – 41 use maps from later DLCs. Raise sv_enforceGameBuild to a build that includes The Contract. For any berth, also check that no other resource removes or replaces the yacht map files (apa_yacht_grp…).
The door, the bridge or the stash refuses a player
Only the owner and key holders open the door, enter the bridge and use the stash. Anyone else rings the bell with G — or the owner gives them a key from Key Management.
"No one is inside the yacht" when ringing the bell
The bell only reaches the owner, and only while they are online and inside the cabin. An owner on the deck or on the bridge does not hear it, and key holders cannot answer it.
"You are not in a yacht" on /yachtMenu
The menu opens near your yacht only — within 500 m of it. Go to the yacht, then type the command.
There is no stash or wardrobe on the yacht
They do not exist until the owner places them: Yacht Management → Locate Storage / Locate Wardrobe, stand on the spot and press G. Storage and wardrobe furniture from the decorator works too.
The stash does not open
Guests cannot open stashes. For key holders and the owner, the inventory was not detected — check that it starts before qs-yacht and is on the supported list, or pin it as shown in Integrations. With the Vault upgrade, a wrong code shows "Invalid vault code".
No music on board
No sound resource is running — start xsound, qs-3dsound or mx-surround before qs-yacht. If one is running, try a different link: YouTube only plays a video inside another program when its owner allows embedding.
I am moved to the passenger seat of the helicopter or a boat
Correct behaviour. Only the owner and key holders may drive the yacht's vehicles; everyone else rides as a passenger.
"This shower / jacuzzi area / lean area is currently in use"
Another player is already in that spot. Each one is held by a single player and frees itself when they leave or disconnect.
Decorating and Upgrades#
"Decoration is not available, someone using it"
Another owner or key holder is decorating the same yacht. Only one decorator is allowed at a time; it is released when they close it or disconnect.
"You are too far from the decoration area"
The free camera went further than Config.MaximumDistanceForDecorate (350 m) from where the decorator was opened. Raise it, or set it to false for no limit.
"You have reached the maximum number of furniture items"
The yacht holds 50 pieces, or 150 with the Furniture Upgrade. Pieces put in storage still count — sell the ones you do not need. Both limits are in Config.FurnitureLimits.
"You need to install the camera upgrade first"
Watching cameras needs the Security Camera System upgrade, and at least one camera placed from the Dynamic page of the decorator.
Tebex#
"Invalid Tebex transaction ID"
One of three things:
sv_tebexSecretis missing from server.cfg — the console warns about it after start.The transaction does not contain a package named exactly like
packageName. The console prints the package names it received.The ID was mistyped. It has the form
tbx-xxxxx-xxxxx.
"This transaction ID has already been used the maximum number of times"
The ID already bought maxYachtPerTransaction yachts. A used ID stays used for good, even if the yacht was sold since.
"Tebex redeem must be run by a player in-game"
The redeem command was run from the server console or by Tebex itself. It saves the ID to the player who types it, so it only works in game. Remove it from the package's game commands; players redeem in the shop or in chat.
Still stuck? Open a ticket and include your server.cfg load order, your framework and inventory, and the server and F8 console output with
Config.Debug = true.



