Check dependencies#
Install these before setting up 0r-activities:
- ox_lib — TextUI, notifications, progress, and editor clipboard support
- 0r-activities-assets — activity models, animations, and maps
- ox_target or qb-target — target interactions; choose one
- Your framework and a supported inventory — equipment, purchases, and paid rentals
Enable OneSync on the server. ESX, QBCore, or Qbox is the standard setup; see Configuration for provider selections.
Add the resource#
Place the resource in your server's resources folder as 0r-activities. Keep this name: inventory exports and image paths refer to it.
The interface ships in html/ and is ready to use. No frontend build or SQL import is needed.
Install inventory items#
| Inventory | Item definitions |
|---|---|
| ox_inventory | Copy the entries from install/ox_inventory.lua into ox_inventory/data/items.lua |
| QB inventory / framework items | Copy the entries from install/qb_items.lua into qb-core/shared/items.lua or your framework's equivalent item registry |
| Other supported inventories | Adapt the definitions to that inventory's item format and usable-item integration |
Copy the entries inside the returned table, not the whole file. The package contains 12 equipment items.
- OX entries already use images from
nui://0r-activities/items/images/and include the required server exports. - QB setups need the PNG files from
items/images/copied into the inventory's image folder. - Keep item keys exactly as supplied, including
palet_truckandrub_trolley.
Restart the inventory/framework after adding definitions, then restart 0r-activities.
Update server.cfg#
Example with QBCore, ox_inventory, and ox_target; replace the framework/inventory/target lines with your own providers:
ensure ox_lib
ensure qb-core
ensure ox_inventory
ensure ox_target
ensure 0r-activities-assets
ensure 0r-activities
For a QB inventory setup, use your inventory resource and qb-target instead. Start every selected integration and the assets before 0r-activities.
Configure integrations and prices#
Open config/main.lua and check framework.system, inventory.system, vehicleKeys.system, and target.system. Use an explicit provider if auto-detection selects the wrong resource.
Check config/item_shop.lua and rental configs before going live. Purchases and rental fees use currencyItem (default money), or the balloon's entryFee.item. This must be available through the selected inventory; it is separate from diving's framework payout account.
Set language to your server language. See Configuration for supported values and activity files.
Test in-game#
- Visit the item shop NPC near
-1665.22, -1048.89, 13.15at Del Perro Pier. - Use target to open the shop; preview and buy a skateboard with the configured currency.
- Use the skateboard from your inventory, ride it, then stow it using the displayed controls.
- Visit the roller coaster attendant nearby and start a solo ride.
- Invite a nearby player to an activity lobby and confirm they can accept and join.
If something fails, enable debug = true in config/main.lua, restart the resource, and check the server console and F8. See FAQ.