These are the problems that come up most often, what they mean and how to fix them. Most are setup, not faults: a resource that starts too late, an item missing from the inventory, or a setting that needs a restart. Read the matching entry before opening a ticket.
Installation and Access#
The server hangs on start and the console says "You have renamed the script!"
The folder must be named exactly qs-diamondcasino. Rename it back and update the ensure line to match.
The console says "Successfully loaded the framework. standalone"
No framework was found because it starts after the casino. Move ensure es_extended or ensure qb-core above ensure qs-diamondcasino. On Qbox, set Config.Framework = 'qb' in config/main.lua.
Errors that a casino_memberships table does not exist
The SQL file was not imported. Import [sql]/qs-diamondcasino.sql into the same database your server uses. Memberships and bans are only created by that file.
/casinoconfig opens but does not save
Your database user cannot create the settings tables. The console says so on start. Import qs-diamondcasino/sql/database.sql by hand and restart the resource.
"You are not allowed to change the settings"
/casinoconfig is for framework admins and the qs-diamondcasino.config ace. The casino's owner does not have it. If you added the ace, restart the server, and check that the identifier belongs to the account you are playing on.
/casino does nothing
The player is not an admin, the owner or an employee with at least one permission. Access comes from the casino, not from a job. An admin sets the owner with the crown button, and the owner or an admin hires employees.
A panel is blank, or never opens
The interface ships ready-made in web/build/. If that folder is missing or half-copied, the panels are blank. Copy the whole resource again from the download.
Chips, Memberships and Shops#
Players cannot buy chips
Check these in order:
Memberships are on and the player has none. They buy one at the membership desk first.
They reached the Daily chip limit. The cashier shows the time left.
Chips are an item and
casinochips(or your Chip item name) is not registered in your inventory.They do not have the money in the bank. Chips are always paid from the bank.
A player holds chips but the casino says they have none
With memberships on, chips only count for players with a membership. A second cause: Chips as an inventory item was switched after players already had chips. Chips held the old way are not converted. Switch it back, or settle balances by hand.
The VIP shop or the bar refuses to sell an item
The item is not registered in your inventory. Every row in /casinoconfig → Shops must exist there, under the same name. See Registering the Items.
Drinks cannot be used, or have no effect
The item must be usable in your inventory (on QBCore, useable = true). Its row in the bar list needs an effect other than none and more than 0 seconds. A drink you just added becomes usable once the list is saved. One you removed keeps its handler until the next restart, but does nothing.
Games#
"The casino has no funds right now"
The bankroll is below its Minimum balance and Block games when empty is on, so every game except billiards is locked. You can:
Deposit from
/casino→ Economy.Lower the minimum in
/casinoconfig→ Economy.Turn blocking off so the bankroll can go negative.
Tables have no dealer, or dealers and NPCs stand in the wrong place
The wrong map preset is loaded. This usually means your casino MLO starts after the casino, or runs under a different resource name, so the default layout was used. Move the MLO above ensure qs-diamondcasino, or set Config.Map by hand; see Integrations. Tables in BlackjackTables also need a matching table already in the map.
A slot machine does not respond
Stand next to it and run /slotdebug. The F8 console shows the map preset, whether you are inside the casino zone, and which nearby machines are recognised.
The Lucky Wheel says a VIP membership is needed
Correct behaviour. With memberships on, the wheel is a VIP perk. Turn memberships off to open it to everyone.
The Lucky Wheel car never arrives (ESX)
On ESX, the plate of the prize car is checked through esx_vehicleshop. Without it, the check never answers. Start esx_vehicleshop, or change IsPlateTaken in custom/esx/client.lua to ask your own vehicle shop or database.
The prize car comes without keys
The keys resource was not detected: it starts after the casino, is not on the supported list, or two key systems are running. Fix the load order or set Config.Vehiclekeys by hand.
An Inside Track Single Event does not start
The player must be within 30 metres of the big screen. Bets are also closed for everyone while a Main Event race is running.
A pool table I added does not appear, or the balls float
Only tables listed in BilliardConfig.Tables (and the VIP room's) can be played, and only on a model with a playing surface defined: qs_billard_table_01 or prop_pooltable_02. Use /poolplace to get the line, and /pooledit with /pooltune to line the surface up.
The Map and VIP Rooms#
The interior flickers, is doubled, or has holes
Two casino interiors are loaded at once. Run either casino_map or your casino MLO, never both. bob74_ipl is handled automatically.
Renting a VIP room fails, or the room is empty
casino_vip is not started; it holds the room's shell. Add ensure casino_vip above the casino. If rentals are switched off, the doorman says VIP rooms are unavailable. Turn them on in /casino → Events → VIP Room.
Players ended up far away after a restart during a VIP rental
Rentals do not survive a restart. Players inside are moved to Config.Vip.exitCoords, which points at the Vinewood casino. If your casino is somewhere else, change it in config/main.lua.
Music and Screens#
No music, and the F8 console keeps saying xsound or mx-surround is not started
Install and start xsound or mx-surround. If you do not want music, set Config.Sound = false in config/main.lua.
I changed Config.Sound and the music stayed the same
This is expected. Config.Sound is only the starting track. Once a track is picked in /casino → Music, that choice is saved and wins. Change it there.
Custom walls, cameras or jackpot screens do not appear after changing a setting
Those settings are marked Needs restart. Restart the resource. If the jackpot screens are black, the Render target does not belong to the Screen prop you set. Put both back to their defaults.
The jackpot win is not posted to Discord, or has no photo
Nothing is posted until a Winner webhook is set in /casinoconfig → Jackpot. The photo also needs screenshot-basic, and the winner must still be online when the draw happens.
Economy, Society and Target#
The society account receives nothing, or bets fail with errors
Config.Society does not match a supported value, or the account does not exist. It ships set to esx_society; QBCore servers must change it. On ESX, the society_casino account must exist in addon_account. See Integrations.
The bankroll and the society account do not match
They are two separate things. The bankroll is the casino's own pot, which bets and payouts move. The society receives the Casino cut on top of that, and never pays for games.
Target options are missing
Target mode needs Config.UseTarget = true and qtarget or ox_target started before the casino, followed by a restart. qb-target needs client/custom/target/main.lua adapted to its exports. Billiards always uses the E prompt.
Still stuck? Turn on Debug output in
/casinoconfig→ General and reproduce the problem. Then open a ticket with the server console from the start, a screenshot of the F8 console, your framework and the casino map you use.



