Props, custom vehicles, animations, or tracks are missing
Install and start 0r-activities-assets before 0r-activities. Check that OneSync is enabled and that the assets start without errors. Activity placement must match the map being used.
Target interactions or activity menus do not appear
- Start ox_lib and ox_target or qb-target before the activity resource.
- With
interaction = 'target', settarget.systemto'ox'or'qb'if auto picks the wrong provider. - Check the activity's
enabled, NPC coordinates, and interaction distance. - The water slide has a separate
interactionoption in its own config.
Equipment cannot be bought or used
Add the supplied inventory definitions, then restart the inventory/framework and 0r-activities. OX items need their server.export fields and consume = 0.
Check inventory.system and make sure the chosen inventory is running. Non-OX usable-item registration needs a compatible framework or a custom usable-item integration. Keep exact item names, including palet_truck.
Item icons are missing
QB setups need images copied from items/images/ to the inventory image folder. OX definitions already refer to nui://0r-activities/items/images/; keep the resource folder named 0r-activities.
I have cash but the shop or rental says I cannot pay
Shop and rental fees use the inventory bridge and default to money. A QB cash account is not automatically the same thing as an inventory currency item.
Configure currencyItem (or balloon entryFee.item) for your inventory's currency. Diving's rewards.account controls payouts separately.
Water equipment refuses to deploy or disappears on land
By default, players must be in water with at least 0.30 m depth. Check config/water_activities.lua → itemUse.
Land cleanup stows boards after 5 seconds on land. Change landCleanup there if needed. Rentals also end when time or distance limits are exceeded.
An equipment item is missing while I am riding it
Deployed equipment is temporarily held by the resource and returned when stowed. Keep free inventory capacity for its return.
If the return fails, check inventory errors and item definitions. The resource tracks pending returns and attempts recovery on supported player/character lifecycle events and resource startup.
Invites fail or the group cannot start
Players must be alive, on foot, available, and near the activity attendant. The default selection radius is 8 m, but the activity's own entrance radius also applies.
Invitations expire after 20 seconds. Check capacity, minimum group size, and driver selection. Every member must still be nearby when the host starts; solo options are separate from most group lobbies.
A boat or balloon fails to spawn
Clear players and vehicles from the configured spawn positions. Check the assets and model names. Boat locations are in config/water_activities.lua; balloons have balloon.spawnLocations; diving uses its own locations[].boatSpawns.
Diving treasure gives no money
Finds are trip cargo. Return the boat to the configured delivery point during the return phase, before the trip expires, with a trip member driving.
Built-in payouts use Qbox, QBCore, or ESX. Check rewards.account, or configure a custom payout export. Each player's cargo value is paid separately; collecting treasure alone does not trigger payment.
Races reset me or end unexpectedly
Follow checkpoints in order and stay within the track limits. Check trackExitDistance, raceTimeout, and route alignment. Resetting adds the configured time penalty (default 5 seconds).
When editing capacity, provide enough valid grid/paddock positions. See Configuration.
Location editor commands do not work or changes disappear
Run /bungeenew, /ziplinenew, and /aquanew in game with permissions allowed by editorPermissions in config/main.lua.
Editors copy output to the clipboard and F8; they do not save files. Paste the output into the matching config, save, and run restart 0r-activities.
How do I change the language or enable debug logs?
Set language in config/main.lua; edit the corresponding JSON in locales/ without removing keys or format placeholders.
Set global debug = true for all logs, or an activity's debug = true for focused diagnostics. Check both F8 and the server console, then disable debugging after troubleshooting.