📦 zrx_lootdrop — Advanced Lootdrop System

An advanced, optimized and fully configurable lootdrop system for FiveM (ESX).

Perfect for PvP, faction and roleplay servers looking for dynamic event-based gameplay with high replay value.

📌 Features

• 📍 Unlimited configurable lootdrop zones
• ⏰ Automatic cron-based scheduling system
• 🛠️ Manual admin command support
• ⌛ Preparation phase before the lootdrop starts
• 🌍 Configurable zone radius system
• 🚫 Vehicle restriction support inside zones
• 🪣 Routing bucket isolation per active lootdrop
• ⚔️ 1v1 Gulag system for defeated players
• 🛡️ Anti-combatlog protection
• 💀 Configurable death handling system
• 🪂 Sky parachute lootdrop animation
• 🎬 Collection animation & progress bar
• 🎁 Configurable reward system with chances
• ⏳ GTA countdown scaleform support
• 📊 Live custom HUD with kills, players and timer
• 🗺️ Flashing map blips & radius blips
• 👮 Job blacklist support
• ⚙️ Fully customizable notifications and strings
• 🔐 Optimized and fully synced

📦 Requirements

• ox_lib
• oxmysql
• es_extended

⚙️ Installation

1. Download the resource
2. Place zrx_lootdrop into your resources folder
3. Add this to your server.cfg

ensure zrx_lootdrop

1. Edit configuration/config.lua
2. Import required items into your inventory system

⚙️ Configuration Example

Config.DrawDistance = 80

Config.Color = vec3(255, 165, 0)

Config.Manual = {
    groups = { admin = true },
    command = 'startlootdrop',
}

Config.Automatic = {
    announce = { 30, 15, 10, 5, 4, 3, 2, 1 },

    zones = {
        obsa = '4 0 * * *',
    }
}

Config.Zones.obsa = {

    displayname = 'Observatory',

    radius = 50,

    time = {
        preparation = 10 * 1000,
        duration = 30 * 60,
    },

    blacklistedJobs = {
        police = true
    },

    settings = {
        allowVehicles = false
    },

    countdown = {
        enabled = true,
        from = 5
    },

    antiCombatlog = {
        enabled = true,
        setDead = true,
        wipeLoadout = true,
        wipeInventory = false,
    },

    death = {
        enabled = true,
        wipeLoadout = true,
        wipeInventory = false,
    },

    rewards = {
        weapon_pistol_case = {
            count = 1,
            chance = 50,
            min = 1,
            max = 1
        },

        bread = {
            count = 1,
            chance = 100
        },
    },
}

🎁 Reward System

• 🎲 Individual reward chances
• 📦 Configurable min/max item count
• 🛠️ Fully customizable reward pools
• 🎯 Per-zone reward configuration

⚔️ Gulag System

• 🥊 1v1 fight system
• ⏳ Waiting area support
• 🏆 Winner returns to the lootdrop zone
• ⚙️ Fully configurable locations

🔔 Notification Customization

Customize your own notification system inside:

configuration/function.lua

Example:

Config.Function.Notification = function(data)

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

end

All notification strings can be edited inside:

configuration/strings.lua

🐞 Debug Logging

Config.Debug = false

Config.DebugLevel = 'INFO'

Available levels:

• TRACE
• DEBUG
• INFO
• WARN
• ERROR

⚡ Performance

• Optimized sync handling
• Low resource usage
• OneSync optimized
• Routing bucket isolated
• Production-ready

🛠️ Support

Need help or found a bug?

Discord: https://discord.gg/mcN25FJ33K