Admin & Developer Tools
Reference for commands, permissions, builder output, and progression management.
Reference for commands, permissions, builder output, and progression management.
Commands
| Command | Description | Permission |
|---|---|---|
/postalbuilder | Opens the builder UI | Admins |
/postaltutorials | Toggles tutorial prompts | None |
/postaltutorialreset | Clears tutorial seen-state | None |
Builder
/postalbuilder opens the in-game builder used to create depot locations, scan for props, and export config without hand-editing files.
Permission
/postalbuilder is limited to admins. The check runs on the server, so it can't be bypassed.
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, you don't need to do anything extra — your existing framework admins pass automatically. Players without permission see a "No permission" message.
Current builder workflow
Run /postalbuilder and choose New Location — captures your position as the depot coords.
Move to the van spawn point and choose Set Vehicle Spawn.
Move to each pallet pickup point and choose Add Pickup Point (at least 1 required).
Use Scan Post Boxes and Scan Letterboxes to find nearby GTA props. Select individual results or use Add All Remaining for batch add.
Move to each delivery address and choose Add Delivery Zone — label is auto-suggested from the GTA street name.
Use View Status to check progress and see what's missing.
Choose Finish Location when all required fields are set.
Choose Export All to write exported_locations.lua.
Export behavior
Exports are written to the resource root as exported_locations.lua and printed to the server console.
Copy the exported content into shared/config/locations.lua.
Builder coverage
The builder supports:
- depot location creation
- vehicle spawn capture
- pickup point capture
- delivery zone creation (with street-name auto-suggestion)
- post box scanning and batch add
- letterbox scanning and batch add (with auto-naming and min level prompts)
- import of current config for editing
- editing finished locations
- undo (up to 20 steps)
- prop attachment testing
- scan marker visualization and cleanup
Tutorial Commands
/postaltutorials
Toggles the local player's tutorial system on or off.
/postaltutorialreset
Clears the local player's tutorial progress so all 9 prompts can show again.
Progression Management
Current progression lives in job_progression, not a per-resource table.
Use job = 'postal' for this resource.
View progression
SELECT *
FROM job_progression
WHERE char_id = ?
AND job = 'postal';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 = 'postal';Clear complaints
UPDATE job_progression
SET complaints = 0
WHERE char_id = ?
AND job = 'postal';Clear timeout
UPDATE job_progression
SET timeout_until = NULL
WHERE char_id = ?
AND job = 'postal';Set level manually
UPDATE job_progression
SET level = 3
WHERE char_id = ?
AND job = 'postal';Notes
- Shift payout is deposited to
Config.Payment.payoutAccount(default'bank') on shift finalization througho-link.money. - Vehicle destroy fines are removed from
Config.Payment.fineAccount(default'cash') immediately when the van is lost. - Builder access uses the standard framework admin check (via
o-link) on the server side.