Subway Event 1.0.7

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. The encounter is driven by a new dynamic Difficulty System, meaning the number of guards, bomber frequency, hacking time, and the final loot will scale based on the randomly selected difficulty. 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.
• Dynamic Expandable Difficulty System (Easy, Normal, Hard, Nightmare by default, but completely customizable — add, remove, or edit as many levels as you want!).
• Difficulty-based Scaling: Each difficulty has its own chance to roll, guard/bomber counts, bomber damage, hack time, and custom loot table.
• Dynamic NPC Spawning: Spawn as many NPC guards and bombers as you configure; the plugin dynamically distributes them along the tunnel.
• Notify Plugin Support for modern UI announcements.
• Customizable Chat Prefix with color support.
• Fully customizable crate loot per difficulty.
• 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.
• 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:

• Custom Difficulty Profiles (Add/Remove difficulties, adjust spawn chances).
• Difficulty-Specific Settings: Custom crate hacking duration, bomber wave intervals, bomber damage, armor calculations, and NPC limits for each difficulty.
• Difficulty-Specific Loot Tables: Complete loot control per difficulty (item amounts, drop chances, and skin IDs).
• Chat & UI Customization: Chat Prefix settings and Notify Information Type ID support.
• Automatic event interval & Event lifetime.
• Maximum allowed distance from the crate during hacking & Return timer.
• Map marker radius.
• Enable or disable NPC spawning globally.
• Guard NPC & Suicide Bomber presets.
• Option to remove the default crate loot.
• 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