About SkyCarrier
Bring an enormous flying aircraft carrier raid event to your Rust server.
Rust events should offer more than another familiar monument or a simple NPC fight. Imagine a heavily defended aircraft carrier flying above the ocean, protected by SAM Sites, Auto Turrets, and armed scientists, waiting for players brave enough to bring it down.
SkyCarrier introduces a massive, multi-stage PvE raid event built around a flying aircraft carrier. Players must approach by helicopter, destroy the carrier's propeller engines, survive its defenses, board the flight deck, and fight their way into the diesel generator room. Destroying the generators causes the carrier to catch fire, fall from the sky, crash into the ocean, and eventually sink.
With configurable flight routes, defensive systems, NPCs, custom loot, a scripted Chinook encounter, rescue boats, map markers, and an interactive event HUD, SkyCarrier delivers a complete aerial raid experience.
Perfect for PvE, PvP, modded, RPG/RP, survival, progression, and custom event Rust servers.
Features
- Adds a massive flying aircraft carrier event constructed from Rust entities.
- Fully explorable carrier with multiple decks, interior rooms, stairs, and a flight deck.
- Multi-stage raid progression requiring players to disable engines, board the carrier, and destroy generators.
- Animated carrier movement, turning, falling, crashing, and sinking.
- Configurable automatic event scheduling or manual event management.
- Automatically generates an offshore flight route when no custom checkpoints are configured.
- Supports custom flight routes, spawn positions, checkpoint stops, and route looping.
- Configurable flight altitude, movement speed, and turning speed.
- Route validation to avoid Deep Sea areas and portal locations.
- Four default destructible propeller-engine targets.
- Engine damage and health settings, including separate multipliers for different damage types.
- Destroying engines progressively reduces the carrier's movement speed.
- Destroying every propeller engine disables the carrier's SAM defenses and stops its movement.
- Two default diesel generator targets located inside the carrier.
- Diesel generators require explosive damage using the default settings.
- Destroying all diesel generators triggers the carrier's destruction sequence.
- Explosion, fire, and smoke effects during the raid and crash.
- Scripted falling and splashdown sequence with animated movement and rotation.
- Configurable evacuation delay before sinking begins.
- Gradual carrier sinking with a configurable sinking duration.
- Optional Chinook arrival and scripted shootdown encounter after the carrier crashes.
- Configurable locked Chinook crate with adjustable hacking time.
- Optional rescue boats that approach and dock beside the crashed carrier.
- Rescue scientists can climb aboard the carrier and join the fight.
- Configurable scientist counts, equipment, health, damage, and detection ranges.
- Eight default Auto Turrets with configurable weapons, ammunition, health, and damage.
- Two default SAM Sites with configurable ammunition, health, range, and reload behavior.
- Eight default scientist guards, including a Heavy Scientist, with configurable weapons and patrol locations.
- Configurable scientist spawn positions, weapons, health, and patrol areas.
- Optional destruction settings for Auto Turrets and SAM Sites.
- Configurable defensive behavior after the carrier crashes.
- Eleven default loot containers positioned across different areas of the carrier.
- Custom loot tables with configurable items, amounts, chances, and skin IDs.
- Additional reward crate appears after the carrier crashes.
- Optional locked Chinook crate containing configurable rewards.
- Player victory hook triggered when the final destruction reward crate is opened.
- Optional map marker that follows the carrier and displays its current event stage.
- Configurable map marker name and color.
- Optional in-game event HUD displaying raid objectives, target progress, and timers.
- Optional nearby guidance markers for engines, generators, and reward crates.
- Automatic server-wide event announcements.
- English and Russian plugin messages included.
- Admin console commands to start and stop events.
- Admin permission support for event management.
- Developer hooks and an API for integrating with other plugins.
- Automatic cleanup of event entities when the event ends.
- Includes custom carrier model and navigation data files.
SkyCarrier Raid Event
SkyCarrier is designed as a complete raid encounter with multiple objectives that players must complete in order.
The carrier begins high above the ocean, moving between route checkpoints while defending itself against approaching players.
To defeat it, players must complete several stages.
| Stage | Objective |
|---|---|
| 1. Approach | Find the flying carrier and approach using a helicopter. |
| 2. Disable Engines | Destroy the propeller engines underneath the carrier. |
| 3. Board the Carrier | Land on the flight deck and fight through its defenses. |
| 4. Destroy Generators | Reach the lower decks and destroy the diesel generators. |
| 5. Carrier Crash | Escape the danger as the carrier catches fire and falls toward the ocean. |
| 6. Final Encounter | Survive the post-crash events, including optional Chinook and rescue scientist encounters. |
| 7. Collect Rewards | Loot the reward crates before the carrier sinks. |
Tip
How to Complete the Event
Bring a helicopter, weapons, ammunition, and explosives.
First, attack the carrier's propeller engines to disable its SAM Sites. Then land on the carrier, defeat its guards and turrets, and reach the diesel generator room on the lower decks.
Destroy the generators to bring the carrier down and unlock the final reward phase.
Flying Aircraft Carrier
SkyCarrier features a large aircraft carrier that moves through the world rather than remaining at a fixed monument location.
The carrier follows configurable flight checkpoints, smoothly changes direction, and stops at configured route positions.
Flight Features
- Configurable flying altitude.
- Adjustable movement and turning speed.
- Automatic offshore route generation.
- Custom route checkpoints.
- Configurable waiting time at checkpoints.
- Optional looping flight routes.
- Custom spawn coordinates.
- Deep Sea and portal clearance checks.
| Flight Setting | Default |
|---|---|
| Minimum flight height | 120 meters |
| Movement speed | 12 m/s |
| Turning speed | 15 degrees/second |
| Checkpoint waiting time | 60 seconds |
| Repeat flight route | Enabled |
| Deep Sea clearance | 400 meters |
Note
Automatic Routes
When no custom route checkpoints are configured, SkyCarrier attempts to find a suitable offshore route automatically.
If no valid route is available, the event will not start until a suitable route can be found or configured.
The default flight route is designed to keep the carrier away from unsuitable land and Deep Sea locations.
Destructible Propeller Engines
The first objective is to destroy the propeller engines mounted underneath the carrier.
The engines are special damage targets with configurable health, hit detection, damage types, and positions.
| Setting | Default |
|---|---|
| Number of engines | 4 |
| Health per engine | 750 HP |
| Hit radius | 6 meters |
| Explosion damage multiplier | 1.0 |
| Anti-vehicle damage multiplier | 1.0 |
| Bullet damage multiplier | 0.02 |
Engine Mechanics
- Four propeller-engine targets by default.
- Each engine has its own health.
- Configurable engine positions.
- Separate damage multipliers for bullets, explosions, and anti-vehicle damage.
- Destruction effects when an engine is destroyed.
- Carrier movement speed decreases as engines are destroyed.
- Destroying all engines stops the carrier.
- SAM Sites are disabled when every propeller engine is destroyed.
Tip
Example: With the default configuration, players can use explosives or anti-vehicle weapons to destroy the propeller engines efficiently.
Normal bullets deal significantly reduced damage because the default bullet damage multiplier is 0.02.
Diesel Generator Objective
Once the carrier's engines are destroyed, players must board the carrier and locate the diesel generator room.
The diesel generators are the final objectives required to bring the carrier down.
| Setting | Default |
|---|---|
| Number of generators | 2 |
| Health per generator | 900 HP |
| Hit radius | 3.6 meters |
| Explosion damage multiplier | 1.0 |
Generator Mechanics
- Two diesel generator targets by default.
- Located within the carrier's lower decks.
- Individual health and damage detection.
- Configurable generator positions.
- Damage-type multipliers.
- Destruction effects for each generator.
- Destroying every generator triggers the carrier crash sequence.
Warning
Important: By default, diesel generators only accept damage from the configured explosion damage type.
Players should bring explosives to complete the generator objective.
Carrier Defense System
SkyCarrier features several configurable defense systems that protect the carrier throughout the raid.
| Defense Type | Default Amount | Description |
|---|---|---|
| Auto Turrets | 8 | Armed turrets positioned around the carrier. |
| SAM Sites | 2 | Anti-aircraft defenses protecting the carrier from approaching aircraft. |
| Scientist Guards | 8 | Armed scientists guarding the flight deck and interior areas. |
| Rescue Scientists | Up to 6 | Additional scientists arriving by rescue boats after the crash. |
Auto Turrets
Auto Turrets defend the carrier against approaching and boarding players.
- Configurable turret positions and rotations.
- Custom weapon and ammunition shortnames.
- Configurable ammunition per turret.
- Adjustable health.
- Configurable detection radius.
- Adjustable damage multiplier.
- Option to make turrets destructible or invulnerable.
- Optional continued operation after the carrier crashes.
Default Auto Turret Settings
| Setting | Default |
|---|---|
| Health | 1,000 HP |
| Weapon |
rifle.ak
|
| Ammunition |
ammo.rifle
|
| Rounds per turret | 512 |
| Detection range | 45 meters |
| Damage multiplier | 1.0 |
| Destructible | Yes |
SAM Sites
SAM Sites protect the flying carrier from approaching aircraft.
- Configurable SAM Site positions.
- Adjustable health.
- Configurable rocket ammunition.
- Adjustable detection range.
- Configurable damage multiplier.
- Configurable delay between volleys.
- Option to make SAM Sites destructible.
- Automatically disabled when all propeller engines are destroyed.
Default SAM Site Settings
| Setting | Default |
|---|---|
| Health | 1,000 HP |
| Rockets per SAM Site | 48 |
| Detection range | 150 meters |
| Damage multiplier | 1.0 |
| Time between volleys | 10 seconds |
| Destructible | Yes |
Tip
Raid Strategy
The carrier's SAM Sites make approaching by helicopter dangerous.
Destroy the propeller engines from a distance to disable the SAM defenses before attempting to land.
Scientist Guards
SkyCarrier includes armed scientists positioned throughout the carrier.
The default configuration contains eight scientist guards, including one Heavy Scientist. Guards are positioned to provide coverage of the carrier's flight deck and lower decks.
Guard Features
- Eight guards in the default layout.
- Configurable scientist spawn locations and rotations.
- Supports standard and Heavy Scientist prefabs.
- Custom health per scientist.
- Configurable weapons and clothing.
- Adjustable damage multiplier.
- Configurable target detection range.
- Individual patrol radius settings.
- Guards respond to nearby threats.
- Custom navigation data supports movement around the carrier.
Default Scientist Weapons
The default guards use a selection of Rust weapons, including:
- LR-300 Assault Rifle.
- MP5A4.
- M249.
- SPAS-12 Shotgun.
- Assault Rifle (AK).
| Guard Type | Default Health | Default Equipment |
|---|---|---|
| Regular Scientist | 250 HP | Configured firearms |
| Heavy Scientist | 500 HP | M249 |
Note
Scientist Navigation
SkyCarrier includes SkyCarrierNavMesh.json to support scientist movement around the custom carrier.
If the navigation file is missing, the plugin can still load, but scientist guards will remain stationary instead of using the custom navigation system.
Crash & Sinking System
Destroying all diesel generators triggers a scripted destruction sequence.
The carrier stops its normal flight, catches fire, and begins falling toward a suitable ocean location.
After reaching the water, the carrier crashes, settles, and begins sinking.
Crash Sequence
- Diesel generators are destroyed.
- Fire and explosion effects activate throughout the carrier.
- The carrier starts falling toward the ocean.
- The carrier impacts the water.
- The carrier settles after the initial impact.
- The final reward crate becomes available.
- Optional Chinook and rescue boat encounters begin.
- Players have a limited time to collect rewards and escape.
- The carrier gradually sinks beneath the water.
Crash Configuration
| Setting | Default |
|---|---|
| Target hull depth after impact | 8 meters |
| Evacuation time before sinking | 20 seconds |
| Sinking duration | 600 seconds |
| Keep Auto Turrets active after impact | No |
| Keep SAM Sites active after impact | No |
Note
Sinking Timing
The default configured sinking duration is 600 seconds (10 minutes).
The carrier also has a short settling period after impact and a configurable delay before sinking begins.
The plugin enforces a minimum sinking duration of 90 seconds.
Chinook Encounter
SkyCarrier includes an optional scripted Chinook sequence after the carrier crashes.
When enabled and a suitable SAM Site is available, a Chinook approaches the crashed carrier and can be shot down over the flight deck.
Chinook Features
- Optional Chinook arrival after the crash.
- Scripted helicopter approach.
- SAM Site aiming and missile effects.
- Chinook hit and crash animation.
- Explosion and wreck effects.
- Configurable crash position.
- Hackable locked crate after the Chinook crashes.
- Configurable hacking duration.
- Custom loot table for the Chinook crate.
| Setting | Default |
|---|---|
| Chinook encounter enabled | Yes |
| Locked crate hacking time | 300 seconds |
| Crate loot table | Elite |
Tip
Additional Reward
Players can start hacking the locked Chinook crate and return after the configured hacking time to collect its loot.
This creates an additional reward objective during the carrier's final phase.
Note
Chinook Spawn Conditions
The Chinook sequence requires a suitable approach route and an available SAM Site capable of participating in the scripted encounter.
If these conditions cannot be met, the Chinook sequence may be skipped.
Rescue Boat System
SkyCarrier includes optional rescue boats that arrive after the carrier has crashed.
These boats carry armed scientists that can board the carrier and engage players.
Rescue Features
- Configurable rescue boat arrival delay.
- Multiple boat docking positions.
- Uses Rust RHIB boats.
- Configurable scientists per boat.
- Armed rescue scientists.
- Custom scientist health, weapons, clothing, and damage.
- Animated boat approach and docking movement.
- Boarding ladders created beside the carrier.
- Scientists climb aboard and join the encounter.
- Boats can be released after their crews have disembarked.
Default Rescue Settings
| Setting | Default |
|---|---|
| Rescue boats enabled | Yes |
| Delay after crash | 30 seconds |
| Configured boats | 2 |
| Scientists per boat | 3 |
| Scientist health | 200 HP |
| Scientist weapon |
smg.mp5
|
| Detection range | 60 meters |
Tip
Example: Increase the number of scientists per boat from 3 to 5 for a more difficult final encounter.
You can also adjust rescue scientist health, weapon, damage, and patrol settings.
Loot & Rewards
SkyCarrier includes configurable loot containers positioned throughout the aircraft carrier.
The default configuration contains 11 loot containers, spread across the flight deck, interior areas, and multiple deck levels. Players can collect these while fighting through the carrier and receive additional rewards after bringing it down.
Loot Container Features
- Eleven default loot containers positioned throughout the carrier.
- Normal, Tools, and Elite crate prefabs.
- Configurable container positions and rotations.
- Multiple Military loot locations.
- Custom loot tables.
- Configurable item shortnames.
- Minimum and maximum item amounts.
- Individual item drop chances.
- Optional custom skin IDs.
- Additional destruction reward crate.
- Separate loot table for the locked Chinook crate.
Default Loot Tables
| Loot Table | Example Default Items |
|---|---|
| Standard | Scrap, Metal Pipes |
| Military | Assault Rifle, Rifle Ammo |
| Elite | Tech Trash, Rifle Bodies |
| Technical | Gears, CCTV Cameras |
| Special | Targeting Computers, Timed Explosives |
| Destruction | Scrap, Rockets, Tech Trash |
Final Destruction Reward
After the carrier crashes, a special reward crate appears on the flight deck.
The default destruction loot table contains:
| Item | Amount | Chance |
|---|---|---|
| Scrap | 500–800 | 100% |
| Rockets | 2–4 | 100% |
| Tech Trash | 10–20 | 100% |
Tip
Custom Rewards
You can edit the existing loot tables or create additional tables using the configuration.
Each loot entry supports a minimum amount, maximum amount, drop chance, and optional skin ID.
Note
Loot Notes
- The 11 regular loot containers are separate from the final destruction reward crate and the optional Chinook locked crate.
- The final reward crate is created after the carrier reaches the water.
- The Chinook locked crate is a separate optional reward.
- Loot containers use the plugin's configured loot tables rather than relying on normal container loot spawning.
-
Opening the final destruction reward crate triggers the
OnSkyCarrierEventWinnerhook.
Map Markers & Event Guidance
SkyCarrier includes optional systems to help players locate the event and understand its objectives.
Map Markers
- Displays the carrier's location on the Rust map.
- Marker follows the moving carrier.
- Configurable marker name.
- Configurable marker color.
- Displays the current carrier event stage.
- Automatically removes markers when the event ends.
Default marker name: SKY CARRIER
Default marker color: #E67E22
Objective Guidance
SkyCarrier can display temporary in-world guidance markers to help nearby players locate important objectives.
- Propeller-engine targets.
- Diesel generator targets.
- Important access areas.
- Final destruction reward crate.
- Locked Chinook crate.
Guidance symbols are displayed to nearby players within the supported guidance range.
Note
Default Settings
- Map markers are enabled.
- Nearby objective guidance is enabled.
- Event announcements are enabled.
- Event HUD is enabled.
Each system can be disabled separately in the configuration.
Event HUD
SkyCarrier includes an in-game event HUD that updates as players progress through the raid.
The HUD helps players identify their next objective and monitor the remaining event time.
HUD Features
- Displays the current raid objective.
- Shows destroyed engine progress.
- Shows destroyed generator progress.
- Displays the event timer.
- Displays the time until impact during the crash sequence.
- Shows the remaining evacuation time.
- Displays the sinking countdown.
- Updates objectives as the event progresses.
- Automatically appears for nearby players.
- Automatically disappears when players leave the event area or the event ends.
Event HUD Objectives
| Event Stage | HUD Objective |
|---|---|
| Flight | Destroy the propeller engines. |
| Carrier Disabled | Destroy the diesel generators. |
| Falling | Carrier falling. Brace for impact. |
| Impact Recovery | Head up to the flight deck. |
| Evacuation | Get clear of the lower decks. |
| Chinook Arrival | Chinook approaching the carrier. |
| Chinook Crash | Chinook hit. Clear the flight deck. |
| Final Phase | Loot the flight deck and evacuate. |
Tip
Player Experience
The HUD updates automatically as players complete raid objectives, so players can follow the event without needing chat commands or an external guide.
Event Scheduling
SkyCarrier can be started manually by an administrator or automatically using the built-in event scheduler.
| Setting | Default |
|---|---|
| Automatic events | Disabled |
| Delay before next automatic event | 7,200 seconds |
| Airborne event time limit | 1,800 seconds |
Scheduling Features
- Enable or disable automatic events.
- Configure the delay before the next event.
- Configurable airborne event time limit.
- Prevents multiple simultaneous SkyCarrier events.
- Automatically schedules another event after the previous event ends when scheduling is enabled.
- Manual commands for starting and stopping events.
Note
Default Behavior
Automatic events are disabled by default.
To run SkyCarrier automatically, enable [Schedule] Start events automatically in the configuration.
The default interval is 7200 seconds (2 hours), and the default airborne event time limit is 1800 seconds (30 minutes).
Admin Commands
SkyCarrier uses console commands for event management.
skycarrier.start - Starts a SkyCarrier event.
skycarrier.stop - Stops the currently active SkyCarrier event.
Command Examples
skycarrier.start skycarrier.stop
Note
Command Notes
- These are console commands, not chat commands.
- Commands can be executed through the server console.
- Authorized players can also use them through the in-game F1 console.
- Stopping an event manually sends a dedicated event-ended announcement when chat announcements are enabled.
- Only one SkyCarrier event can be active at a time.
- Starting an event requires valid carrier model data and a suitable flight route.
Permissions
skycarrier.admin - Allows authorized players to start and stop SkyCarrier events using the console commands.
Rust server admins can also manage the event without being granted the permission separately.
Players do not need permissions to participate in the event, attack the carrier, fight scientists, or collect loot.
Installation
SkyCarrier supports Rust servers running Oxide (uMod) or Carbon.
The ZIP includes three plugin files:
-
SkyCarrier.cs- Main plugin file. -
data/SkyCarrier/SkyCarrier.json- Required aircraft carrier model data. -
data/SkyCarrier/SkyCarrierNavMesh.json- Navigation data for scientist movement.
Installation Steps
- Extract the downloaded SkyCarrier ZIP archive.
-
Upload
SkyCarrier.csto your server's plugin folder:-
Oxide:
oxide/plugins/ -
Carbon:
carbon/plugins/
-
Oxide:
-
Upload
SkyCarrier.jsonandSkyCarrierNavMesh.jsonto your server's data folder:-
Oxide:
oxide/data/SkyCarrier/ -
Carbon:
carbon/data/SkyCarrier/
-
Oxide:
-
Make sure both data files are located inside the
SkyCarrierfolder. - Load or reload the SkyCarrier plugin.
-
Edit the generated configuration:
-
Oxide:
oxide/config/SkyCarrier.json -
Carbon:
carbon/configs/SkyCarrier.json
-
Oxide:
-
Configure automatic scheduling if you want events to start automatically, or use
skycarrier.startto begin an event manually.
Oxide File Structure
oxide/
├── plugins/
│ └── SkyCarrier.cs
├── data/
│ └── SkyCarrier/
│ ├── SkyCarrier.json
│ └── SkyCarrierNavMesh.json
└── config/
└── SkyCarrier.json
Carbon File Structure
carbon/
├── plugins/
│ └── SkyCarrier.cs
├── data/
│ └── SkyCarrier/
│ ├── SkyCarrier.json
│ └── SkyCarrierNavMesh.json
└── configs/
└── SkyCarrier.json
Warning
Important Installation Requirement
The SkyCarrier.json data file is required for the plugin to function.
It contains the custom aircraft carrier model and entity positions. If this file is missing, the plugin will report an error and unload.
The SkyCarrierNavMesh.json file contains navigation data for scientist movement. The plugin can load without it, but scientist guards will remain stationary.
Install both supplied data files for the complete SkyCarrier experience.
Example Configuration
The following configuration includes SkyCarrier's default settings, including eight scientist guard positions, eleven carrier loot containers, and the Config Version field.
{ "Event Settings": { "[Schedule] Start events automatically": false, "[Schedule] Delay before the next automatic event (seconds)": 7200.0, "Time limit while the carrier is airborne (seconds)": 1800.0 }, "Carrier Flight Settings": { "[Flight] Minimum height above terrain or sea (meters)": 120.0, "[Flight] Speed (meters per second)": 12.0, "[Flight] Turn speed (degrees per second)": 15.0, "[Route] Wait at each checkpoint (seconds)": 60.0, "[Route] Repeat after the last checkpoint": true, "[Route] Clearance from Deep Sea and its portals (meters)": 400.0, "[Route] Spawn coordinates (0, 0, 0 = automatic)": { "x": 0, "y": 0, "z": 0 }, "[Route] Checkpoint coordinates (empty = automatic offshore route)": [] }, "Propeller Engine Settings": { "Health per target (HP)": 750.0, "[Damage] Hit radius (meters)": 6.0, "[Damage] Multipliers by damage type (1 = full damage)": { "Explosion": 1.0, "AntiVehicle": 1.0, "Bullet": 0.02 }, "Target positions relative to the carrier": [ { "x": 8.06, "y": 3, "z": 14.05 }, { "x": -8.03, "y": 3, "z": 14.05 }, { "x": 8.06, "y": 3, "z": -11.78 }, { "x": -8.03, "y": 3, "z": -11.78 } ] }, "Diesel Generator Settings": { "Health per target (HP)": 900.0, "[Damage] Hit radius (meters)": 3.6, "[Damage] Multipliers by damage type (1 = full damage)": { "Explosion": 1.0 }, "Target positions relative to the carrier": [ { "x": -3.87, "y": 11.12, "z": -17.5 }, { "x": 0.57, "y": 11.12, "z": -17.5 } ] }, "Crash and Sinking Settings": { "Target hull depth after impact (meters)": 8.0, "Time to evacuate before sinking starts (seconds)": 20.0, "Time to fully sink (seconds, minimum 90)": 600.0, "Keep Auto Turrets active after impact": false, "Keep SAM Sites active after impact": false, "Fire positions relative to the carrier": [ { "x": -3.92, "y": 14.04, "z": -21.15 }, { "x": 6.08, "y": 14.03, "z": -3.15 }, { "x": -0.92, "y": 14.03, "z": 21.85 } ] }, "Chinook Settings": { "Send a Chinook after the carrier crashes": true, "Chinook crash position relative to the carrier": { "x": -6.92, "y": 14.05, "z": 8.85 }, "Time to hack the Chinook crate (seconds)": 300.0, "Locked crate": { "Container prefab path": "assets/prefabs/deployable/chinooklockedcrate/codelockedhackablecrate.prefab", "Loot table name": "Elite", "Position relative to the carrier": { "x": -2.92, "y": 14.03, "z": 8.85 }, "Rotation around Y (degrees)": 0.0 } }, "Rescue Boat Settings": { "Send rescue boats after the carrier crashes": true, "Delay before sending rescue boats (seconds)": 30.0, "Scientists per boat": 3, "Boat docking and boarding positions": [ { "Docking position relative to the carrier": { "x": -15.4, "y": 0, "z": 2 }, "Ladder top position relative to the carrier": { "x": -13.5, "y": 15.2, "z": 2 }, "Boat and ladder heading relative to the carrier (degrees)": 270.0 }, { "Docking position relative to the carrier": { "x": 15.4, "y": 0, "z": 2 }, "Ladder top position relative to the carrier": { "x": 13.5, "y": 15.2, "z": 2 }, "Boat and ladder heading relative to the carrier (degrees)": 90.0 } ], "Rescue scientist": { "Scientist prefab path": "assets/rust.ai/agents/npcplayer/humannpc/scientist/scientistnpc_cargo.prefab", "Health (HP)": 200.0, "Weapon shortname": "smg.mp5", "Clothing item shortnames": [ "hazmatsuit_scientist" ], "Damage multiplier": 1.0, "Target detection radius (meters)": 60.0, "Patrol radius (meters, 0 = no patrol)": 10.0 } }, "Defense Settings": { "Auto Turrets": { "Health (HP)": 1000.0, "Weapon shortname": "rifle.ak", "Ammo shortname": "ammo.rifle", "Rounds per turret": 512, "Target detection radius (meters)": 45.0, "Damage multiplier": 1.0, "Players can destroy turrets": true, "Turret placements": [ { "Position relative to the carrier": { "x": -10.36, "y": 24.86, "z": -2.48 }, "Rotation around Y (degrees)": 315 }, { "Position relative to the carrier": { "x": -5.1, "y": 24.86, "z": -2.47 }, "Rotation around Y (degrees)": 45 }, { "Position relative to the carrier": { "x": -10.35, "y": 24.86, "z": -11.93 }, "Rotation around Y (degrees)": 225 }, { "Position relative to the carrier": { "x": -5.09, "y": 24.86, "z": -11.92 }, "Rotation around Y (degrees)": 135 }, { "Position relative to the carrier": { "x": -11.39, "y": 14, "z": 21.61 }, "Rotation around Y (degrees)": 315 }, { "Position relative to the carrier": { "x": 11.39, "y": 14, "z": 21.62 }, "Rotation around Y (degrees)": 45 }, { "Position relative to the carrier": { "x": 11.4, "y": 14, "z": -17.71 }, "Rotation around Y (degrees)": 135 }, { "Position relative to the carrier": { "x": -7.34, "y": 14.01, "z": -33.09 }, "Rotation around Y (degrees)": 225 } ] }, "SAM sites": { "Health (HP)": 1000.0, "Rockets per SAM Site": 48, "Target detection radius (meters)": 150.0, "Damage multiplier": 1.0, "Time between volleys (seconds)": 10.0, "Players can destroy SAM Sites": true, "SAM Site placements": [ { "Position relative to the carrier": { "x": -11.58, "y": 21.11, "z": 0.15 }, "Rotation around Y (degrees)": 180 }, { "Position relative to the carrier": { "x": -11.58, "y": 21.11, "z": -19.35 }, "Rotation around Y (degrees)": 0 } ] }, "Scientist Guards": { "Clothing item shortnames": [ "hazmatsuit_scientist" ], "Damage multiplier": 1.0, "Target detection radius (meters)": 70.0, "Scientist spawn points": [ { "Scientist prefab path": "assets/rust.ai/agents/npcplayer/humannpc/scientist/scientistnpc_cargo.prefab", "Position relative to the carrier": { "x": -11.85, "y": 14.05, "z": -17.15 }, "Rotation around Y (degrees)": 0, "Health (HP)": 250, "Weapon shortname": "rifle.lr300", "Patrol radius (meters, 0 = no patrol)": 0.0 }, { "Scientist prefab path": "assets/rust.ai/agents/npcplayer/humannpc/scientist/scientistnpc_cargo.prefab", "Position relative to the carrier": { "x": 10.15, "y": 14.04, "z": -11.15 }, "Rotation around Y (degrees)": 180, "Health (HP)": 250, "Weapon shortname": "smg.mp5", "Patrol radius (meters, 0 = no patrol)": 3 }, { "Scientist prefab path": "assets/rust.ai/agents/npcplayer/humannpc/scientist/scientistnpc_heavy.prefab", "Position relative to the carrier": { "x": -5.85, "y": 14.05, "z": 18.85 }, "Rotation around Y (degrees)": 180, "Health (HP)": 500, "Weapon shortname": "lmg.m249", "Patrol radius (meters, 0 = no patrol)": 0.0 }, { "Scientist prefab path": "assets/rust.ai/agents/npcplayer/humannpc/scientist/scientistnpc_cargo.prefab", "Position relative to the carrier": { "x": -8, "y": 9.74, "z": -11 }, "Rotation around Y (degrees)": 0, "Health (HP)": 250, "Weapon shortname": "shotgun.spas12", "Patrol radius (meters, 0 = no patrol)": 0.0 }, { "Scientist prefab path": "assets/rust.ai/agents/npcplayer/humannpc/scientist/scientistnpc_cargo.prefab", "Position relative to the carrier": { "x": 3.25, "y": 9.74, "z": -15.5 }, "Rotation around Y (degrees)": 270, "Health (HP)": 250, "Weapon shortname": "rifle.ak", "Patrol radius (meters, 0 = no patrol)": 0.0 }, { "Scientist prefab path": "assets/rust.ai/agents/npcplayer/humannpc/scientist/scientistnpc_cargo.prefab", "Position relative to the carrier": { "x": 11.8277016, "y": 9.738968, "z": -1.47917366 }, "Rotation around Y (degrees)": 357.310181, "Health (HP)": 250, "Weapon shortname": "smg.mp5", "Patrol radius (meters, 0 = no patrol)": 3 }, { "Scientist prefab path": "assets/rust.ai/agents/npcplayer/humannpc/scientist/scientistnpc_cargo.prefab", "Position relative to the carrier": { "x": -2.014122, "y": 9.775375, "z": 21.6028633 }, "Rotation around Y (degrees)": 272.125122, "Health (HP)": 250, "Weapon shortname": "smg.mp5", "Patrol radius (meters, 0 = no patrol)": 3 }, { "Scientist prefab path": "assets/rust.ai/agents/npcplayer/humannpc/scientist/scientistnpc_cargo.prefab", "Position relative to the carrier": { "x": -12.2132111, "y": 9.738983, "z": 3.54932451 }, "Rotation around Y (degrees)": 176.950241, "Health (HP)": 250, "Weapon shortname": "rifle.ak", "Patrol radius (meters, 0 = no patrol)": 0.0 } ] } }, "Loot Settings": { "Loot containers on the carrier": [ { "Container prefab path": "assets/bundled/prefabs/radtown/crate_normal.prefab", "Loot table name": "Standard", "Position relative to the carrier": { "x": 11.15, "y": 14.04, "z": -3.15 }, "Rotation around Y (degrees)": 0.0 }, { "Container prefab path": "assets/bundled/prefabs/radtown/crate_tools.prefab", "Loot table name": "Technical", "Position relative to the carrier": { "x": -9.85, "y": 14.04, "z": 2.15 }, "Rotation around Y (degrees)": 0.0 }, { "Container prefab path": "assets/bundled/prefabs/radtown/crate_normal.prefab", "Loot table name": "Military", "Position relative to the carrier": { "x": 8.488968, "y": 9.765045, "z": -17.856781 }, "Rotation around Y (degrees)": 269.978638 }, { "Container prefab path": "assets/bundled/prefabs/radtown/crate_tools.prefab", "Loot table name": "Technical", "Position relative to the carrier": { "x": -12, "y": 9.74, "z": 10.5 }, "Rotation around Y (degrees)": 0.0 }, { "Container prefab path": "assets/bundled/prefabs/radtown/crate_elite.prefab", "Loot table name": "Special", "Position relative to the carrier": { "x": 6.5, "y": 9.74, "z": 21.5 }, "Rotation around Y (degrees)": 0.0 }, { "Container prefab path": "assets/bundled/prefabs/radtown/crate_elite.prefab", "Loot table name": "Elite", "Position relative to the carrier": { "x": -7.487793, "y": 24.9207, "z": -9.877808 }, "Rotation around Y (degrees)": 281.183716 }, { "Container prefab path": "assets/bundled/prefabs/radtown/crate_normal.prefab", "Loot table name": "Military", "Position relative to the carrier": { "x": -12.2138433, "y": 9.738968, "z": -16.3810635 }, "Rotation around Y (degrees)": 88.76069 }, { "Container prefab path": "assets/bundled/prefabs/radtown/crate_normal.prefab", "Loot table name": "Military", "Position relative to the carrier": { "x": 10.8315735, "y": 14.0387726, "z": 17.7017517 }, "Rotation around Y (degrees)": 268.3587 }, { "Container prefab path": "assets/bundled/prefabs/radtown/crate_normal.prefab", "Loot table name": "Military", "Position relative to the carrier": { "x": -8.18263149, "y": 21.3103485, "z": -19.04141 }, "Rotation around Y (degrees)": 359.363129 }, { "Container prefab path": "assets/bundled/prefabs/radtown/crate_normal.prefab", "Loot table name": "Military", "Position relative to the carrier": { "x": 0.1668787, "y": 9.740532, "z": -15.1512032 }, "Rotation around Y (degrees)": 357.473053 }, { "Container prefab path": "assets/bundled/prefabs/radtown/crate_normal.prefab", "Loot table name": "Military", "Position relative to the carrier": { "x": 11.5302668, "y": 9.738998, "z": 3.10289 }, "Rotation around Y (degrees)": 87.87798 } ], "Loot tables": { "Standard": [ { "Item shortname": "scrap", "Minimum amount": 100, "Maximum amount": 200, "Chance to include this item (0 to 100%)": 100.0, "Skin ID": 0 }, { "Item shortname": "metalpipe", "Minimum amount": 5, "Maximum amount": 10, "Chance to include this item (0 to 100%)": 100.0, "Skin ID": 0 } ], "Military": [ { "Item shortname": "rifle.ak", "Minimum amount": 1, "Maximum amount": 1, "Chance to include this item (0 to 100%)": 100.0, "Skin ID": 0 }, { "Item shortname": "ammo.rifle", "Minimum amount": 64, "Maximum amount": 128, "Chance to include this item (0 to 100%)": 100.0, "Skin ID": 0 } ], "Elite": [ { "Item shortname": "techparts", "Minimum amount": 5, "Maximum amount": 10, "Chance to include this item (0 to 100%)": 100.0, "Skin ID": 0 }, { "Item shortname": "riflebody", "Minimum amount": 2, "Maximum amount": 4, "Chance to include this item (0 to 100%)": 100.0, "Skin ID": 0 } ], "Technical": [ { "Item shortname": "gears", "Minimum amount": 5, "Maximum amount": 10, "Chance to include this item (0 to 100%)": 100.0, "Skin ID": 0 }, { "Item shortname": "cctv.camera", "Minimum amount": 1, "Maximum amount": 2, "Chance to include this item (0 to 100%)": 100.0, "Skin ID": 0 } ], "Special": [ { "Item shortname": "targeting.computer", "Minimum amount": 1, "Maximum amount": 2, "Chance to include this item (0 to 100%)": 100.0, "Skin ID": 0 }, { "Item shortname": "explosive.timed", "Minimum amount": 1, "Maximum amount": 1, "Chance to include this item (0 to 100%)": 25, "Skin ID": 0 } ], "Destruction": [ { "Item shortname": "scrap", "Minimum amount": 500, "Maximum amount": 800, "Chance to include this item (0 to 100%)": 100.0, "Skin ID": 0 }, { "Item shortname": "ammo.rocket.basic", "Minimum amount": 2, "Maximum amount": 4, "Chance to include this item (0 to 100%)": 100.0, "Skin ID": 0 }, { "Item shortname": "techparts", "Minimum amount": 10, "Maximum amount": 20, "Chance to include this item (0 to 100%)": 100.0, "Skin ID": 0 } ] }, "Reward crate after the carrier crashes": { "Container prefab path": "assets/bundled/prefabs/radtown/crate_elite.prefab", "Loot table name": "Destruction", "Position relative to the carrier": { "x": -0.08, "y": 14.13, "z": 0.15 }, "Rotation around Y (degrees)": 0.0 } }, "Notification Settings": { "[Chat] Send event announcements": true, "[Map] Show the carrier marker": true, "[Map] Carrier marker name": "SKY CARRIER", "[Map] Carrier marker color (HTML hex)": "#E67E22", "[Guidance] Show nearby objectives and loot": true, "[HUD] Show the event HUD to nearby players": true }, "Config Version": { "Major": 1, "Minor": 0, "Patch": 0 } }
Note
Configuration Notes
- Event Settings: Configure automatic event scheduling and the airborne event time limit.
- Carrier Flight Settings: Configure altitude, speed, turning, checkpoints, route looping, spawn coordinates, and Deep Sea clearance.
- Propeller Engine Settings: Configure engine health, damage types, hit radius, and target positions.
- Diesel Generator Settings: Configure generator health, explosive damage, hit radius, and target positions.
- Crash and Sinking Settings: Configure impact depth, evacuation delay, sinking duration, post-crash defenses, and fire positions.
- Chinook Settings: Configure the optional Chinook sequence, crash position, hacking time, and locked crate.
- Rescue Boat Settings: Configure rescue boat arrivals, scientist counts, docking positions, and NPC behavior.
- Defense Settings: Configure eight Auto Turrets, two SAM Sites, and eight scientist guards.
- Loot Settings: Configure eleven carrier loot containers, custom loot tables, and the final destruction reward.
- Notification Settings: Configure chat announcements, map markers, guidance symbols, and the event HUD.
- Config Version: Stores the plugin's configuration version.
Developer Hooks & API
SkyCarrier provides hooks that other plugins can use to respond to event activity.
OnSkyCarrierEventStart
Called when the carrier is fully spawned and the event begins.
void OnSkyCarrierEventStart(BaseEntity carrier, Vector3 position)
OnSkyCarrierEventEnd
Called when an active SkyCarrier event ends.
void OnSkyCarrierEventEnd()
OnSkyCarrierEventWinner
Called when a player opens the final destruction reward crate for the first time.
void OnSkyCarrierEventWinner(BasePlayer player)
API_IsEventActive
Allows another plugin to check whether a SkyCarrier event is currently active.
bool API_IsEventActive()
Returns true when an event instance exists and false otherwise.
Note
Developer Integration
These hooks can be used for custom event notifications, statistics, progression systems, achievements, and other plugin integrations.
The winner hook is specifically triggered by opening the final destruction reward crate, rather than simply damaging or destroying the carrier.
Why Choose SkyCarrier?
Most Rust events take place at familiar monuments or involve enemies that players already know how to defeat. SkyCarrier brings an entirely different challenge to the server by transforming the sky into a dangerous, multi-stage raid environment.
Players must plan their approach, disable anti-air defenses, board a flying aircraft carrier, fight through armed scientists, destroy its generators, survive a dramatic ocean crash, and escape with valuable rewards before the carrier disappears beneath the waves.
With customizable flight routes, destructible objectives, multiple defense systems, animated crash sequences, optional Chinook and rescue encounters, custom loot tables, and an interactive event HUD, SkyCarrier gives server owners the tools to create a unique and memorable aerial raid event
