Editable settings live under config/. Most files merge these settings with defaults in shared/settings/; use the public config files for normal server setup. Save changes and run restart 0r-activities.
Main setup (config/main.lua)#
| Option | Default | What it does |
|---|---|---|
language | 'en' | Menu, hints, and notification language |
debug | false | true enables all activity logs; otherwise individual activity debug flags apply |
framework.system | 'auto' | Framework selection |
inventory.system | 'auto' | Inventory used for items, shop purchases, and fees |
vehicleKeys.system | 'auto' | Keys for activity vehicles |
interaction | 'target' | Target interactions or text prompts ('textui') where supported |
target.system | 'auto' | 'ox' for ox_target, 'qb' for qb-target |
target.distance | 2.5 | Default target interaction distance |
textUi.position | 'left-center' | ox_lib TextUI position |
notification.system | 'auto' | 'ox', 'qb', or 'esx' notifications |
notification.durationMilliseconds | 4500 | Default notification duration |
notification.position | 'top-right' | Position for backends that support it |
multiplayer.selectionRadius | 8.0 | Nearby-player selection distance in metres |
multiplayer.invitationMilliseconds | 20000 | Invitation expiry |
raceDrift.enabled | true | Race drift assistance |
towPhysics.enabled | true | Rope motion for towed boards, floats, and parasailers |
Keep a target installed for the default setup and equipment interactions. The water slide has its own interaction setting in config/water_slide.lua.
Providers#
Framework values: auto, qbx, qb, esx, ox, nd, none.
Auto priority: qbx_core → qb-core → es_extended → ox_core → ND_Core. Detection does not give every framework the same integrations: built-in framework inventory fallback and diving payouts cover Qbox, QBCore, and ESX.
Inventory values: auto, framework, none, or a supported resource:
tgiann-inventory, qs-inventory, origen_inventory, ox_inventory, codem-inventory, core_inventory, ps-inventory, qb-inventory, one_inventory, jpr-inventory.
Auto checks these inventories in the listed order, then falls back to the selected Qbox/QB/ESX inventory. Explicit selection uses only that provider. Read/write support does not replace your inventory's item definitions or usable-item setup.
Vehicle key values: auto, none, or:
qbx_vehiclekeys, qb-vehiclekeys, qs-vehiclekeys, Renewed-Vehiclekeys, MrNewbVehicleKeys, wasabi_carlock, mk_vehiclekeys, mVehicle, t1ger_keys, F_RealCarKeysSystem, jaksams_VehiclesKeys, cd_garage, okokGarage.
Auto uses the first running provider in this list. Manual selection never switches key systems.
Notifications: auto tries ox_lib, QB-Core, then ESX. An unavailable manual notification selection falls back to another running backend. title = false uses the translated default title; a string overrides it.
Languages#
Supported language values: en, tr, de, es, fr, it, nl, pl, pt-br, ru. Unknown language values fall back to English.
Edit the matching JSON file in locales/ to change wording. Keep every English key and preserve format placeholders such as %s and %d.
Activity files#
File under config/ | Main settings |
|---|---|
roller_coaster.lua | Enable, entry NPC, queue time, laps, seats, group size, exits |
ferris.lua | Enable, wheel base, boarding NPC, rotation speed, cabin/group capacity |
hammer.lua | Drop tower position, NPC, queue time, capacity, height, duration |
cable_car.lua | Enable, travel speed, departure countdown, ordered route points |
balloon.lua | NPC, launch positions, entry fee, capacity, flight area, altitude, duration |
skydive.lua | Entry NPCs, landing targets, player limit, flight/landing times, atmosphere |
bungee.lua | NPCs, return points, platforms, platform models, fall range |
zipline.lua | Route endpoints, second-lane offset, ride time, speed multiplier |
races.lua | Shared entrance and Formula 1 / Skart Race vehicle, grid, laps, limits |
gokart.lua | Go-Kart entrance, vehicle, grid, checkpoints, laps, limits |
race_preview.lua | Lobby preview speed, car spacing, starting position, settle time |
water_activities.lua | Shared boat NPC/spawns, water depth, land cleanup, boat preview |
surf.lua | Surf/paddle items, speed, boost, jump force, boat rental settings |
canoe.lua | Inventory item key, paddling speed, passenger join radius |
pool_floats.lua | Float models/seats, rental fees, duration, distance limits |
parasailing.lua | Price, boat, duration, player limit, flight height and slots |
hydrofly.lua | Price, NPC, spawn/exit, time limit, flight height/speed |
diving.lua | Boat spawns, search sites, loot, payouts, outfits, trip limit |
shark_cage.lua | NPC, cage/boat locations, player limit, duration, feeding, outfits |
water_slide.lua | Slide placement, water level, lanes, price, camera, exit boost |
ground_gear.lua | Roller skate / skateboard / hoverboard speed and jump strength |
utility_vehicles.lua | Cart item presets, normal/sprint speeds, target distance |
item_shop.lua | Shop NPC, currency, products/prices, quantity limit, preview routes |
vector3(x, y, z) sets a position; vector4(x, y, z, heading) also sets direction. Speeds marked in config are m/s; *Milliseconds, raceTimeout, and resetPenalty use milliseconds.
Routes and race limits#
Track files: config/routes/formula1_route.lua, config/routes/skart_race_route.lua, and config/routes/roller_coaster_track.lua. Go-Kart checkpoints are directly in config/gokart.lua.
For races, edit laps, countdownSeconds, raceTimeout, maxSpeed, ghostMode, and resetPenalty. Keep grids and paddock positions sufficient for the selected capacity, with checkpoints aligned to the map. Changing a route does not move the physical track supplied by the assets.
Use enabled = false in activity configs that expose it to disable that activity. Equipment-only configs instead define available item presets and movement settings.
Economy#
| Setting | Purpose |
|---|---|
item_shop.lua → products[].price | Equipment purchase price |
item_shop.lua → maximumQuantity | Purchase quantity limit (default 5) |
Rental currencyItem / balloon entryFee.item | Currency checked and removed through the inventory bridge |
diving.lua → loot[].unitPrice | Payout per recovered loot unit |
diving.lua → loot[].weight | Relative chance of selecting that loot type |
diving.lua → rewards.account | Framework payout account (default 'cash') |
diving.lua → rewards.customResource / customExport | Custom payout integration |
Default rental fees: boat surfing 750, parasailing 1,000, hydrofly 500, balloon 1,000, duck/flamingo/unicorn floats 500, sausage float 800. The water slide is free (price = 0).
Fees default to inventory currency money. They do not automatically charge a QB bank/cash account; use a currency your inventory supports. Diving payouts use the framework money bridge separately. See Exports & Events for custom payouts.
Admin location editors#
| Command | Workflow | Paste output into |
|---|---|---|
/bungeenew | Stand at the NPC position and face its direction. Enter confirms the NPC; adjust the platform and press Enter again. Tab changes the model; F cancels. | config/bungee.lua → locations |
/ziplinenew | Adjust the first post pair and press Enter. Walk to the other endpoint and press Enter; adjust the second pair and confirm again. Backspace cancels. | config/zipline.lua → locations |
/aquanew | Adjust the slide and press Enter. Backspace cancels. | config/water_slide.lua → coords, waterLevel |
Bungee: arrows move, Page Up/Down change height, Q/E rotate. Zipline/slide: arrows move, mouse wheel or Page Up/Down change height, Q/E rotate, Shift gives finer adjustments.
Editors copy output to the clipboard and print it in F8. They do not save config files. Paste the output, save, then restart the resource.
Access is configured in config/main.lua → editorPermissions. Disable all editors with enabled = false, or disable individual entries under commands. Framework permission checks accept configured QB/Qbox permissions or ESX groups; useFrameworkPermissions = false restricts access to ACE checks.
Example ACE rules for an existing admin group:
add_ace group.admin command.bungeenew allow
add_ace group.admin command.ziplinenew allow
add_ace group.admin command.aquanew allow
These commands must be run in game by an authorized player.