FAQ & troubleshooting
Troubleshooting
Section titled “Troubleshooting”| Problem | What to check |
|---|---|
| The Ammu-Nation looks like the original game interior | sl_gunshop_mlo is not started, or starts after sl_gunshop, or another Ammu-Nation MLO is running. Restart the whole server |
| Nothing happens at the stores / red errors in the console | oxmysql and the framework must start before sl_gunshop. Read the first red line |
| “No weapon license” with the license | Your server keeps licenses elsewhere: adapt Framework.HasWeaponLicense in bridge/framework/ |
| A product is missing from the catalog | Its item doesn’t exist in your inventory (see Config.Products, give) |
| The weapon has no serial | qs-inventory and qb-inventory show it as info.serie; ox_inventory as serial |
| The range says it doesn’t work with this inventory | The range needs ox_inventory or qb-inventory |
| Boxes show names instead of pictures | Config.ItemImages: point it to your inventory’s picture folder |
| Products or furniture are invisible or pink | Restart the whole server and clear the client’s FiveM cache |
| Distant trees turn pink or hair looks low-poly after visiting a store | Too many objects at once for that PC: lower Config.Objects.maxProducts (and Config.AutoShops.fill) |
| “You need lockpick / stethoscope” | Create those items, or change item in Config.Robbery |
| Robbing is not possible | Config.Robbery.minPolice: not enough police on duty |
| The resource does not start and mentions escrow | The server key (sv_licenseKey) must belong to the Cfx account that bought the script |
Does it work with ESX and Qbox? Yes: QBCore, ESX Legacy and Qbox, detected automatically. ESX and Qbox need ox_inventory.
Can I use another Ammu-Nation MLO? No. The counters, the weapon wall, the range and the renovation rules are built for our interiors.
Can I add addon weapons? Yes: add a line to Config.Products with weapon = 'WEAPON_...' and its model.
Can I run it with SL-Shops? Yes. They are independent: each has its own stores, distributor and tables.
Can I turn the license off? Yes: Config.WeaponRequest.license = false.
Do I need an MDT? No. The registry works on its own (/slgun_serie and the exports); the MDT is a bonus.