⚔️ zrx_ffa — Advanced Free For All System

An advanced, optimized and fully configurable Free For All combat system for FiveM (ESX).

Perfect for PvP, faction and competitive roleplay servers looking for fully isolated combat arenas with public and private lobbies.

📌 Features

🌍 Public Zones

• 🗺️ Unlimited configurable public zones

• 🪣 Routing bucket isolation per zone

• 🔒 Sphere-based zone boundary enforcement

• 💾 Automatic loadout save & restore

• 🛡️ Configurable spawn protection

• 🎯 Optional headshot one-shot mode

• 🔫 Infinite ammo support

• 💀 Live kill feed system

• 📊 Real-time HUD & scoreboard

• 📍 Configurable map blips & markers

🏠 Private Zones

• 👤 Player-created private lobbies

• 🗺️ Custom map selection system

• 🔫 Custom weapon loadouts

• 🔐 Optional password protection

• 👥 Configurable max player limit

• 🎯 Headshot one-shot toggle

• 🔄 keepOnline lobby system

• ❌ Remote lobby close support

🖥️ UI / NUI

• ✨ Polished zone selection menu

• 🖼️ Map preview image on hover

• 📑 Public & Private tab system

• ⚙️ Integrated private lobby creator

• 🚫 Disabled create button while owning a lobby

• ❌ Confirmation dialog before closing a lobby

⚙️ General

• 🎮 Fully remappable keymapping

• 📦 ESX & ox_inventory support

• ⚙️ Fully customizable notifications & strings

• 🔐 Optimized and fully synced

📦 Requirements

ox_lib

oxmysql

es_extended

⚙️ Installation

1. Place zrx_ffa into your resources folder

2. Add this to your server.cfg

ensure zrx_ffa

1. Restart the server

2. Edit configuration/config.lua

⌨️ Commands

/openffa

/quitffa

📤 Exports

Client

exports['zrx_ffa']:OpenFFAMenu()

exports['zrx_ffa']:CloseFFAMenu()

🧠 StateBags

zrx_ffa:zone

zrx_ffa:privateZone

⚙️ Configuration Example

Config.Debug = false

Config.DebugLevel = 'INFO'

Config.DrawDistance = 80

Config.SpawnProtect = { enabled = true, time = 2, animation = true, }

Config.KillNotification = { enabled = true, showAll = true, }

Config.Leave = { command = 'quitffa', promptKey = 'F10', }

Config.HUD = { position = 'top', showPlayers = true, }

🌍 Public Zone Example

Config.Public = { my_zone = {

    name = 'My Zone',

    description = 'Only Pistol • Headshot Oneshot',

    maxPlayers = 10,

    dimension = 1003,

    image = 'https://...',

    sphere = {
        enabled = true,
        radius = 50.0,
    },

    player = {
        headshotOneShot = true,
        armor = 100,
    },

    weapon = {
        WEAPON\_PISTOL = {},
    },
},

}

🏠 Private Zone Configuration

Config.Private = {

keepOnline = true,

mappool = Config.Maps,

weaponpool = {

    WEAPON\_PISTOL = {},

},

}

🔔 Notification Customization

Customize your own notification system inside:

configuration/functions.lua

Example:

Config.Function.Notification = function(data)

-- data.player
-- data.title
-- data.msg
-- data.type
-- data.duration

end

All notification strings can be edited inside:

configuration/strings.lua

⚡ Performance

• 🪣 Routing bucket optimized

• 📡 Fully synchronized combat zones

• 💾 Automatic inventory handling

• 🔐 Production-ready

• ⚙️ Optimized resource usage

🛠️ Support

Need help or found a bug?

Discord: https://discord.gg/mcN25FJ33K