Create and manage custom safe zones from a single admin panel. Draw polygon boundaries directly in-game, configure rules for each zone, and optionally display them on the map with custom blips.

Built for performance and production servers and compatible with ESX, QBCore, ox_core, and standalone setups.

---

Why Choose AlpySafeZones?

In-Game Zone Creation
Create zones directly in the world using a free camera. Place points with your mouse, undo mistakes instantly, and confirm the shape once at least three points are placed. Green walls visualize the zone boundaries during creation.

Complete Control Per Zone
Every zone can have its own rules. Disable PvP, vehicle damage, explosions, weapons, or punching. You can also enable a speed limit and define the maximum speed in km/h.

Custom Map Blips
Choose whether a zone appears on the map. When enabled you can configure the sprite, color, scale, and label so players can easily identify safe areas.

Central Admin Panel
Manage all zones from a single NUI interface. Create new zones, edit existing ones, enable or disable them, delete them, and search through the full list instantly.

Framework Friendly
Automatically detects ESX, QBCore, or ox_core. Permissions can be handled through framework groups or Ace permissions. Also works without any framework using Ace only.

Persistent and Automated
Zones are saved automatically using oxmysql. The database table is created automatically on first start so manual SQL setup is not required.

Discord Integration
Optional webhooks allow logging of zone creation, edits, player enter and exit events, and admin access. Custom bot name, avatar, and color are supported.

Multi-Language Support
Includes ten languages: English, German, French, Spanish, Italian, Dutch, Polish, Portuguese, Slovenian, and Turkish. Config and locale files remain editable.

---

Features Overview

Polygon Zone System
Create zones with any shape using three or more points. Boundaries are precise and optimized for performance.

Per-Zone Rule System
Each zone can independently control PvP, vehicle damage, explosions, weapons, punching, and speed limits.

Markers and Map Blips
Ground markers can be configured globally. Zones can optionally appear on the map with custom sprite, color, scale, and label.

Admin Management Interface
One menu for everything. View all zones, search instantly, create new ones, edit settings, toggle zones, or remove them.

Notification System
Player enter and exit notifications use ox_lib with built-in fallbacks.

Permission System
Server-side permission handling using ESX groups, QBCore groups, or Ace permissions.

Database Support
Uses oxmysql with automatic table creation on first startup.

Discord Logging
Supports up to three webhooks for zone management logs, player activity logs, and admin access logs.

Localization
Ten languages included. Locale and configuration files are not encrypted.

---

Requirements

ox_lib
Required for notifications and shared initialization.

oxmysql
Required for zone persistence and automatic database table creation.

PolyZone
Optional. The resource already includes built-in polygon logic.

Compatible with ESX, QBCore, ox_core, or standalone servers using Ace permissions.

---

Installation

Install ox_lib and oxmysql.

Ensure both resources load before AlpySafeZones in your server.cfg.

Configure admin access in server/server.config.lua using AllowedGroups or Ace permissions.

Optionally configure Discord webhooks and global zone behavior in the server configuration.

Open the menu in-game using the /safezones command. The command can be changed in config.lua.

A full setup guide is included in the README file.

---

Creating a Zone

Open the admin menu with /safezones.

Select Create Zone.

Enter the zone name and configure permissions such as PvP, weapons, markers, notifications, and speed limits.

Under Map Blip Settings, choose whether the zone should appear on the map. If enabled, set the sprite, color, scale, and label.

Click Save & Draw Zone to start drawing.

Drawing controls
WASD moves the camera
R and F move up or down
Left mouse button places a point
Backspace removes the last point
Enter confirms the zone (minimum three points required)

Once confirmed, the zone is saved and becomes active immediately.