# NPC Oil Rig AirDrop

NPC Oil Rig AirDrop adds an air-drop style event to Rust's oil rigs. When an oil rig is hacked, a custom cargo plane flies over the rig and parachutes armed NPCs down onto it.

The NPCs descend by parachute and are placed onto the oil rig, creating an additional combat encounter for players during the oil rig event.

Features

* 🛩️ Spawns a custom cargo plane when an oil rig crate is hacked.
* 🪂 Drops NPCs from the cargo plane using parachutes.
* 🤖 Configurable number of NPCs per drop.
* 🔫 Uses the default Oil Rig Heavy Scientist loadout by default.
* 🎒 Supports custom NPC loadouts through the Kits plugin.
* ⚙️ Configurable cargo plane height and speed.
* 🪂 Configurable parachute drag.
* 🏗️ Automatically detects both Large and Small Oil Rigs.
* 🧭 Uses specific landing offsets for each oil rig type.
* 🧹 Cleans up NPCs, parachutes and cargo planes when the plugin unloads.
* 🛡️ Temporarily disables NPC navigation while parachuting to prevent NavMesh issues.
* 📍 Automatically places NPCs onto the rig's NavMesh after landing.

How It Works

When a player hacks an oil rig's locked crate, the plugin checks whether the crate is within the configured oil rig area.

If it is, a cargo plane is spawned and given a flight path that passes directly over the rig.

When the plane reaches the drop position, the configured number of NPCs are spawned at slightly different positions and heights to prevent the parachutes from immediately colliding.

Each NPC is equipped with a parachute and begins descending toward the rig.

Once the parachute lands, the NPC is dismounted and moved onto the appropriate NavMesh position on the oil rig.

Configuration

The configuration file is automatically generated in:

oxide/config/NPCOilRigAirDrop.json

Available Settings

| Setting | Default | Description |
| -------------------- | ------: | ------------------------------------------------------------------------------------------------------------ |
| NPC Kit | "" | Kit to give the NPC. Requires the Kits plugin. Leave blank to use the default Oil Rig Scientist loadout. |
| NPCs Per Drop | 4 | Number of NPCs dropped from each cargo plane. |
| Cargo Plane Height | 300 | Height of the cargo plane. |
| Cargo Plane Speed | 300 | Speed of the cargo plane. |
| Parachute Drag | 2.2 | Controls parachute descent speed. Higher values make the parachute slower, with 4 being the slowest. |

Custom NPC Kits

The plugin supports the Kits plugin for custom NPC equipment.

Set the NPC Kit configuration value to the name of an existing kit:

"NPC Kit": "my_npc_kit"

If the setting is left blank, NPCs retain the default Oil Rig Heavy Scientist loadout.

If a custom kit is configured, the plugin clears the NPC's default loadout and attempts to equip the supplied kit.

Oil Rig Support

The plugin automatically searches the world for Oil Rig prefabs during server initialization and supports:

* Large Oil Rig
* Small Oil Rig

Each rig has its own calculated drop position so the cargo plane passes over the appropriate landing area.

NPC Behaviour

NPCs have their NavMesh navigation disabled while they are parachuting. This prevents the AI navigation system from attempting to navigate while the NPC is still in the air.

After landing, the plugin:

* Finds a valid NavMesh position.
* Corrects the NPC's position if necessary.
* Applies additional positioning corrections for the oil rig floors.
* Warps the NPC's navigation agent to the landing position.
* Re-enables NavMesh navigation.

This allows the NPC to transition from parachuting to normal AI behavior after landing.

Cleanup

The plugin tracks spawned NPCs, parachutes and cargo planes.

When the plugin is unloaded, tracked entities are removed so NPCs and aircraft are not left behind on the server.

Requirements

Optional

Kits — Only required if you want to use custom NPC kits.

Without Kits, the plugin works using the default Oil Rig Heavy Scientist loadout.

NPCOilRigAirDrop