NSR Supply Wars is not just a standard airdrop script—it is a complete, server-authoritative military battlefield event system engineered for serious FiveM RP, PvP, and Survival servers.

When a supply operation begins, players receive incoming aircraft warnings, locate parachute drops descending through the sky, fight over tactical landing zones, breach armored containers using dedicated military tools, and loot supplies through an interactive Stash inventory.

Whether you want automated server-wide airdrops, player-called drops using single-shot flare guns found across 150 random map locations, decoy trap crates, or rare Black Ops containers, NSR Supply Wars delivers a cinematic and competitive experience out of the box.

🌟 Key Features

📦 1. Three Dedicated 3D Crate Models

• **PUBG Air Drop **: The iconic airborne supply container, deployed during high-altitude aircraft flyovers.
• **Military Supply Box **: Heavy armored container used for field resupplies, secondary drops, and counter-intelligence decoy crates.
• Interactive Military Crate: Covert tactical container used for high-value Black Ops events.
• Zero Duplicate Props: Every crate drops as a single entity and remains that exact same prop on the ground upon landing.

 2. Authentic 3-Phase Aircraft Deployment

• Phase 1 — Aircraft Inbound: Native military transport aircraft (titan, alkonost, cargoplane, etc.) cruises over the airspace following realistic flight vectors.
• Phase 2 — Parachute Cargo Descent: Realistic vertical fall with parachute deployment, subtle wind drift, and cinematic pacing.
• Phase 3 — Ground Touchdown & Snap: Props dynamically snap flush to the terrain using native collision probing, detaching the parachute and triggering landing impact sparks and persistent signal smoke.

3. Interactive Stash Looting (Take What You Want)

• No forced rewards into players' pockets!
• Breaching an unlocked crate opens an interactive Stash inventory (ox_inventory, qb-inventory, qs-inventory, ps-inventory, or Standalone).
• Players can take the items and weapons they need and leave the rest behind for teammates or rivals.
• Crates remain accessible on the ground until collected or cleaned up.

4. 150 Random World Flare Gun Spawns (1-Bullet PUBG Style)

• Dispersed across 150 outdoor tactical locations across San Andreas (Sandy Shores, Alamo Sea, Grapeseed, Paleto Bay, mountains, industrial zones, and docks).
• Equipped with glowing 3D ground markers and optional radar blips.
• 1-Round Mechanics: Picking up the flare gun equips a real Flare Gun with 1 single round.
• Players aim directly at the sky to fire a glowing red flare projectile into the atmosphere. The weapon immediately disappears upon firing, and an airdrop transport is dispatched to their exact coordinates!

5. Dedicated Tool Unlocking System

Each crate profile requires its own specific breaching tool:

• Standard Airdrop: Unlocked using Heavy Bolt Cutters (nsr_bolt_cutters).
• Military Supply Box: Unlocked by swiping an encrypted Military Access Card (nsr_military_access_card).
• Black Ops Crate: Breached with an electronic Tactical Hacking Device (nsr_hacking_device).
• Features: Configurable unlock durations, progress bars, cancel-on-damage/movement/death, single-player locking, and sound effects.

6. Decoy Countermeasure Traps

• Lure rival crews into fake drop zones!
• Opening a decoy military box triggers a tactical concussion burst, reveals minimal salvage, and transmits a high-priority 10-98D Decoy Detonation dispatch alert to nearby law enforcement.

7. Police Dispatch Integration

• Full support for ps-dispatch, cd_dispatch, qs-dispatch, core_dispatch, and built-in Standalone Alert Banners.
• Dedicated codes: 10-90 (Airdrop Inbound), 10-91 (Touchdown), 10-99 (Flare Launch), 10-99M (Restricted Breach), and 10-98D (Decoy Detonation).

 8. Tactical NUI Admin Console & Bilingual Support

• Press F10 or type /supplywars (configurable permissions via ACE, groups, or jobs).
• Overview: Real-time telemetry, active event counter, total completed drops, and live activity feed.
• Operation Launcher: Deploy custom airdrops on the fly (set aircraft, altitude, descent speed, crate count, and drop sector).
• Live Event Monitor: Track active drops on the map with 1-click teleport and cancel controls.
• Loot Pool Editor: Add, remove, and adjust item drop chances in real time without restarting the server.
• Bilingual Interface: Full English (LTR) and Arabic (RTL) layout with live language switching.

⚙️ Compatibility & Integrations

System

Supported Options

Frameworks

Qbox (qbx_core), QBCore (qb-core), ESX Legacy (es_extended), Standalone

Inventories

ox_inventory, qb-inventory, qs-inventory, quasar_inventory, ps-inventory, Standalone

Interactions

Key-Based [E] (No third-party script needed), ox_target, qb-target

Dispatch

ps-dispatch, cd_dispatch, qs-dispatch, Standalone Fallback

Database

oxmysql (Automatic schema creation on startup)

📦 What's Included in the Download?

1. Complete Resource Package (nsr_supplywars):
   • Ready-to-run server and client scripts.
   • Dedicated stream/ subfolders for all 3 proprietary props (pubg_mobile_air_drop, military_box, military_crate_game_ready_with_open_system).
   • 15 modular, fully documented configuration files (config/*.lua).
   • English & Arabic locale files (locales/*.lua).
2. Ready-to-Paste Item Installation Files (install/):
   • Organized folders for QBCore, Qbox, ESX, and Standalone.
   • Includes ready-to-paste item snippets in .txt format for every supported inventory.
   • Database SQL import file (database_items.sql) for legacy ESX inventories.
3. 5 Custom 512x512 Transparent PNG Item Icons:
   • Photorealistic studio renders of nsr_supply_flare.png, nsr_military_access_card.png, nsr_hacking_device.png, nsr_bolt_cutters.png, and nsr_supply_key.png.
4. Documentation:
   • Step-by-step INSTALLATION_GUIDE.md covering setup for non-technical server owners.
   • Comprehensive README.md and CHANGELOG.md.

🔒 Asset Escrow & Security

• Server-Authoritative: All loot generation, distance validation, single-claim locks, and tool verifications run on the server. Zero client trust.
• Escrow Protected: Main core scripts are secured via Cfx.re Asset Escrow.
• 100% Customer Configurable: All configuration files (config/*.lua), locale files (locales/*.lua), and item installers (install/**) are explicitly unlocked in escrow_ignore.

📖 Installation in 3 Simple Steps

1. Drop & Ensure: Extract nsr_supplywars into your resources/ folder and add ensure nsr_supplywars to your server.cfg.
2. Install Items: Copy the item snippet from install//.txt into your inventory's items file, and copy the 5 PNGs into your inventory's images folder.
3. Configure & Launch: Adjust any drop frequencies or loot tables in config/ to your server's liking, and restart your server!