Introduction

ARS SafeZone (v1.1.0) is a advanced safe zone management system for FiveM servers. It allows administrators to create custom-shaped polygon safe zones with granular control over zone behavior, including weapon restrictions, vehicle damage prevention, speed limits, and custom entry/exit messages.

Features

Core Features

• Polygon-based Safe Zones: Create custom-shaped safe zones using multiple vertices
• Weapon Restrictions: Disable all weapons with whitelist support for specific weapons and job weapons
• Vehicle Damage Prevention: Protect vehicles from damage inside zones
• Vehicle Speed Limits: Set and enforce maximum vehicle speeds within zones
• Player Invisibility: Make players invisible inside specific zones
• Real-time Zone Management: Create, update, and delete zones without server restart
• Custom Messages: Configure unique entry and exit notifications for each zone

Admin Features

• In-Game Zone Creation: Create safe zones directly from the game using an interactive 3D editor
• Multiple Admin Permission Methods: Configure admin access through groups, licenses, or identifiers
• Zone Settings Menu: Modify zone options on-the-fly with an intuitive UI
• No-Clip Mode: Built-in no-clip for precise zone placement

Integrations

• ESX: Full support for ESX framework
• QBCore: Full support for QBCore framework
• ox_lib: Powered by ox_lib for zones and UI components
• oxmysql: Database operations through oxmysql

Requirements

• ox_lib - Required for zone management and UI components
• oxmysql - Required for database operations
• es_extended or qb-core - One framework must be installed

Commands

Admin Commands

• /<createsafezone> - Create a new safe zone using the 3D zone editor
• /<deletesafezone> - Delete the safe zone you are currently standing in
• /<zonesetting> - Open the settings menu for the safe zone you are in

See the Administrator Guide for detailed command usage and zone management.

Player Information

Players will encounter safe zones with various restrictions when moving around the server. Safe zones can:

• Remove weapons and prevent firing
• Protect vehicles from damage
• Limit vehicle speeds
• Make players invincible
• Display custom entry and exit messages

See the Player Guide for information about what players experience when entering and leaving safe zones.

Database Tables

ars_safezone

Stores safe zone configurations including zone geometry (polygon points) and options.

• name (VARCHAR, PRIMARY KEY): Unique zone identifier
• label (VARCHAR, 50): Zone display name
• zone (LONGTEXT): JSON-encoded polygon zone data (points, thickness)
• options (LONGTEXT): JSON-encoded zone options (weapon restrictions, speed limits, messages)

---

Note: This guide is written by a third party. If you find any incorrect or outdated information, please contact us on Discord so we can update it for you.