Clan Warfare

Works with

Clans

Clans REBORN

Clans

About Clan Warfare

Overview

Clan Warfareis a clan tracking and leaderboard system for Rust servers that transforms clan warfare into a competitive, point-based experience. The plugin tracks kills, deaths, and TC raids across all clans, featuring a registration system where clans protect their Tool Cupboards, a dynamic GUI leaderboard, and an engaging points economy that rewards PvP dominance and successful raids.

When a clan's registered TC is destroyed, they lose all points, and the raiding clan claims those points plus a raid bonus. This creates high-stakes territorial warfare where every TC matters and every raid can dramatically shift the leaderboard rankings.

Key Features

TC Registration System: Each clan can register one Tool Cupboard as their "core" - their most valuable asset
Comprehensive Stat Tracking: Automatically tracks kills, deaths, and successful TC raids for every clan
Dynamic Points Economy:
- Earn points for kills (configurable, default: 100 points)
- Earn massive points for raids (configurable base: 1000 points + all points from raided clan)
- Lose ALL points when your registered TC is destroyed
Beautiful GUI Leaderboard: Interactive in-game leaderboard with real-time updates, color-coded rankings, and TC registration indicators
Smart Caching System: High-performance caching for leaderboards and clan lookups reduces server load
Discord Integration: Optional webhook notifications for major events (kills, raids) with rich embeds
Admin Tools: Comprehensive admin commands for managing clans, points, and TC registrations
Auto-Save: Configurable auto-save system with dirty flag tracking ensures data integrity
Clan Detection: Full integration with the Clans plugin for automatic clan identification

Config Example

PointsPerKill: Points awarded for killing enemy clan members
PointsPerRaid: Base points awarded for raiding a clan's TC (added to stolen points)
LeaderboardMaxEntries: Maximum clans shown on leaderboard
LeaderboardCacheTimeMinutes: How long to cache leaderboard data (improves performance)
AutoSaveIntervalMinutes: How often to auto-save data
TCDetectionRadius: Search radius for detecting who destroyed a TC
EnableDebugLogging: Enable detailed debug logs for troubleshooting
NotifyPlayersOnKills: Broadcast kill notifications in chat
NotifyPlayersOnRaids: Broadcast raid notifications to all players
UseDiscordWebhooks: Enable Discord webhook notifications
DiscordWebhookURL: Your Discord webhook URL

{
  "PointsPerKill": 100,
  "PointsPerRaid": 1000,
  "LeaderboardMaxEntries": 15,
  "LeaderboardCacheTimeMinutes": 5,
  "AutoSaveIntervalMinutes": 10.0,
  "TCDetectionRadius": 10.0,
  "EnableDebugLogging": false,
  "NotifyPlayersOnKills": true,
  "NotifyPlayersOnRaids": true,
  "UseDiscordWebhooks": true,
  "DiscordWebhookURL": "https://discord.com/api/webhooks/xxxx/yyyy"
}

Commands

Player Commands

/cc - Display help and available commands
/cc register - Register the TC you're looking at (must be authorized)
/cc stats [clan] - View detailed stats for your clan or specified clan
/cc top - View top 5 clans in chat
/cc leaderboard - Open the interactive GUI leaderboard

Admin Commands (Requires clancores.admin permission)

/ccadmin save - Force save all data immediately
/ccadmin reload - Reload configuration from file
/ccadmin resetcache - Clear leaderboard and clan caches
/ccadmin resetclan <clan> - Completely reset a clan's stats and TC registration
/ccadmin addpoints <clan> <amount> - Add or remove points from a clan
/ccadmin removetc <clan> - Remove a clan's TC registration

Requirements

Clans Plugin: Required for clan detection and integration
Rust Server: with Oxide/uMod framework

Permissions

clancores.use - Allows players to use basic commands (granted by default)
clancores.admin - Required for admin commands and data management

Support & Customization
For support, feature requests, custom modifications, or help with advanced setup, feel free to contact me via private message.