SleepingFox

🛩️ Supply Drop — Airdrop System

Call in an airdrop by placing a distress flare on the ground. A cargo plane flies over your position and drops a supply crate attached to a parachute, which slowly drifts to the ground. Once landed, open it as a physical ox_inventory stash and loot whatever's inside.

How it works

1. Use a flare item from your inventory — your character crouches and places it on the ground
2. Colored smoke rises from the flare (color defined per flare type)
3. A cargo plane spawns ~2 500 m away and flies toward the drop zone
4. Once overhead, it drops a crate that descends with a parachute
5. The crate lands and can be looted as an ox_inventory stash with items placed in random slots

Features

• Unlimited flare types — Create as many flare types as you want in config.lua. Each one is a fully independent entry with its own plane model, crate model, loot table, arrival delay, drop accuracy, smoke color, and delivery zone multipliers. No code changes needed — just add a block and create the item.
• Per-flare plane model — Each flare can call a different aircraft. Use a civilian cargo plane for a basic flare, a military aircraft for a military flare, or any valid GTA V plane model.
• Per-flare crate model — Each flare drops a different crate prop. Mix standard supply boxes and military ammo crates depending on the flare tier.
• Colored smoke — Smoke color is fully configurable per flare type using normalized RGB values (0.0–1.0). The same color applies to both the ground flare and the descending crate tracer light.
• Dynamic cargo plane — Spawns from a random direction at high altitude, flies over the drop zone, then despawns cleanly after passing.
• Parachute physics — The crate uses real GTA physics with a capped fall speed to simulate a parachute. It spawns within render distance (~130 m above ground) and settles naturally on any terrain. The parachute is removed on landing.
• ox_inventory stash loot — Loot is generated server-side and stored in a real ox_inventory stash. Items are placed in randomized slots so the crate looks packed, not auto-filled. Players must stay on-site to retrieve items.
• Delivery zones — Define areas with a delay multiplier. The further the zone, the longer the plane takes to arrive. Works with any number of zones.
• Police dispatch — When the flare is placed, an alert is automatically sent to law enforcement with the exact coordinates. Compatible with ps-dispatch, cd_dispatch, core_dispatch, or a fully custom handler defined in one line in config.lua.
• Per-player cooldown — Configurable cooldown between flare uses, resettable via admin commands.
• Blacklisted zones — Prevent flares from being used near prisons, police stations, or any custom area.
• Debug mode — Live plane blip with altitude and distance, drop zone radius marker on the minimap, landing blip with exact coordinates.
• Framework bridge — Auto-detects ESX, QB-Core, or runs standalone with ox_inventory only. One config line to override.

Adding a new flare type — example

['supply_flare_custom'] = {
    label      = 'Custom Flare',
    planeModel = 'cuban800',
    crateModel = 'prop_box_ammo_02a',
    planeDelay = 60,
    dropRadius = 80,
    smokeColor = '#7c1c0b',   -- red
    minItems   = 1,
    maxItems   = 5,
    lootTable  = {
        { item = 'bread',   min = 1, max = 3, chance = 80 },
        { item = 'medkit',  min = 1, max = 2, chance = 50 },
    },
},

Installation

1. Drop supply_drop into resources/
2. Add ensure supply_drop to server.cfg
3. Add your flare items to ox_inventory/data/items.lua
4. Set Config.Framework in config.lua ('auto' works for most setups)
5. Customize loot tables, models, smoke colors and zones
6. Restart

Supply Drop — Système de largage aérien

Appelez un ravitaillement aérien en posant une fusée de détresse au sol. Un avion cargo survole votre position et largue une caisse reliée à un parachute, qui descend doucement jusqu'au sol. Une fois à terre, ouvrez-la comme un stash ox_inventory et récupérez son contenu.

Fonctionnement

