Troubleshooting

#No NPC spawning

• Confirm Config.NPC.coords is a valid vector4.
• Make sure the resource started after its dependencies in server.cfg.
• Check the model name is correct and streamed.

#Missing images in the menu

The folder must be named exactly 5code-loadouts. Rename it back if you changed it.

#Deploy fails silently

• Verify the items in the loadout exist as registered inventory items.
• Confirm the officer has enough money in their bank (not cash) for the deposit.

#Database errors on start

• Make sure oxmysql is started before 5CODE Loadouts.
• Confirm your oxmysql connection string is correct.

#Stuck deployment

If a deployment cannot be closed normally, an admin can run:

/loadouts:forceclose <citizenid> [refund|penalty|none]

#Wrong framework detected

If auto-detection picks the wrong framework, pin it:

Config.Framework = 'qb-core' -- or 'qbx_core' / 'esx'

#No notifications on ESX

Set Config.NotifySystem to either 'esx' or 'ox_lib'. The default may not match your server.