Skip to content

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

28 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

F5 Safezones



Version  Downloads  Stars  Discord



QBCore  QBox  ESX  Auto-detected



The most advanced open-source safezone system for FiveM.
Drop it in, ensure, and play. No config needed, no SQL, no Keymaster.


Read the Docs   ·   Join Discord   ·   Report a Bug



Why F5 Safezones?





Fly around and draw polygon or circle zones directly in-game. Place points, adjust radius, and preview markers without leaving the server.




Full NUI interface with an interactive map, zone management, player monitoring, audit logs, and debug tools. Comes with three map layers.




Vehicle and player ghosting, invincibility, explosion cancellation, weapon restrictions, and vehicle damage prevention. All configurable per zone.




Auto-detects your framework at startup. No SQL needed, no manual setup. All data is stored in JSON. Just drop it in and ensure.



Quick Start


cd resources/[f5]
git clone https://github.com/F5-Studio-FiveM/f5_safezones.git

Add to server.cfg:

ensure qb-core    # or qbx_core / es_extended
ensure f5_safezones

That's it. The default Legion Square safezone is ready. Open /szadmin in-game to manage zones.



At a Glance


Zone Types Circle  •  Polygon
Markers Cylinder  •  Circle Fat  •  Circle Skinny  •  Circle Arrow  •  Split Arrow  •  Dome
Animations Pulsing  •  Bobbing  •  Rotating  •  Color Shift
Protection Invincibility  •  Ghosting  •  Explosion Cancel  •  Weapon Block  •  Vehicle Damage Block
Frameworks QBCore  •  QBox Core  •  ESX (auto-detected via bridge)
Storage JSON files, no database required
Logging NDJSON audit logs with retention and admin tracking
Requirements Server Build 4752+  •  Game Build 2189+  •  Lua 5.4


Available Exports

Client

exports['f5_safezones']:IsPlayerInSafezone()
exports['f5_safezones']:GetCurrentSafezone()
exports['f5_safezones']:GetAllZones()
exports['f5_safezones']:IsPlayerInGhostMode()
exports['f5_safezones']:GetPlayersInCurrentZone()

Server

exports['f5_safezones']:IsPlayerInSafezone(source)
exports['f5_safezones']:GetPlayerSafezoneInfo(source)
exports['f5_safezones']:GetAllPlayersInSafezones()
exports['f5_safezones']:GetAllSafezones()
exports['f5_safezones']:GetPlayersInSpecificZone(zoneName)

See full API reference →

Admin Commands
Command Description
/szadmin Open the admin panel
/szdebug Toggle debug visualization
/szcoords Copy current coordinates
/sztoggle <zone> Toggle marker visibility
/listsafezones List all zones in console


Contributing


This project is open source and we'd love your help to make it better.

  • Report bugs by opening an issue
  • Suggest features or improvements via issues or Discord
  • Submit pull requests with bug fixes, new features, or optimizations
  • Add translations by creating a new locale file in the locales/ folder
  • Share the project by starring the repo and spreading the word


Documentation    Discord    Website



Open source and free forever. Made by F5 Studio