1. Utiliser un item fusée depuis l'inventaire — le personnage s'accroupit et pose la fusée au sol
2. Une fumée colorée s'élève depuis la fusée (couleur définie par type de fusée)
3. Un avion cargo spawn à ~2 500 m et vole vers la zone de largage
4. Au-dessus de la zone, il largue une caisse qui descend avec un parachute
5. La caisse atterrit et peut être fouillée comme un stash ox_inventory avec les items dans des slots aléatoires

Fonctionnalités

• Types de fusées illimités — Créez autant de types de fusées que vous voulez dans config.lua. Chacun est une entrée entièrement indépendante avec son propre modèle d'avion, modèle de caisse, table de loot, délai d'arrivée, précision de largage, couleur de fumée et multiplicateurs de zones. Aucune modification du code nécessaire — ajoutez simplement un bloc et créez l'item correspondant.
• Modèle d'avion par fusée — Chaque fusée peut appeler un avion différent. Un cargo civil pour une fusée basique, un avion militaire pour une fusée militaire, ou n'importe quel modèle GTA V valide.
• Modèle de caisse par fusée — Chaque fusée largue une caisse différente. Mélangez caisses de ravitaillement standard et caisses de munitions militaires selon le tier de la fusée.
• Fumée colorée — La couleur est entièrement configurable par type de fusée en valeurs RGB normalisées (0.0–1.0). La même couleur s'applique à la fumée au sol et au traceur lumineux de la caisse en descente.
• Avion cargo dynamique — Spawn depuis une direction aléatoire à haute altitude, survole la zone de largage, puis disparaît proprement après le passage.
• Physique du parachute — La caisse utilise la physique GTA réelle avec une vitesse de chute plafonnée. Elle spawn dans la distance de rendu (~130 m au-dessus du sol) et épouse naturellement le terrain. Le parachute est retiré à l'atterrissage.
• Stash ox_inventory — Le loot est généré côté serveur et stocké dans un vrai stash ox_inventory. Les items sont placés dans des slots aléatoires pour que la caisse ressemble à un vrai colis. Les joueurs doivent rester sur place pour récupérer les items.
• Zones de livraison — Définissez des zones avec un multiplicateur de délai. Plus la zone est éloignée, plus l'avion met du temps à arriver. Compatible avec autant de zones que souhaité.
• Dispatch police — Dès que la fusée est posée, une alerte est envoyée automatiquement aux forces de l'ordre avec les coordonnées exactes. Compatible ps-dispatch, cd_dispatch, core_dispatch, ou un handler personnalisé en une ligne dans config.lua.
• Cooldown par joueur — Cooldown configurable entre les utilisations, réinitialisable via commandes admin.
• Zones interdites — Empêchez l'utilisation des fusées près des prisons, commissariats ou dans toute zone personnalisée.
• Mode debug — Blip de l'avion avec altitude et distance en temps réel, marqueur de zone de largage sur la minimap, blip d'atterrissage avec coordonnées exactes.
• Bridge framework — Détecte automatiquement ESX, QB-Core, ou fonctionne en standalone avec ox_inventory uniquement. Une ligne dans la config pour forcer le framework.

Ajouter un nouveau type de fusée — exemple

['supply_flare_custom'] = {
    label      = 'Fusée personnalisée',
    planeModel = 'cuban800',
    crateModel = 'prop_box_ammo_02a',
    planeDelay = 60,
    dropRadius = 80,
    smokeColor = '#7c1c0b',   -- red
    minItems   = 1,
    maxItems   = 5,
    lootTable  = {
        { item = 'bread',   min = 1, max = 3, chance = 80 },
        { item = 'medkit',  min = 1, max = 2, chance = 50 },
    },
},

Installation

1. Placer supply_drop dans resources/
2. Ajouter ensure supply_drop dans server.cfg
3. Ajouter les items fusées dans ox_inventory/data/items.lua
4. Définir Config.Framework dans config.lua ('auto' fonctionne dans la plupart des cas)
5. Personnaliser les tables de loot, modèles, couleurs de fumée et zones
6. Redémarrer