What goes wrong most often with Theme Park, what it means and how to fix it. The resource explains itself in the consoles: problems found on the server are printed in the server console, problems on a player's game in their F8 console, always on lines starting with [qs-themepark] that name the resource, table or setting involved. Read those lines first.
Installation and Database#
Rides or the darts booth are invisible
One of the two asset resources is not running. About ten seconds after the start, the server console names it:
[qs-themepark] resource qs_amusement_park_anim_prop is not started (state: missing), so the rides it streams are invisible. Make sure it exists, has an fxmanifest.lua and its models in its stream/ folder, and starts before qs-themepark.qs_amusement_parkstreams the park map, the darts booth, the darts and the plushies;qs_amusement_park_anim_propstreams the bumper cars and their ticket booth, the drop tower, the sky drop, the flying swings and their lights. Both must be in your resources and started beforeqs-themepark— see Installation.Every file must sit directly in their
stream/folder. A.ytypmoved into a subfolder is not loaded and its ride turns invisible.Renamed one of them? Put the new name in
config/config.lua:Config.AssetResourcefor the rides,Config.DartsAssetResourcefor the darts booth.On the player's side the F8 console says
model … does not exist. Check that the resource that streams it is started.
No ride moves after the server starts
The rides, the games and the panel wait for the saved settings, which are read from the database. When it does not answer, the console says:
[qs-themepark] the saved settings could not be read from the database within 60 s: the ones saved before the last stop stay in force, and the database is read as soon as it answers (until then /themeparkconfig cannot save). Check oxmysql (set mysql_connection_string in server.cfg).Check that
oxmysqlstarts beforeqs-themeparkwithout errors and thatmysql_connection_stringinserver.cfgis right.After 60 seconds the park runs with the settings saved before the last stop and switches to the database as soon as it answers. Until then the panel refuses to save, and the console says
the config panel cannot save yet./themeparkconfigonly exists on a player's game once the settings have reached them, so it does nothing in the first moments after a start.
Database and oxmysql messages
Theme Park creates any missing table on start, so most of these are fixed by importing sql/database.sql and checking oxmysql. Importing it again is safe: nothing is doubled.
Console message | Meaning and fix |
|---|---|
| The settings table cannot be read. It is read again on its own; import the SQL file and check oxmysql. |
| A panel save was refused or took longer than 15 s. Nothing was applied: check the database and save again. |
| A row was edited by hand. Save that field again in the panel. |
| A saved list is broken. The one in force before the last stop is kept: save the list again in the panel. |
| The score table is missing or refused the row. The same lines exist for hoops. Import the SQL file. |
| Passes bought meanwhile are kept in memory and last until the next restart only. See Day pass questions below. |
|
|
| Standalone only: |
Settings Panel and Commands#
"You do not have permission to change the theme park settings"
The player lacks the command.themeparkconfig ace. The server console names them and the line to add:
[qs-themepark] John Doe (3) tried to open the config panel without ace "command.themeparkconfig". Grant it with: add_ace <group> command.themeparkconfig allowadd_ace group.admin command.themeparkconfig allowBeing an ESX, QBCore or Qbox admin is not enough: the panel only checks that ace. Make sure the player is in the group you gave it to — see Installation.
"The settings panel could not be opened"
The panel's page did not load within five seconds. It ships ready inside qs-themepark, so when it is missing the resource was copied incompletely. The shops show The shop could not be opened for the same reason.
Download the resource again from the CFX Portal, replace the whole qs-themepark folder and restart. Your settings are in the database and stay; keep a copy of config/ and custom/ first if you edited them.
I renamed the settings command and the new name does nothing
The command name is the only setting that needs a restart: the field shows Needs restart and the panel says Restart the resource to apply. Restart qs-themepark or the server. /themeparkconfig keeps working in the meantime and after the rename. Every other field applies at once, for every player.
Panel messages#
Message | Means |
|---|---|
The settings could not be saved | The database refused the change, did not answer in 15 s, or has not been read since the start. Nothing was changed; the server console says why. |
You do not have permission to change the settings | The ace was taken away while the panel was open. |
Restart the resource to apply | You saved the command name: it takes effect after a restart. |
Fix the fields marked in red before saving | A prize tier breaks a rule: a repeated score, a tier without prizes, a bad item name, or a maximum below the minimum. |
Payments, Tickets and Day Pass#
Nobody can pay for a ride, even with money
The framework could not be reached, so payments are blocked on purpose: no money is handed out from nowhere. The console says:
[qs-themepark] rides cost $250 but the esx framework cannot take payments right now, so nobody can board. Check the errors above, or set the ride price to 0 in /themeparkconfig.The lines above it tell which case it is:
es_extended is running but qs-themepark stayed on "standalone" (it started before the framework)— move the framework aboveqs-themeparkin server.cfg and restart.could not get the es_extended object within 60 s(or the qb-core / qbx_core object) — the framework did not answer; check that it starts without errors before Theme Park.an ESX player operation failed (…)— ESX keeps its accounts in an inventory (such as qs-inventory) that is not started.could not load custom/esx/server.lua (…)followed bymoney stays BLOCKED— the bridge file has an error. Undo your changes incustom/(see Integrations).
Meanwhile you can set the prices to 0 in the panel (Money, Darts, Hoops) to keep the park open.
"You need $250 to get on"
Rides are paid from the account set in Settings → Money → Ride payment account: cash (
money) orbank. A player whose money is only in the other account is refused.Each ride can have its own price:
-1uses the park price and0makes the ride free.An active day pass and ride tickets come before money: a player with either pays nothing. Darts, hoops and the stands always take money, from the account set in their own section.
Standalone: each player has a wallet in
qs_themepark_wallets, where cash and bank are one purse. A new wallet starts with 0 cash and 500,000 bank (DEFAULT_MONEYandDEFAULT_BANKat the top ofcustom/standalone/server.lua).
Ride tickets are not used
When a player boards, the ride is paid with an active day pass first, then one ride ticket, then money. A player with a pass keeps their tickets. If tickets are still not used:
Tickets are off by default: turn on Settings → Tickets & day pass → Ride tickets.
The item must exist in your inventory under the name set in Ticket item (
themepark_ticketby default); Installation has it for every inventory. If the inventory does not know it, players pay money as if they had no ticket, and the ticket booth either says there is no room or refunds the purchase with this console line:bash [qs-themepark] could not give 5 x themepark_ticket to John Doe: is the item registered in your inventory? The $1,250 was refunded.A name with anything but letters, numbers, _ and - turns tickets off:
the ride ticket item "…" (/themeparkconfig > Tickets) is not a valid item name (letters, numbers, _ and -): tickets are not used.A ride with a price of 0 is free: no ticket is used.
Tickets only pay rides, not darts, hoops or the stands. The booth sells up to 20 at a time, paid from the Day pass and ticket account.
Day pass questions
"The day pass is not on sale" — it is off by default. Turn on Settings → Tickets & day pass → Day pass on sale. It is then sold at the ticket booth and in every ride's panel.
How long does it last? The Day pass length (120 minutes by default) in real time from the purchase, whether the player is online or not. Buying another one adds its minutes to the pass running.
Does it survive a restart? Yes: passes are saved in
qs_themepark_passes, by character on ESX, QBCore and Qbox and by license on standalone. When the console sayscould not save a day pass to qs_themepark_passesoroxmysql is not loaded: day passes only last until the next restart., fix the database first.What does it cover? Every ride, as many times as the player likes. Darts, hoops and the stands are not included.
"You need $2,500 for the day pass" — the pass is paid from the Day pass and ticket account, cash or bank.
Giving a pass from another script: the
GivePassexport works even when the pass is not on sale — see Commands and Events.
Revenue does not reach the society account
Revenue is off by default: turn on Settings → Revenue → Send revenue to a society and check the Society job (themepark by default) and the share. Rides paid with money, day passes, tickets, darts, hoops and the stands all count. When a deposit fails the console says why, at most once a minute:
[qs-themepark] could not deposit $250 into the society account of job "themepark" (ride coaster): the account society_themepark does not exist (register the society of job "themepark"). Check /themeparkconfig > Revenue.ESX: the money goes to the
esx_addonaccountaccountsociety_<job>, whichesx_societycreates for a registered society. The reasons readesx_addonaccount is not startedorthe account society_… does not exist.QBCore / Qbox: the job account in
qb-banking,Renewed-Bankingorqb-management, whichever is started. The reasons readno banking resource is startedor… refused it (does the account of job "…" exist and hold enough?).Standalone: there are no society accounts. The console says so once and the revenue is not deposited anywhere.
A refund (a game cancelled, a prize that could not be delivered) takes the share back out of the account; on ESX that is refused rather than taking the account below zero.
Failed deposits are also posted in the
economyDiscord log. More on the banking resources in Integrations.
Rides#
"This ride is closed right now"
The ride is turned off in the panel: Settings → Ferris wheel, Roller coaster, Towers or Bumper cars. The switch applies at once, with no restart: a ride turned off takes no new riders and stops once the riders on it are off. The console and the rides Discord log say so:
[qs-themepark] Roller coaster switched off: it takes no new riders and stops once the riders on it are off."The train already left" or "This round already started"
Boarding closes a few seconds before departure — 8 s on the roller coaster, 6 s on the towers, 2 s on the bumper cars — and stays closed while the ride runs. Wait for the next countdown, or give the ride a longer boarding time in the panel. No free seats left and That seat is already taken mean the ride is full or another player took that seat first.
"You are too far away" or "You are already on a ride"
The server checks the player's real position when they board: stand at the boarding point where the prompt appears — on the roller coaster, at the seat you want — and try again. A player can only be on one ride at a time.
I cannot get off the Ferris wheel or the coaster
Correct behaviour. Only the bumper cars can be left early, with F. Every other ride lets its riders off when it ends: the wheel after its laps, the others back at the station. The ride keys are listed in Usage.
Darts and Hoops#
The dart targets or the basketball machine do not appear
The dart targets and the hoops lanes come only from sql/database.sql, which adds the park's 6 dart targets and the 3 lanes of the basketball machine. Without it the resource creates the tables empty, and the console says:
[qs-themepark] loaded 0 dart targets
[qs-themepark] loaded 0 hoops lane(s)Import
sql/database.sqland restart. Importing it again is safe: it never doubles a target or a lane.Check Settings → Darts and Settings → Hoops: turned off, the game is hidden, a game in course is cancelled and refunded, and players see The darts booth is closed right now or The basketball machine is closed right now.
dart target #4 in qs_themepark_darts is not valid and is ignored(or the same for a hoops lane inqs_themepark_hoops): a row was edited by hand. Delete it and import the SQL file again to get the shipped one back.the dart targets could not be loaded from the database within 20 s(or the hoops lanes): the database is slow. Players get them as soon as it answers.The booth itself is streamed by
qs_amusement_park: see Rides or the darts booth are invisible above.
Nobody ever wins a prize
There is no valid prize tier, or the lowest one is out of reach:
[qs-themepark] the darts have no valid reward tier: the targets work, but nobody can win. Add tiers in /themeparkconfig > Darts.Add tiers in Settings → Darts → Score rewards or Settings → Hoops → Prize tiers, or restore the defaults. If you lowered Darts per game or the hoops Round length, lower the tiers with them.
Only a game played to the end pays: every dart thrown, or the hoops round played to the buzzer. A player who walks out of the circle before gets no prize.
After a start without the database the console says
the darts reward tiers saved before the last stop are not known: the darts pay no prize until the database answers.This is on purpose: the default tiers could pay what you never meant to.
"The prize could not be delivered" or no room for the prize
The default prizes are money and always arrive. An item prize can fail when the inventory is full or does not know the item. Then:
If the tier also has a money prize, the player gets one of those instead. When the inventory was full they see You have no room in your inventory for the prize (…).
If nothing can be handed over, the price of the game is refunded: The prize could not be delivered (…), your $150 was refunded. A free game cannot be refunded, so the player sees … tell an admin.
Either way, the prize cooldown does not start.
The console names the prize and why, and an unknown item once with the tier it comes from:
[qs-themepark] could not hand the prize of dart target #2 to John Doe (2x Pier Plush): it does not fit in the inventory
[qs-themepark] Config.Darts.Rewards[2].prizes[1] gives the item "teddy", which does not exist in the inventoryFix the item name in the tier (hoops tiers are named hoops_rewards[…]) or add the item to your inventory. Every failed delivery is also in the Discord log: darts, or games for the basketball machine.
"You won a prize recently, try again in … s"
The prize cooldown (120 s by default) runs for that player after a prize; Wait a moment before playing again is the cooldown between games (5 s). Shorten them, or set them to 0, in Settings → Darts and Settings → Hoops.
A score is missing from the leaderboard
Only games played to the end are recorded. Each list shows ten players with each one's best game, and Today follows the server's clock. If the console says could not load the darts leaderboard or a darts score of … could not be saved, import sql/database.sql.
Stands and Vendors#
A vendor or the ticket booth does not appear
Each type of stand can be closed: Food stands open, Souvenirs open and Ticket booths open. A single stand can also be switched off in the stand list (Settings → Stands & booth).
The ticket booth only opens while Ride tickets or Day pass on sale is on. Both are off by default, so a fresh install has no booth vendor.
A ped model that does not exist is replaced by the stock one, and the F8 console says
the ped model "…" of the stand "…" does not exist: the stock one is used. Fix it in /themeparkconfig.A stand whose menu has every item turned off shows <name> is closed and sells nothing.
Placing and moving stands is explained in Usage.
An order could not be handed over
You have no room in your inventory for … — a menu row in Inventory item mode does not fit. Nothing was charged.
Part of your order could not be handed over or Your order could not be handed over — the item of an Inventory item row does not exist in your inventory. That line is refunded and the console says
could not give 1 x themepark_hotdog to John Doe from the Hot Dog Cart stand: is the item registered in your inventory?Register the item (see Installation) or switch the row back to eat or carry.A player carries one souvenir at a time: an order with two is refused, and a new one replaces the one in hand.
Food does not fill hunger or thirst
Food eaten on the spot fills hunger and thirst through the framework: esx_status on ESX, the player's metadata on QBCore and Qbox. On a standalone server there is nothing to fill, so only the animation plays. When it fails, the console says it once, for example:
[qs-themepark] food from the stands restores no hunger or thirst: esx_status is not startedDiscord Logs#
No Discord log arrives
Every URL in config/webhooks.lua is empty when you install the resource, and a log without a URL is simply not sent. Paste a webhook URL next to default for everything, or next to rides, darts, games (basketball machine), economy and admin (changes made in /themeparkconfig) for separate channels; an empty one uses default. Restart qs-themepark after editing the file. Logs are queued and sent in batches, so they arrive a moment later.
The console says when Discord refuses them:
[qs-themepark] Discord log: webhook 1234567890 refused the logs (status 404: the webhook does not exist any more). Check the URLs in config/webhooks.lua.did not answer (status …) 3 times: … log(s) were dropped means Discord or the network was down; cannot keep up, the oldest logs are dropped means more logs than Discord accepts. See Integrations for the log options.
Still stuck? Set
Config.Debug = trueinconfig/config.luafor extra console output, restart, and open a ticket with every[qs-themepark]line from the server console and the F8 console.



