Troubleshooting Guide

Find quick answers and solutions to common installation, permission, vehicle, and configuration issues below.

1. /roadtaskmanager or /roadbonusmanager Gives "No Permission" or Console Error

🔴 Symptom:

When running /roadtaskmanager, or /roadbonusmanager, the chat reports "You do not have permissions to use the Area Manager" / "Access Denied", or the server console displays:

Execution of add_ace denied for resource bs-roadmaintenancejob

🟢 Cause:

1. FiveM's engine blocks resources from registering or modifying ACE permissions from script code unless granted permission in server.cfg.
2. The user executing the command is not part of the ACE group defined in config/sv_config.lua (adminPermission).

🔧 Solution:

1. Open your server.cfg and add the following permission grant above ensure bs-roadmaintenancejob:

   add_ace resource.bs-roadmaintenancejob command.add_ace allow
2. If you use a different group name (e.g. group.superadmin or group.god), update adminPermission in config/sv_config.lua:

   adminPermission = 'group.superadmin',

2. Service Vehicles Fail to Spawn at Headquarters

🔴 Symptom:

The crew leader starts the route, but no vehicle appears in the parking lot, or the chat reports a vehicle spawn failure.

🟢 Cause:

The parking bays defined in base.vehicles.spawnCoords are currently blocked by parked player cars, props, or nearby network entities. The script checks each coordinate against job.spawnClearRadius (default: 2.5m) to prevent vehicle clipping and destruction.

🔧 Solution:

1. Ensure the parking bays at the docks base (880.5, -2437.72, 27.13) are completely clear of obstructions.
2. In config/sh_config.lua, add more backup coordinates to base.vehicles.spawnCoords so the server has more alternative bays to choose from:

   spawnCoords = {
     vec4(880.5, -2437.72, 27.13, 358.18),
     vec4(876.96, -2437.66, 27.28, 358.55),
     vec4(873.21, -2437.61, 27.24, 359.94),
     vec4(869.62, -2437.6, 27.13, 0.83),
     -- Add additional bays here if running a high-population server
   },

3. Target Interaction (ox_target / qb-target) Missing on Supervisor NPC

🔴 Symptom:

Approaching the base NPC with your target eye (Alt or Right Click) does not display any interaction eye or options.

🟢 Cause:

1. The interaction setting in config/sh_config.lua does not match the active target resource running on your server.
2. If jobName is set to a whitelisted string (e.g. 'roadmaintenance'), your character does not have that specific job assigned.

🔧 Solution:

1. Verify interaction in config/sh_config.lua:

   interaction = 'ox_target', -- Or 'qb-target'
2. If testing in development without the framework job assigned, temporarily set:

   jobName = false,

4. "You Are Moving Too Fast! Task Completion Denied"

🔴 Symptom:

During a physical task (e.g. repainting lines, sweeping oil, or unscrewing sign bolts), the notification displays "You are moving too fast! Task completion denied."

🟢 Cause:

The script includes built-in anti-exploit protection that prevents players from completing stationary tasks while running, sprinting, or being driven by third-party vehicles.

🔧 Solution:

Stand still while performing stationary minigames. Only the in-vehicle scan_road task permits and requires vehicle movement.

5. Daily or Weekly Quests Not Resetting or Tracking

🔴 Symptom:

Quest objectives do not increment when completing tasks, or daily quests do not reset at midnight.

🟢 Cause:

The bs_roadmaintenance_playerquests database table was not created or oxmysql failed to execute migration queries upon boot.

🔧 Solution:

1. Open your database client (HeidiSQL, phpMyAdmin) and verify that bs_roadmaintenance_playerquests, bs_roadmaintenance_playerdata, and bs_roadmaintenance_bonuses exist.
2. If missing, manually execute roadmaintenancejob.sql in your database.
3. Check the server console for any oxmysql connection pool errors.

6. Job Tablet (F7) Does Not Open

🔴 Symptom:

Pressing F7 does nothing and the NUI tablet does not appear on screen.

🟢 Cause:

1. jobName is restricted and the player does not have the road maintenance job.
2. The player has rebound F7 in their FiveM keybindings to another resource.

🔧 Solution:

1. Check your FiveM Settings > Key Bindings > FiveM > Open Job Dashboard to ensure the key is mapped correctly.
2. Interact directly with the supervisor ped at the headquarters (vec4(864.89, -2429.71, 27.13, 171.74)) to trigger the dashboard via third-eye interaction.