Admin Tools

Reference for commands, permissions, the settings editor, and progression management.

Commands

Everything lives under one command: /roadside. Typing /roadside in chat shows the available subcommands as suggestions; running it with no subcommand shows a usage hint.

CommandDescriptionPermission
/roadside settingsOpens the live settings editor — every job setting including tow yards and breakdown scenes, applied instantlyAdmins
/roadside tutorialsTurns the first-time hint pop-ups on or offNone (affects only the player themselves)
/roadside tutorialresetMakes all hint pop-ups show againNone (affects only the player themselves)

Key Bindings

KeyActionNotes
H (hold)Show a floating marker over the active job locationPlayers can rebind through GTA's Settings → Key Bindings → FiveM

The Settings Editor

/roadside settings opens a live editor covering every job setting — pay, timers, calls, the truck, blips, uniforms, tutorials, and more. Changes save to your database and apply instantly; nothing needs a restart. Each setting has a reset arrow that restores its factory default from the config files.

Editing tow yards and breakdown scenes

Tow yards, breakdown scenes, and the tow delivery point live in the Locations & Events group like any other setting — no separate tool:

  • Tow yards is a list of cards. Each yard has a name, the dispatcher's spot, his facing, and the truck spawn. Press Place (the crosshair button) on a position to set it in the world: the menu hides, a see-through preview of the dispatcher or truck follows your aim, the scroll wheel rotates it, left-click confirms, right-click or ESC cancels — then the menu comes back with the coordinates filled in. Placing the dispatcher also sets his facing.
  • Breakdown scenes works the same way. Each scene has a job type, a vehicle model, and a position — set the vehicle model first, and Place previews that exact car so you can drop it on the shoulder just right. The teleport button next to Place jumps you to an existing entry so you can check or re-place it.
  • Cards can be added, removed, and reordered. Nothing changes on the server until you press Save — then dispatcher NPCs and map blips move immediately and new calls draw from the updated scene list. The reset arrow restores the shipped defaults for the whole list.

Anyone working a shift keeps their current job when you save; only new calls use the new data.

The in-world Place preview requires an updated o-link.

Permission

The command uses your server's standard admin permission. On QBCore and QBX the stock server.cfg already grants it to your admin group. Otherwise add these two lines to server.cfg (replace the license with the admin's own):

server.cfg
add_principal identifier.license:YOUR_LICENSE_HERE group.admin
add_ace group.admin admin allow

The permission is checked on the server, so players can't bypass it.

Progression Management

Current progression lives in job_progression, not a per-resource table.

Use job = 'roadside' for this resource.

View progression

SELECT *
FROM job_progression
WHERE char_id = ?
  AND job = 'roadside';

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 = 'roadside';

Clear complaints

UPDATE job_progression
SET complaints = 0
WHERE char_id = ?
  AND job = 'roadside';

Clear timeout

UPDATE job_progression
SET timeout_until = NULL
WHERE char_id = ?
  AND job = 'roadside';

Set level manually

UPDATE job_progression
SET level = 3
WHERE char_id = ?
  AND job = 'roadside';

If the player is online when you run these queries, have them relog — the server keeps progression in memory while they're connected and would overwrite your change on their next save.

Notes

  • Shift payout is deposited when the player clocks out (bank account by default — Config.Payment.payoutAccount).
  • Destroyed vehicle fines are removed from cash immediately, not at clock-out.
  • Players who disconnect, get hospitalized, or are on shift during a server restart are paid automatically for the work they completed.

Next Steps