Admin Tools

Commands Overview

Command	Description	Permission
/roadsidebuilder	Open the roadside job builder tool	admin.roadsidejob (ACE)
/roadsidetutorials	Toggle tutorial tooltips on/off	None
/roadsidetutorialreset	Reset all tutorial progress (re-show all tooltips)	None

---

Roadside Builder

The roadside builder is a context menu for creating tow yard locations and job events without editing config files directly. It provides real-time 3D marker previews, vehicle model testing, and Lua export.

Opening the Builder

/roadsidebuilder

Requires the admin.roadsidejob ACE permission. Opens a context menu with all builder tools.

Menu Options

Option	Description
New Tow Yard	Creates a new tow yard location at your current position via input dialog
Set Vehicle Spawn	Captures current position as the vehicle spawn point for the active location
Finish Location	Validates and saves the current location to the finished locations list
Add Fuel Help Event	Captures a fuel refuelling event at your current position with vehicle model input
Add Wheel Change Event	Captures a wheel change event at your current position with vehicle model input
Add Towing Event	Captures a towing event at your current position with vehicle model input
Add Battery Change Event	Captures a battery change event at your current position with vehicle model input
Set Tow Delivery Point	Captures current position as the shared delivery point for towing events
View Status	Shows current builder state: finished locations, active location, event counts by type, delivery point
Undo Last Action	Reverses the most recent action (up to 20 actions)
Import Current Config	Imports existing Config.Locations and Config.Events into the builder for editing
Edit Event	Opens a submenu to delete or reposition individual events
Export All	Serializes all locations and events to Lua and saves to files
Test Vehicle	Spawns a preview vehicle at your current position for testing placement

Workflow

1. Run /roadsidebuilder to open the menu
2. Click New Tow Yard and enter a name — this captures your position as the tow yard coords
3. Move to the vehicle spawn point and click Set Vehicle Spawn
4. Click Finish Location when the location is complete
5. Move to each event position and use the appropriate Add [Type] Event button
6. For towing events, set the shared delivery point via Set Tow Delivery Point
7. Use View Status to check progress
8. Click Export All to save all data to exported_locations.lua and exported_events.lua

3D Markers

While the builder is open, markers render in the world:

Color	Meaning
Green cylinder	Saved event position
Blue cylinder	Finished location
Cyan cylinder	Currently active (unsaved) location
Orange cylinder	Tow delivery point

Event markers display their type and vehicle model as 3D text within 30m.

Validation Rules

A location requires the following to be considered complete:

• Name (set on creation)
• Coords + heading (set on creation)
• Vehicle spawn (required)

Export Format

The export generates two files:

exported_locations.lua:

Config.Locations = {
    {
        name = 'location.tow_yard',
        coords = vector3(722.99, -1069.54, 23.06),
        heading = 88.4,
        vehicleSpawn = vec4(718.19, -1088.72, 22.35, 87.9),
    },
}

exported_events.lua:

Config.Events = {
    {
        type = JobType.FUEL_HELP,
        label = 'event.refuelling',
        missionTime = 420,
        vehicle = 'buffalo',
        coords = vec4(2941.62, 3782.37, 51.63, 349.1),
        fuelBone = 15,
        npcDriver = true,
    },
    {
        type = JobType.TOWING,
        label = 'event.towing',
        missionTime = 480,
        vehicle = 'weevil',
        coords = vec4(595.10, 225.08, 101.69, 272.2),
        npcDriver = false,
    },
}

Config.TowingDeliveryPoint = vector3(2422.18, 3131.47, 48.19)

Copy these into shared/config/locations.lua and shared/config/events.lua respectively.

---

Tutorial Commands

/roadsidetutorials

Toggles tutorial tooltips on or off for the local player. When disabled, no new tutorial tooltips will appear. Previously seen tutorials are not affected.

/roadsidetutorials

Output: "Tutorials enabled" or "Tutorials disabled"

/roadsidetutorialreset

Resets all tutorial progress, clearing the "seen" state for every tooltip. All tutorials will appear again as if the player has never seen them.

/roadsidetutorialreset

Output: "Tutorial progress reset"

Both commands require no permissions and affect only the local player's client-side KVP storage.

---

Permissions

ACE Permission Setup

The /roadsidebuilder command requires the admin.roadsidejob ACE permission. Add the following to your server.cfg:

add_ace group.admin admin.roadsidejob allow

Or for specific players:

add_principal identifier.license:xxxx group.admin

The tutorial commands (/roadsidetutorials and /roadsidetutorialreset) require no permissions.

---

Progression Management

Player progression is stored in the roadsideassistancejob_progression database table.

Reset a Player's Progression

UPDATE roadsideassistancejob_progression
SET level = 1, total_jobs = 0, daily_streak = 0, complaints = 0, timeout_until = NULL
WHERE char_id = ?;

Remove a Suspension

UPDATE roadsideassistancejob_progression SET timeout_until = NULL WHERE char_id = ?;

Clear Complaints

UPDATE roadsideassistancejob_progression SET complaints = 0 WHERE char_id = ?;

View a Player's Stats

SELECT * FROM roadsideassistancejob_progression WHERE char_id = ?;

Set a Player's Level

UPDATE roadsideassistancejob_progression SET level = 3 WHERE char_id = ?;