pebble_airdrops · v1.0.0

Airdrops

A cargo plane crosses the map and drops a crate into one of your drop zones. Players race to it, hack the lock, hold the area while it opens and loot it.

Get Airdrops
Frameworks
QBCoreQboxESXStandalone
Requires
ox_liboxmysqlpebble_bridge 1.2+

How a drop plays out

  1. Inbound. Everyone gets a notification and a circle on the map. The circle is offset from the real spot, so players still have to search. The plane flies in from a random direction.
  2. Falling. A flare lights the landing spot shortly before the drop, and the crate comes down under a parachute.
  3. Locked. The crate lands with red light strips, a status screen and a beep. If the drop type has a Hackable after wait, its screen counts down first and nobody can hack it yet. Then one player at a time can hack it through the uplink breach minigame: per layer, tune a carrier wave onto the drifting crate beacon (frequency and phase), then inject the incoming key packets as they pass the gate. If the police alert is on, starting a hack sends a dispatch alert.
  4. Unlocking. After a successful hack the strips turn amber, the screen counts down, and the lock opens after the drop type's unlock time. Anyone can still fight over it.
  5. Open. The strips and screen turn green. Everyone opens the same stash. The crate disappears once the stash is empty, or when the drop type's crate lifetime runs out.

The server runs the timeline. Clients only draw it, so a late joiner sees the plane or the parachute where it should be, and no client can start, speed up or open a drop.

Features

  • Scheduled drops: every few hours with a random offset, or a random number of drops inside daily time windows. Minimum players and minimum on-duty police per drop.
  • Drop zones placed in-game with a ghost crate on your crosshair, weighted, with a cooldown so the same zone doesn't come up twice in a row.
  • Drop types: what a crate holds and how hard it is to open. Each type has its own crate prop, timers, hack layers, keys, required item and loot.
  • Rarity loot: rolls, guaranteed rarities and item pools from Common to Legendary. With pebble_looting running, each drop type's loot becomes a template that staff edit in /lootadmin.
  • Custom crate with a hinged lid, a live status screen and light strips that change colour with the crate's state, plus hack and open animations.
  • In-game admin panel (/airdropadmin): live drop control, zones, drop types, settings and an audit log.
  • Announcements for every step of a drop, each with its own text and style.
  • Police alert through your dispatch resource when someone starts a hack.
  • Discord: public embeds for drop events and an admin audit webhook.
  • Server API: start and stop drops and react to every phase from your own resources.

The crate

The default crate, pebble_airdrop_crate, is streamed with the resource. Once it lands, it's snapped onto the ground under the zone, so a zone stored a little too high or low still puts it on the ground. A drop type can use any other prop as well.

Its front and back screens and the light strips round the lid show the crate's state to players within Config.Crate.screen.distance:

State Look
Arming Red, a countdown and a progress bar while the Hackable after wait runs.
Locked Red, pulsing, LOCKED.
Being hacked Amber, fast blink, BREACH, while someone holds the hack.
Unlocking Steady amber, a countdown and a progress bar.
Open Green, OPEN.

The footer counts down to when the crate disappears. Colours come from Config.Crate.lights. Spot lights just outside each side make the strips light the ground as well.

Animations. The hacking player walks to the keypad, kneels, types during the minigame and stands up again. The first player to open the crate lifts the lid with both hands; everyone nearby sees the lid swing open, and late joiners see it already open. Other crate models use a fallback hack animation and open without one.

Open files

The resource is escrowed. config/ and locales/ stay readable, so you can change every option on the Configuration page and translate every message.