Admin & Developer Tools
Commands, admin permissions, builder usage, and progression SQL examples for oxide-animalcontroljob.
Reference for commands, permissions, builder output, and progression management.
Commands
| Command | Description | Permission |
|---|---|---|
/animalcontrolbuilder | Opens the builder UI | Admin (group.admin) |
/animalcontroltutorials | Toggles tutorial prompts | None |
/animalcontroltutorialreset | Clears tutorial seen-state | None |
Builder
/animalcontrolbuilder opens the in-game builder used to create office locations and event sets without hand-editing config files.
Permission
This command is restricted to admins. To make someone an admin, add them to the admin group and grant that group the admin ace in your server.cfg:
add_principal identifier.license:<their-license> group.admin
add_ace group.admin admin allowIf you already run QBCore, QBX, or ESX admins, they pass automatically — no extra setup is needed.
Current builder workflow
Create an office location.
Set the vehicle spawn.
Finish the location.
Add event points for each job type.
Set the shelter delivery point.
Export the result.
Export behavior
Current exports are written to the resource root as:
exported_locations.luaexported_events.lua
They are also printed to the server console.
Typical usage is to copy the exported content into:
shared/config/locations.luashared/config/events.lua
Builder coverage
The builder supports:
- office location creation
- vehicle spawn capture
- per-type event creation for aggressive, stray, wildlife, and deceased jobs
- shelter delivery point capture
- import of current config
- event editing and deletion
- undo
- vehicle preview testing
- 3D marker previews
Tutorial Commands
/animalcontroltutorials
Toggles the local player's tutorial system on or off.
/animalcontroltutorialreset
Clears the local player's tutorial progress so all prompts can show again.
Progression Management
Current progression lives in job_progression, not a per-resource table.
Use job = 'animalcontrol' for this resource.
View progression
SELECT *
FROM job_progression
WHERE char_id = ?
AND job = 'animalcontrol';Reset progression
UPDATE job_progression
SET level = 1,
total_count = 0,
daily_streak = 0,
last_activity_date = NULL,
complaints = 0,
timeout_until = NULL
WHERE char_id = ?
AND job = 'animalcontrol';Clear complaints
UPDATE job_progression
SET complaints = 0
WHERE char_id = ?
AND job = 'animalcontrol';Clear timeout
UPDATE job_progression
SET timeout_until = NULL
WHERE char_id = ?
AND job = 'animalcontrol';Set level manually
UPDATE job_progression
SET level = 3
WHERE char_id = ?
AND job = 'animalcontrol';Notes
- Shift pay is deposited when the shift ends, into the account set in
Config.Payment.payoutAccount(bank by default). - Destroyed-truck fines and animal-kill fines are charged immediately, from the account set in
Config.Payment.fineAccount(cash by default). - The builder permission check happens on the server, so players cannot bypass it.