Troubleshooting

Frequent tc-divisions errors: chests unavailable, access denied, vehicle keys, missing images.

#“Chests are unavailable”

Chests require an inventory that handles stashes: ox_inventory, qb-inventory, qs-inventory, or the native Vision inventory. With ESX's native inventory or in standalone they are unavailable (divisions, shops and garages work).

Also check Config.Bridge.Inventory and set Config.Bridge.Debug = true to see the detected inventory.

#`/divgestion` refused

Vision: you need one of the Config.Permissions, or your Discord ID in Config.AdminDiscords.
Outside Vision: add_ace group.admin command allow + your identifier in the group, or Config.Bridge.Admins (see General installation).

The list comes from the jobs / job_grades tables (Vision, ESX) or from shared jobs (QBCore / Qbox). Check that the framework starts before tc-divisions. In standalone, provide Config.Bridge.Standalone.listJobs.

#A player has no access to a chest / shop / garage

Check their access rules: job, minimum grade and ticked divisions (no division ticked = whole company).
If the division was deleted, the rule opens for nobody: edit the access.
With a code, the mode matters: Access AND code requires both; Access OR code lets authorised players in directly.
After Config.MaxAttempts wrong codes, the character is locked for Config.LockSeconds seconds.

#The vehicle spawns without keys

Keys go through the bridge. Set Config.Bridge.VehicleKeys: qb-vehiclekeys, qs-vehiclekeys, Renewed-Vehiclekeys, wasabi_carlock, or none. The key resource must be started.

#The vehicle does not spawn

There is no free spawn spot: the garage takes the first free one.
Large vehicle (truck, bus, ladder): it only spawns on spots flagged “large vehicle” (see Config.GarageLarge).
Limit reached: Config.GarageMaxOut.

#The roof number does not show

A compatible pack (onx or nk) is needed, and the vehicle must have been captured with “Roof: N digits”. Check the Config.Callsign.layouts layouts for your pack. The livery may take ~1 s to re-apply if the model had not finished loading.

#Item or vehicle images missing

Set Config.ItemImageBase (e.g. nui://ox_inventory/web/images/%s.png) and Config.VehicleImageFallback (e.g. https://my-cdn.example/vehicles/%s.webp). %s is replaced by the name. Without an image, an icon is shown.

#Outfits do not work

Config.Outfits.Enabled = 'auto' is only active on Vision. Elsewhere, set true only if your clothing resource can read the skin / sex metadata of the outfit item (see Installation).

#The panic button notifies nobody (outside Vision)

Check Config.Panic.Jobs, that colleagues are on duty (RequireDuty), and the CooldownSeconds delay.