How Integrations Work#
Nothing inside Theme Park knows which framework, inventory or banking resource you run. Every outside call goes through a small, open bridge file, and the right one is picked on start from the resources that are running. The bridges are not encrypted, so a modified framework is adapted in one place.
Layer | Supported | Used for | Without it |
|---|---|---|---|
Framework | es_extended · qb-core · qbx_core | Money, character names, hunger and thirst from the food stands. | Standalone: every player gets a wallet saved in the database. |
Inventory | ox_inventory · qs-inventory · codem-inventory · core_inventory · tgiann-inventory · qb-inventory | Ride tickets, stand items in Inventory item mode, darts and hoops item prizes. | The framework's own inventory. |
Society account | esx_addonaccount · qb-banking · Renewed-Banking · qb-management | The park's revenue share. | Nothing is deposited, and the console says why. |
Notifications | qs-interface · ox_lib | Every message to a player. | The GTA feed above the map. |
Text UI | qs-textui | The classic prompts and the labels over the vendors. | GTA help texts and a plain 3D text. |
HUD | qs-interface — and any HUD you add | Hidden while the settings panel, a darts game or a hoops round is on. | Only the radar and the GTA HUD are hidden. |
Discord | Webhooks | Logs of rides, games, payments and settings changes. | No logs. |
A framework is never replaced by the standalone wallet behind your back. If ESX or QBCore is running but its bridge fails, or it started after Theme Park, payments stay blocked and the console says why — a standalone wallet on a framework server would hand out money from nowhere. Set the ride prices to 0 if you want the park open while you fix it.
Frameworks#
ESX, QBCore and Qbox are detected on start. QBCore and Qbox share one bridge. What each one is used for:
Framework | Bridge | Money | Food stands |
|---|---|---|---|
ESX |
| Cash is the | Hunger and thirst through esx_status. |
QBCore |
|
| The player's hunger and thirst metadata; the HUD is told through |
Qbox |
|
| The same metadata, which Qbox syncs to its HUD. |
Standalone |
| One wallet per player. | Only the eating animation. |
Which account is charged — cash or bank — is picked in /themeparkconfig for each part of the park: the rides, the darts, the hoops, the food stands, the souvenir stands, and the tickets with the day pass each have their own.
Standalone servers#
With no framework running, every player gets a wallet keyed by their license and saved in qs_themepark_wallets. Cash and bank are one purse there: a price is paid from the account set in the panel first and from the other for the rest, and money prizes go into it.
A new wallet starts with 0 cash and 500,000 bank. Change it at the top of custom/standalone/server.lua:
local DEFAULT_MONEY = 0
local DEFAULT_BANK = 500000Without a framework there is no hunger or thirst to restore, so food from the stands only plays the eating animation, and there are no society accounts, so the revenue share is not deposited anywhere. Items — ride tickets, stand items, item prizes — need one of the supported inventories to be running.
Overriding detection#
The framework and the inventory are picked from the lists in config/config.lua, read from the top: the first started resource wins. A renamed resource is added with its own name on the left:
local frameworks = {
{ ['my-renamed-core'] = 'qb' }, -- a renamed qb-core
{ ['qbx_core'] = 'qb' },
{ ['es_extended'] = 'esx' },
{ ['qb-core'] = 'qb' },
}Move a line up to make it win when two candidates run at once. Never run two inventories.
Adapting a framework bridge#
Each framework has one server bridge and one client bridge: custom/esx/, custom/qb/ (QBCore and Qbox) and custom/standalone/. The client bridge reads the player's data and the balance of their ride account. On the server, the rest of the script only calls these methods:
Server method | Answers |
|---|---|
| Whether payments can be taken now. |
| The player's identifier and character name, used for day passes, leaderboards and logs. |
| Money in the account |
| The revenue share in and out of a job's society account: |
| Hunger and thirst from the food stands, in percent of a full bar: |
Inventories#
Items go through server/custom/inventory.lua. The park uses an inventory for three things only:
Ride tickets — counting them, using one when a player boards, and handing over the ones bought at the ticket booth. If they cannot be delivered, the money is refunded.
Stand items — a food or souvenir row set to Inventory item mode. Whatever cannot be handed over is refunded.
Item prizes — a darts or hoops prize tier that gives an item.
The inventory is looked up on every call, so one that starts after Theme Park is still used. Without one of the supported inventories, the framework's own item functions are used. The items to register are on the Installation page and in items.md.
Before an item prize is paid, the script checks that the item exists. A tier that names an unknown item is reported in the server console, and when an item prize cannot be delivered (unknown item, no room), the player gets a money prize of the same tier instead, if the tier has one.
To add an inventory that is not on the list, add its name to INVENTORIES and give it a function in each of the five tables of the same file:
-- server/custom/inventory.lua, below the tables
LABEL['my-inventory'] = function(item)
return exports['my-inventory']:GetItemLabel(item) -- nil when unknown
end
CARRY['my-inventory'] = function(src, item, count)
return exports['my-inventory']:CanCarryItem(src, item, count)
end
GIVE['my-inventory'] = function(src, item, count)
-- true only when the items were really added
return exports['my-inventory']:AddItem(src, item, count) and true or false
end
COUNT['my-inventory'] = function(src, item)
return exports['my-inventory']:GetItemCount(src, item) -- a number
end
REMOVE['my-inventory'] = function(src, item, count)
-- true when taken, false when refused, nil when it does not say
return exports['my-inventory']:RemoveItem(src, item, count)
endLike the money methods, every one of these must answer at once: a ride checks the seat, takes the ticket and gives the seat in one go.
Society Accounts and Revenue#
With Send revenue to a society on (/themeparkconfig → Revenue), each payment times the Revenue share goes to the society account of the Society job (default themepark): rides paid with money, ride tickets, day passes, darts and hoops games, and food and souvenir sales. A cancelled darts game or hoops round that is refunded takes its share back.
Framework | Where the money goes | Make sure |
|---|---|---|
ESX | The esx_addonaccount account | esx_addonaccount is started and the job's society is registered (esx_society creates one account per registered society). A refund never takes the account below zero. |
QBCore · Qbox | The job account of qb-banking, Renewed-Banking or qb-management — the first one started, looked up on every deposit. | The job's account exists in that banking resource. |
Standalone | Nowhere: there are no society accounts. | Leave revenue off. The console says it once if it is on. |
Deposits run in the background and never hold a ride. One that fails is printed in the server console and sent to the economy Discord log as Revenue deposit failed, with the reason.
Another banking resource on QBCore or Qbox goes at the top of the SOCIETY list of custom/qb/server.lua; on ESX, change addSocietyMoney and removeSocietyMoney in custom/esx/server.lua.
-- custom/qb/server.lua: first entry of the SOCIETY list
{
resource = 'my-banking',
add = function(job, amount, reason) return exports['my-banking']:AddJobMoney(job, amount, reason) end,
remove = function(job, amount, reason) return exports['my-banking']:RemoveJobMoney(job, amount, reason) end,
},Notifications, Prompts and the HUD#
Notifications#
Every message to a player — You paid $250 for the ride, That seat is already taken — goes through one function, Notification(msg, kind) in custom/client.lua. It tries qs-interface, then ox_lib, then the GTA feed. kind is info, success, warning or error, and the title is the one set in Settings → General. To use another notification resource, put it at the top of the function:
-- custom/client.lua
function Notification(msg, kind)
if msg == nil or msg == '' then return end
-- Your own resource first:
exports['okokNotify']:Alert(title(), tostring(msg), 5000, kind)
do return end
-- ... the shipped chain (qs-interface, ox_lib, GTA feed) follows
endThe server sends its messages with Notification(src, msg, kind) in custom/server.lua, which hands them to the client function above, so one edit covers both sides.
qs-textui#
Wherever the park shows a GTA help text — every prompt of the classic interface style — qs-textui shows it in its own box when it is started, with the keys written as [E]. In the default interface style the rides and games use the park's own prompt card instead.
The vendors of the food stands, souvenir stands and ticket booth carry a label over their heads in both styles — only the closest one within 3 m. With qs-textui it is qs-textui's 3D text with a key badge; without it, a plain GTA text on a dark box. That choice is made when Theme Park loads, so start qs-textui before it.
Both live in client/custom/textui.lua: QSPark.ShowTextUI(text) / QSPark.HideTextUI() for the prompts and DrawText3D(x, y, z, text, id, key) for the labels. Point them at another text UI resource there.
Hiding the player's HUD#
While the settings panel is open, and during a darts game or a hoops round, the radar, the GTA HUD and your HUD resource are hidden, and brought back exactly as they were afterwards. qs-interface is supported out of the box; add yours to QSPark.HudResources in client/custom/hud.lua:
-- client/custom/hud.lua
-- Resource name = function that shows (true) or hides (false) that HUD.
-- Only called while that resource is started.
QSPark.HudResources = {
['qs-interface'] = function(visible)
exports['qs-interface']:ToggleHud(visible)
end,
['my-hud'] = function(visible)
exports['my-hud']:SetVisible(visible)
end,
}Discord Logs#
Logs are sent to the webhooks of config/webhooks.lua (setup on the Installation page). The file only runs on the server, so the URLs never reach the players. Each kind of log has its own URL; one left empty uses default, and with no URL at all it is not sent.
Category | What it logs |
|---|---|
| Who boarded which ride and how they paid. |
| Darts games, scores, prizes and refunds. |
| The basketball machine: rounds, prizes and refunds. |
| Ride payments, tickets, day passes, food and souvenir sales, and society deposits. |
| Changes made in /themeparkconfig: who, which field, old value → new value. |
| Every category above that has no URL of its own. |
Config.LogOptions sets the webhook's username and avatar, and showIdentifiers adds the player's license, Discord and Steam ids to every log about a player (set it to false to show only the name and server id). Logs are queued and sent in batches within Discord's rate limits, so a busy park never slows a ride down or gets the webhook blocked.
Languages#
41 translations ship in locales/, one JSON file per language code, covering the prompts, the notifications, the park's panels and the settings panel. English is the default:
Arabic (ar) · Bengali (bn) · Bulgarian (bg) · Catalan (ca) · Chinese (zh) · Croatian (hr) · Czech (cs) · Danish (da) · Dutch (nl) · English (en) · Estonian (et) · Finnish (fi) · French (fr) · German (de) · Greek (el) · Hebrew (he) · Hindi (hi) · Hungarian (hu) · Indonesian (id) · Italian (it) · Japanese (ja) · Korean (ko) · Latvian (lv) · Lithuanian (lt) · Malay (ms) · Norwegian (no) · Persian (fa) · Polish (pl) · Portuguese (pt) · Romanian (ro) · Russian (ru) · Slovak (sk) · Slovenian (sl) · Spanish (es) · Swahili (sw) · Swedish (sv) · Thai (th) · Turkish (tr) · Ukrainian (uk) · Urdu (ur) · Vietnamese (vi)
The language is chosen in Settings → General and changes for everybody at once, no restart. To reword a text, edit its line in the file of your language; a key missing from it is taken from en.json. Help texts may keep GTA key tokens such as ~INPUT_CONTEXT~, which show the key the player actually uses.
Open Files#
Everything under config/, custom/, client/custom/, server/custom/ and locales/ is open to edit:
File | What you change there |
|---|---|
| Debug output, framework and inventory detection, the names of the two asset resources. |
| Discord webhook URLs and log options. Server only. |
| Loads the client bridge of your framework; |
| Loads the server bridge of your framework; sends notifications to one player. |
| Money, player name, society accounts and hunger and thirst for each framework (server.lua), and the player's data and balance (client.lua). The standalone wallet and its start money. |
| Item names, the room check, and giving, counting and taking items: tickets, stand items, prizes. |
| Hiding and bringing back the radar, the GTA HUD and your HUD resource. |
| qs-textui prompts and the labels over the vendors. |
| Every text of the script and its panels, one file per language. |
| Hints for code editors only. It is not loaded in game. |
Hooking the park into your own scripts? The exports and server events — a player boarded, a darts game ended, a day pass was bought — are listed in Commands and Events.



