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

CommandDescriptionPermission
/animalcontrolbuilderOpens the builder UIAdmin (group.admin)
/animalcontroltutorialsToggles tutorial promptsNone
/animalcontroltutorialresetClears tutorial seen-stateNone

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:

server.cfg
add_principal identifier.license:<their-license> group.admin
add_ace group.admin admin allow

If 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.lua
  • exported_events.lua

They are also printed to the server console.

Typical usage is to copy the exported content into:

  • shared/config/locations.lua
  • shared/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.

Next Steps