About RaidCupboardEvent
Raid Cupboard Event
Raid Cupboard Event is a dynamic competitive event plugin for Rust servers, designed for clans and teams. The plugin allows players to register Tool Cupboards from their bases as event objectives. Special markers appear on the map showing the locations of participating teams and their current scores, encouraging raids and active PvP across the entire map.
Teams earn points by raiding registered Tool Cupboards belonging to their opponents and move up the leaderboard. The plugin includes a built-in CUI leaderboard, flexible registration timing after a wipe, team size requirements, and protection against repeated registrations and abuse.
Main Features
- Automatic and Manual Registration: Team leaders can register their Tool Cupboards through the built-in CUI after the configured amount of time has passed since the wipe.
- Tournament System and Points: When an enemy event Tool Cupboard is destroyed, the attacking team receives points and increases its number of successfully raided cupboards.
- Interactive Map Markers:
- Vending Machine Marker: Displays the team name and its current score directly on the Rust map.
- Radius Marker: Highlights the area around the registered Tool Cupboard with configurable radius, color, and transparency.
- Built-in CUI Leaderboard: The /stats command opens an in-game leaderboard showing the top 3 teams on a podium, as well as a detailed list of all participating teams, their points, and the number of Tool Cupboards they have raided.
- Anti-Abuse Protection and Restrictions:
- Only the team leader can register a Tool Cupboard.
- Configurable minimum team size requirement (SelfRegMinTeamSize).
- Players cannot register Tool Cupboards that do not belong to their team.
- Player Registration Lock: Members of a registered team cannot participate again or register another Tool Cupboard while their current one is still active.
- The plugin tracks the last attacker for up to 30 seconds after an attack, ensuring that points are awarded only to actual player raiders.
- Notifications and Flexible Messaging: Supports chat messages with a custom SteamID avatar and Facepunch GameTip notifications. Notification settings can be overridden individually for different event types.
-
Data Persistence: Tool Cupboard data, scores, and wipe time are automatically saved and restored after a server or plugin restart.
Commands
Player Commands
/stats — Opens the CUI leaderboard and team statistics menu.
/regcupboard <name> — Registers the Tool Cupboard the player is currently looking at. This can be used as an alternative to the CUI registration button.
Admin Commands
/addcupboard <name> — Force-registers the Tool Cupboard the administrator is currently looking at.
/removecupboard — Removes event status from the Tool Cupboard the administrator is currently looking at, including its markers and controller.
/cupboardunlock <SteamID> — Removes the registration lock from the specified player, allowing them to register a new Tool Cupboard if the previous one was lost or removed.
Permissions
The plugin does not require any special Oxide permissions. Access to administrator commands is controlled by the standard Rust server administrator flag (player.IsAdmin).
Localization
The plugin includes complete localization files for Russian (ru) and English (en).
You can customize notification text, leaderboard column names, announcements, and other messages in the oxide/lang/ folder.
Plugin Config
en – example of plugin configuration in English
ru – example of plugin configuration in Russian
You can reach out to me in Discord: gaga407's Discord Profile
