Skip to main content
Use this page to diagnose the most common setup and integration problems.
Add the correct license or Discord identifier to Config.Owners in editable/server.lua. Restart yb-admin after changing bootstrap owners. If you use ACE, verify the principal is yb-admin.group.<groupname>.
Select Go On Duty first. Confirm the assigned group contains admin.open and the permission required by the selected action.
FiveM loads web/dist, not web/src. Rebuild the production interface after frontend changes:
Restart yb-admin after the build completes.
Set Config.Framework to qbox, qb, or esx. Update Config.FrameworkResources if the resource was renamed. Start the framework before yb-admin.
Start oxmysql before yb-admin and verify the database connection. No SQL import is required. Reports and panel logs are intentionally cleared on resource start when their clearOnResourceStart option is enabled.
Set a valid URL in editable/server/webhooks.lua. Confirm Config.DiscordLogs.enabled is true and the category has a URL or a valid default fallback. Report evidence uses the screenshots route.
Start screencapture or screenshot-basic before YB Admin. Match the resource names in Config.Screenshot.resources. Use provider = 'auto' for automatic selection. Video evidence requires screencapture.
Confirm both players are online and can reach external signaling services. Check firewalls and restrictive networks. Lower capture width, height, frame rate, or bitrate on weak connections. The viewer also needs admin.monitoring.view.
Ensure every client uses the same current resource build. Do not mix an older web/dist with newer Lua files. Restart the resource and reconnect affected clients after updating.
Start qbx_properties and ox_inventory, then set:
Saved records must use qbx_properties_<property_name> as the inventory name and the citizen ID as owner. Restart YB Admin to clear its economy cache.
Start a supported inventory, verify the spawn code exists, and check the player’s weight and free slots. The target must be online. The staff member needs admin.items.view and admin.items.give.
Start the configured weather resource and verify the adapter export names in editable/server.lua. Renewed-Weathersync and qb-weathersync presets are included. Keep nativeFallback = true when no adapter is used.
The target may be listed in Config.ProtectedResources. Only owners can bypass protection when Config.AllowOwnerProtectedResourceActions is true.
Enable OneSync and grant admin.monitoring.view. Check that the tile URL is reachable from FiveM. Adjust the selected projection and calibration values in Config.Monitoring.map when blips are offset.
Keep recordings below Config.StaffChat.maxVoiceSeconds and maxVoiceBytes. Confirm FiveM can access the microphone and every staff member is using the same rebuilt interface.
Keep debug mode disabled during normal use. Avoid aggressive scanner intervals, reduce scanner radius and result limits, and close developer tools when they are not needed.

​
Collect diagnostics