# Troubleshooting

### UI does not open at the entry marker

* Check `Config.Entry.coords` and `radius`
* Ensure you are pressing **E**
* Ensure `ui_page` files are present and the resource started without NUI errors

### Weapons / loadouts not applying

* If `Config.UseOxInventory = true`:
  * ensure `ox_inventory` is started
  * check your loadout items/weapons are valid
* If `Config.UseOxInventory = false`:
  * Wargames gives weapons natively on client; ensure weapon names are correct

### Inventory is not restored on leave

* Inventory snapshot/restore requires:
  * `Config.SafeInventory.enabled = true`
  * `ox_inventory` started
* Check blacklist: items listed in `Config.SafeInventory.blacklist` are intentionally not restored.

### Outfit swapping not working

* Enable `Config.ClothingSystem.enabled`
* Set correct provider:
  * `illenium`, `esx_skin`, `0resmon`, `fivem-appearance`
* Ensure the corresponding resource is started.
* Use `Config.ClothingSystem.debug = true` and check server/client console logs.

### Revive issues / player stuck dead

* Set `Config.Ambulance.provider` explicitly (avoid auto conflicts).
* If you have multiple ambulance resources, stop the unused ones.
* Fallback revive event: `wg:client:instantRevive` should still work.

### Killfeed not showing

* Ensure `Config.KillFeed.enable = true`
* If mode is `lobby`, killfeed requires both players in the same bucket
* Check that `html/killfeed` files exist and are listed in `fxmanifest.lua`

### Leaderboard is empty

* Make sure you imported `db.sql`
* Confirm `oxmysql` connection is working
* The leaderboard query filters out empty players (kills/wins > 0), so fresh servers show nothing until matches are played.
