Troubleshooting

The creator won't open

• You're not an allowed admin. With Config.AdminOnly = true, you must satisfy the admin gate — hold the ACE (add_ace group.admin bupa.safezone allow), be in a Config.AdminGroups group, or pass your Config.CustomAdmin check. See Installation.
• Check the command matches Config.Command (default safezone). If you set Config.OpenKey, rebind it under the game's keybind settings if it clashes.
• ox_lib must be started before the resource.

Zones aren't saving

• Storage misconfigured — if Config.Storage = 'db', make sure oxmysql is running; the bupa_safezones table is created automatically on start.
• Limits hit — a save is rejected if it exceeds Config.Limits (e.g. maxZones = 100 total, maxPoints = 64 per zone). Fewer than 3 points is always rejected.
• Save cooldown — saving twice within Config.Limits.saveCooldown (default 1000 ms) silently drops the second save. Wait a moment.
• Not an admin — the save event re-checks admin permission server-side; a non-admin's save is ignored.

Rules aren't applying

• Rules only apply to the winning zone when areas overlap (the smallest/inner zone wins). Check you're standing in the zone you think you are.
• Combat tag — if you took or dealt player damage in the last combatLogLock seconds, you get no protection until the tag clears (the HUD shows "Combat tag"). This is intentional.
• Access denied — with jobWhitelist (or gangWhitelist) on and jobs listed, players outside the whitelist enter without protection.
• Economy rules (noDrop, noRob, noSell, noStash, noCarry, noCuff) are exposed via exports — your inventory / robbery scripts must call GetZoneFlag / CanDropItems etc. to honor them. This resource can't enforce them alone.

The HUD isn't showing

• The HUD is controlled per zone by the showHud rule — turn it on for that zone.
• Adjust its placement with Config.Hud.position (9 anchor points) and its title with Config.Hud.title.

No Discord logs

• Config.Webhook.url is empty — logging is disabled until you paste a valid webhook URL. See Discord Logging.

Text is in English / wrong language

• Set setr ox:locale "<code>" in server.cfg (e.g. tr). Missing keys always fall back to English. See Localization for supported codes.

Weapon picker has no icons

• The picker pulls icons from your inventory. Make sure a supported inventory (ox_inventory, qb-inventory, esx_inventory, tgiann-inventory, codem-inventory) is running, or override Config.Inventory / Config.InventoryImagePath.