[Preview Video]

This script protected escrow system

[Docs]

[Discord]

izzy-airdrop — Ultra Optimized FiveM Airdrop System

✈️ Core Airdrop Experience

* Bombushka plane flies to target and drops supply crates or vehicles with parachute

* Realistic fall physics — configurable FallSpeed

* Landing flare smoke on normal, job, and vehicle drops

* Post-land unlock timer — countdown before crate can be opened

* Top NUI alert when crate leaves the plane (“airdrop incoming”)

* Auto cleanup — remove on first loot or delete unlooted drops after timeout

🎯 Three Ways to Start a Drop

* Admin — `/createdrop` (customizable via AdminUI.CreateDropCommand) opens full create-drop NUI

* Player — shoot sky with flare gun (WEAPON_FLAREGUN) → plane → random loot from DropItems tiers

* Server schedule — automatic drops at set times (ScheduleTimes / ScheduleHours) with random coords from config

📦 Drop Types

* Normal Drop — everyone sees blip, zone, crate (gen_crate), custom item list from admin UI

* Job Drop — police, ambulance, etc. — only matching job sees entity, blip, notify, and can loot (gen_crate2)

* Vehicle Drop — car falls on parachute; winner gets vehicle saved to garage DB (QB player_vehicles / ESX owned_vehicles)

🗺️ Redzone & Map

* Radius zone at landing point (not mid-air crate position)

* Red circle blip + pin blip at drop location (sprite, color, scale, name configurable)

* 3D marker — sphere and/or ground ring, colors, draw distance

* Optional routing bucket isolation — per_drop or static mode for PvP zones

🎮 Loot UI (NUI)

* Modern loot panel — remaining item count, profile display

* Collect all | Collect selected | single-item pickup (right-click)

* Item images from inventory path or local html/items/

* Optional Discord avatar on crate open (DiscordBotToken + ServerPerformance.DiscordLootAvatar)

* IC name or Steam name — UseCharacterNames

🛠️ Admin Create-Drop Panel

* Drop name, type (Normal / Vehicle / Job), coords (manual or auto-fill your position)

* Item search, +/- amounts, vehicle picker from shared/vehicles.lua

* Scheduled drop time on notify (cosmetic hour/minute)

* History tab — active drops with fall progress & ETA, last 5 completed (Active / Landed / Looted / Expired)

* Item catalog auto-fetch from ox_inventory, QBCore, or ESX + optional ManualList merge

🔔 Notifications & Server Broadcast

* Configurable loot broadcast: chat | QB notify | txAdmin announce (needs monitor)

* List looted items in message or player name only

* IC vs FiveM name on broadcast

* Custom txAdmin author header

🔒 Security & Limits

* Server-side loot distance check (AntiCheat.MaxLootDistance)

* Job drop loot blocked for wrong job on server

* Anti-spam — per-player create cooldown + max active drops server-wide

* Admin-only UI create, cammode, and scheduled drop token validation

* Performance throttles — history sync, job player cache, admin panel polling

🧭 Interaction

* ox_target or qb-target on crate — or [E] drawtext when target disabled

* Unlock countdown floating text + notify while crate is locked

* Plane timeout cancels drop if plane never reaches target

💰 Framework & Inventory

* Auto-detect: QBCore, QBX, ESX

* Give loot via ox_inventory (priority) or framework inventory

* Admin permission: license/steam list, QB admin/god, ESX AdminGroups, ACE command

* MySQL support: oxmysql, ghmattimysql, mysql-async

📸 Cammode — Vehicle Thumbnails

* Command: `/cammode` (admin only)

* Teleports to photo studio, screenshots every model in vehicles.lua via screenshot-basic

* Saves PNGs to html/cars/ for vehicle drop UI

* Requires CamScreenshotWebhook in server/config.lua

* Run again to cancel mid-session

📣 Discord Webhooks

* Separate logs: Drop Create, Random Drop, Drop Loot

* Rich embeds — drop name, type, coords, items, creator/looter identifiers (steam, discord, license, citizenid)

* Cammode uses its own webhook (upload only, not loot logs)

🌍 Localization

* 10 languages: EN, TR, ES, FR, DE, PT, RU, AR, ZH, JA

* All UI, notifications, chat messages, and history labels translated

* Set Config.Language in shared/config.lua

🛠️ Config

* shared/config.lua — safe to share: zones, timing, loot pools, job rules, redzone, anti-cheat

* server/config.lua — secrets: webhooks, admins, MySQL, garage name, Discord bot token

* Tiered random loot for flare + schedule (DropItems[1], [2], … — one random tier per drop)

* PlaneSpawnDistance, PlaneArrivalTimeSecond, drop props, flare toggles

🚗 Vehicle Drops

* Parachute-attached vehicle entity at landing

* Plate + model inserted into player garage on claim

* QBDefaultGarage for QBCore/QBX

* Vehicle list in shared/vehicles.lua — used by admin UI and cammode

📁 Item Images

* ItemImagePath — e.g. qb-inventory/html/images, ox_inventory/web/images

* UseLocalItemImages = true → bundle icons in html/items/

* ox / QB / ESX catalog image normalization built-in