In-Game Management Tools

BS Road Maintenance Multiplayer Job includes three powerful administrative suites that allow server staff to configure work areas, place tasks with an interactive 3D gizmo, visualize work zones on the map, and manage server-wide bonus multiplier events entirely in-game with zero server downtime.

🛠️ Area & Task Manager (/roadtaskmanager)

The Area & Task Manager is a comprehensive tool that allows administrators to create new municipal maintenance zones, manage task lists, teleport to work spots, and place minigames using an interactive 3D Task Creator.

Command Requirement: Requires the roadmaintenancejob.admin ACE permission (configured via serverConfig.adminPermission, default group.admin).

1. Main Menu Overview

Typing /roadtaskmanager in the chat or F8 console opens the main management context menu:

• Create New Area: Prompts for a unique area identifier (e.g., Strawberry_Avenue, Paleto_Highway) and records the administrator ped's current coordinates as the initial geographic center point.
• Existing Areas List: Displays every registered area from data/areas.json alongside its total registered task count.

2. Managing an Existing Area

Selecting any area from the menu provides the following administrative actions:

3. Adding Tasks with the 3D Visual Task Creator

When you select Add Task via Creator, choose one of the 8 available task types:

1. replace_sign (Road sign replacement)
2. paint_lines (Road lane repainting)
3. repair_traffic_light (Traffic signal electrical junction box)
4. clean_oil (Oil slick surface cleanup)
5. clean_graffiti (Wall graffiti removal)
6. clear_rocks (Rockslide debris clearing)
7. scan_road (Road sensor survey point)
8. scan_bridge (Bridge structural diagnostic tester)

Upon selection, the script launches the 3D Task Creator:

Phase 1: Raycast Placement

Move your mouse across terrain, roadways, or walls:

• C: Toggle Surface Snap (On / Off). When enabled, props automatically align their angle perpendicular to walls and road inclines.
• Mouse Wheel: Rotate object heading.
• Shift: Fast cursor speed modifier.
• Ctrl: Slow precision cursor speed modifier.
• Space: Advance to Phase 2 (Manual Fine-Tuning).
• Backspace: Cancel task creation.

Phase 2: Manual 3D Gizmo Fine-Tuning

A 3D coordinate gizmo appears over the prop with orbit camera controls:

• WASD: Move object along the horizontal plane (X and Y axes).
• E / Q: Move object Up or Down (Z-axis).
• RMB (Hold): Orbit and rotate the inspection camera around the object.
• Mouse Wheel: Zoom camera distance in or out.
• LMB (Drag): Grab gizmo axis handles or rotate object.
• G: Place on Ground — automatically casts a downward ray to snap the prop cleanly onto the pavement surface.
• Space: Save and Exit — saves the task coordinates and updates data/areas.json.

⚠️ 150-Meter Radius Rule: Tasks must be located within 150 meters of the area's center point. If a task is placed beyond 150m, the creator notifies you and requests placement closer to the area cluster.

💰 Bonus Manager (/roadbonusmanager)

The Bonus Manager lets administrators run promotional multiplier events (e.g. Double XP Weekends, +50% Payout Holidays) on the fly without restarting the server or editing config files.

Command Requirement: Requires the roadmaintenancejob.admin ACE permission (configured via serverConfig.adminPermission, default group.admin).

1. Instant Bonus

Activate a global payout and XP bonus that starts immediately:

1. Select Instant Bonus in the menu.
2. Percentage: Enter the bonus percentage (e.g. 50 for a +50% boost).
3. Duration: Enter the duration in minutes (e.g. 120 for 2 hours).
4. The bonus is instantly saved to the bs_roadmaintenance_bonuses table and broadcasted in real time to all connected players (globalBonusMultiplier).

TIP: To immediately deactivate all running instant bonuses, enter 0 as the percentage.

2. Scheduled Bonus

Plan ahead for scheduled weekend or holiday community events:

1. Select Schedule Bonus.
2. Percentage: Enter bonus percentage (e.g. 100 for 2x payouts).
3. Start Date & Time: Pick the start date (YYYY-MM-DD) and start time in 24-hour format (HH:MM).
4. End Date & Time: Pick the expiration date and time.
5. A server-side background thread checks active bonuses every 30 seconds. When the current server clock reaches start_time, the multiplier automatically activates across the server. Once end_time passes, it cleanly deactivates.

3. View Active & Scheduled Bonuses

• Review all ongoing and planned bonuses.
• Each entry displays its status:
  • ACTIVE (Currently boosting payouts)
  • SCHEDULED (Pending future activation)
  • EXPIRED (Completed)
• Select any active or scheduled bonus to cancel it immediately with one click.