GFX Airdrop

Automated airdrop system that spawns loot crates at random map locations on a configurable timer. Includes an admin NUI panel for creating, viewing, and deleting airdrops, with Discord webhook logging and a chance-based item reward system.

Info

Dependencies

Installation

1. Place the gfx-airdrop folder into your server's resources directory.
2. Add the following to your server.cfg:

   ensure gfx-airdrop
   

3. Configure the files inside config/ and the cl-config.lua / sv-config.lua files to match your server's setup.
4. (Optional) Set the Discord webhook URL in server/utils.lua (DiscordWebhook variable) to enable Discord logging.
5. (Optional) Set your Discord bot token in config/server_config.lua if you want Discord avatar support.

Configuration

config/locale.lua

config/client_config.lua

config/server_config.lua

client/cl-config.lua

server/sv-config.lua

Exports

This script does not create any exports.

Events

Client Events

gfx-airdrop:CreateAirDrop

Triggered by the server to all clients when a new airdrop is created. Spawns the crate object, blips, and particle effects on the client.

-- Example: Listen for new airdrop creation
RegisterNetEvent('gfx-airdrop:CreateAirDrop')
AddEventHandler('gfx-airdrop:CreateAirDrop', function(airdropTable)
    print("New airdrop created with ID: " .. airdropTable.id)
end)

gfx-airdrop:RemoveDrop

Triggered by the server to all clients when an airdrop is removed (collected, expired, or admin-deleted). Cleans up the crate entity, blips, and particle effects.

RegisterNetEvent('gfx-airdrop:RemoveDrop')
AddEventHandler('gfx-airdrop:RemoveDrop', function(id)
    print("Airdrop " .. id .. " has been removed")
end)

gfx-airdrop:update

Triggered by the server to all clients when an airdrop's lock timer expires and it becomes openable.

RegisterNetEvent('gfx-airdrop:update')
AddEventHandler('gfx-airdrop:update', function(id)
    print("Airdrop " .. id .. " is now open for collection")
end)

gfx-airdrop:Announce

Triggered by the server to display a notification announcement to players (e.g., incoming airdrop).

RegisterNetEvent('gfx-airdrop:Announce')
AddEventHandler('gfx-airdrop:Announce', function(text)
    print("Announcement: " .. text)
end)

gfx-airdrop:Notify

Triggered by the server to show a notification to a specific player.

RegisterNetEvent('gfx-airdrop:Notify')
AddEventHandler('gfx-airdrop:Notify', function(text)
    print("Notification: " .. text)
end)

Server Events

gfx-airdrop:server:OpenAirDrop

Triggered by a client when a player interacts with an openable airdrop. Gives items to the player, logs to Discord, and removes the crate.

-- Example: Trigger from client side
TriggerServerEvent('gfx-airdrop:server:OpenAirDrop', airdropId)

Commands

Features

• Automatic airdrop spawning on a configurable timer when minimum player count is met
• Chance-based random item selection with configurable drop weights
• Lock timer system: airdrops must "unlock" before players can collect them
• Auto-deletion of uncollected airdrops after a configurable timeout
• Dual map blips per airdrop (signal blip + crate blip) with a colored area radius blip
• Flare particle effect at crate location for visual identification
• 3D floating text showing countdown timer and interaction prompt
• Sound alert when a player is within 30 units of an airdrop
• NUI-based admin panel for creating airdrops at specific coordinates, selecting items, and managing active drops
• Admin panel supports setting waypoints to airdrop locations
• Discord webhook logging for airdrop creation, collection, and expiration
• Player avatar support (Steam or Discord) for the NUI panel
• Multi-framework support: auto-detects ESX or QBCore
• Multi-inventory support: works with 7 different inventory systems
• Coordinate deduplication to prevent multiple airdrops spawning at the same location
• Configurable UI theme colors for the NUI panel
• Localization support with _L() translation function

Troubleshooting