Checkpoint Event 1.0.0

Checkpoint Event

Checkpoint Event is a fully featured PvE event for Rust, transforming ordinary procedural roads into dangerous, heavily fortified military combat zones filled with valuable rewards.

During the event, a military checkpoint spawns on a randomly selected road section, protected by armed NPC guards, snipers, auto-turrets, and occasionally a Patrol Helicopter. The encounter is driven by a new dynamic Difficulty System, meaning the size of the base layout, the number of guards, the presence of a helicopter, and the final loot will scale based on the randomly selected difficulty.

Players must breach the perimeter, fight through the defenders, and loot the crates. The event utilizes a unique Competitive Scoring System: players earn points for killing NPCs, destroying turrets and helicopters, and looting crates. The event is successfully completed only when all guards are eliminated and every crate is looted. The player with the highest score at the end of the event is declared the winner!

This creates an intense PvE and PvP experience where players must fight not only the military but potentially each other for the highest score.

Features

• Random road location selection (automatically avoids monuments).
• 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 dictates its own base layout size (Small, Medium, Large), guard counts, crate quantities (Regular, Military, Elite), loot tables, and whether a Patrol Helicopter spawns.
• Competitive Scoring System: Awards points to players for specific actions (kills, looting).
• Custom Defenses: Checkpoints are fortified with high stone walls, gates, watchtowers, sandbags, and auto-turrets deployed on junkpiles.
• 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.
• Dynamic Map Markers: Vending machine and radius markers displaying a live countdown timer until the event expires.
• Automatic event completion once all NPCs are cleared and all crates are fully looted.
• Automatic event scheduling and cleanup timers.
• Manual event control through chat and console commands.
• Oxide permission support.
• Fully configurable through the configuration file.

Commands

/checkpoint start [difficulty] - Chat command

checkpointevent start [difficulty] - Console command

Starts the event. You can optionally specify a difficulty name (e.g., Easy, Normal) to force a specific tier.

/checkpoint stop - Chat command

checkpointevent stop - Console command

Stops and completely despawns the currently active event.

Permissions

checkpoint.admin

(Used only when permission checks are enabled in the config to control who can manually start/stop the event).

API & Hooks

Checkpoint Event provides API hooks that allow server owners and developers to easily integrate the event with external UI plugins, custom reward managers, or economy systems:

• OnCheckpointEventStarted - Called when the checkpoint event successfully spawns on the map.
• OnCheckpointEventStopped - Called when the event is forcefully stopped or cleaned up.
• OnCheckpointEventCompleted(BasePlayer winner, string difficultyName) - Called when the event is successfully completed (all guards dead, all crates looted). Returns the player with the highest score and the name of the completed difficulty.

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, layouts, and helicopter presence).
• Difficulty-Specific Loot Tables: Complete loot control per crate type (Regular, Military, Elite) per difficulty (item amounts, drop chances, and skin IDs).
• Scoring Values: Adjust how many points players receive for killing NPCs, turrets, helicopters, and looting crates.
• Chat & UI Customization: Chat Prefix settings and Notify Information Type ID support.
• Automatic event interval & Event lifetime.
• Map marker radius and names.
• Guard & Sniper NPC 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 looting restrictions, and owner status settings directly through the plugin configuration file.

Dependencies Required Dependency:

NPC Spawn: Checkpoint Event requires the NPC Spawn plugin to function. The event relies on it to spawn all NPC guards and snipers. Without NPC Spawn, the plugin will not work.

Note: You must configure your own NPC presets or use default ones in the NpcSpawn data folder that match the preset names defined in the Checkpoint config.



TELEGRAM CHANNEL