Subway Event 1.0.4

Subway Event

Subway Event is a fully featured PvE event for the Rust subway system, transforming ordinary underground tunnels into a dangerous combat zone filled with valuable rewards.

During the event, a Locked Crate randomly appears inside one of the subway tunnels, protected by armed NPC guards. Players must fight through the defenders, initiate the hack, and hold their position until the hacking process is complete.

However, surviving won't be easy.

While the crate is being hacked, suicide bombers periodically spawn and rush toward nearby players, attempting to explode and deal massive damage. If every player leaves the event area, a return timer begins. Failing to return before the timer expires will completely reset the event: the crate is recreated, all guards respawn, and the hacking process starts over from the beginning.

This creates an intense PvE experience where players must secure and defend the area until the very end.
 

Features

• Random subway tunnel location selection.
• Automatic Locked Crate spawning.
• Fully customizable crate loot.
• Option to remove the default crate loot.
• Automatic placement of barricades and environmental objects.
• Atmospheric smoke effects.
• Multiple groups of NPC guards.
• Dedicated suicide bomber NPCs that spawn in waves during the hack.
• Configurable bomber wave cooldown.
• Event zone monitoring.
• Players leaving the event area trigger a return countdown.
• Automatic event reset if no players return in time.
• Guard respawn after the event resets.
• Automatic event completion once the crate has been fully looted.
• Automatic event scheduling.
• Manual event control through chat commands.
• Map marker displaying the event location.
• Oxide permission support.
• Fully configurable through the configuration file.

Commands

/subway start - Chat  command
subwayevent start - Console command

Starts the event.

/subway stop - Chat  command
subwayevent stop - Console command

Stops the currently active event.

Permissions

subwayevent.admin

(Used only when permission checks are enabled.)

API & Hooks

SubwayEvent provides API hooks that allow server owners and developers to easily integrate the event with external UI plugins (like Server HUD), custom reward managers, or economy systems (Economics / ServerRewards):

• OnSubwayEventStarted - Called when the subway event successfully spawns.
• OnSubwayEventStopped - Called when the event is stopped or cleaned up.
• OnSubwayEventCompleted(BasePlayer player, HackableLockedCrate lootedCrate) - Called when a player successfully completes the event by looting the crate.

Localization

The plugin includes full localization support for:

English

Russian

All in-game messages are fully translated and automatically displayed according to the server language.

Configuration

The configuration file allows you to customize almost every aspect of the event, including:

• Automatic event interval.
• Event lifetime.
• Crate hacking duration.
• Maximum allowed distance from the crate during hacking.
• Time allowed for players to return to the event area.
• Map marker radius.
• Enable or disable NPC spawning.
• Guard NPC presets.
• Suicide bomber NPC preset.
• Bomber wave spawn interval.
• Option to remove the default crate loot.
• Complete loot table including item amounts, drop chances, and skin IDs.
• Permission requirement for chat commands.

CONFIG EXAMPLE

PvE Mode Support

The plugin features full built-in compatibility with PveMode. When PveMode is installed on your server, the event automatically generates a dedicated PVE zone upon spawning. You can fully customize all PVE rules, permissions, damage scaling, crate hacking restrictions, and owner status settings directly through the plugin configuration file.

Dependencies

Required Dependency:

• NPC Spawn

Subway Event requires the NPC Spawn plugin to function. The event relies on it to spawn all NPC guards and bomber units. Without NPC Spawn, the plugin will not work.

The plugin package includes a set of ready-to-use NPC presets located inside the Data/Presets folder. These presets are fully configured and can be used immediately after installation.

Server owners can freely modify these presets using the built-in functionality provided by NPC Spawn, allowing them to customize equipment, behavior, health, weapons, and other NPC properties to better fit their server.



TELEGRAM CHANNEL