SENTINELCLANS — Modern Clan Management Plugin for Competitive Minecraft Servers
SentinelClans is a powerful and fully GUI-driven clans plugin designed for competitive Survival, SMP, SkyBlock, PvP, Factions, and Lifesteal servers. Also can be good for DonutSMP, Donut survival servers.
Built for modern Paper, Spigot, Purpur, and Folia servers, SentinelClans provides advanced clan management, clan banking, seasonal leaderboards, clan duels, upgrades, diplomacy systems, and more —q all inside a sleek visual interface.
Whether you run a small SMP or a large competitive network, SentinelClans helps increase player retention by creating long-term progression and competitive gameplay loops.
WHY CHOOSE SENTINELCLANS?
On modern servers, retention is everything. Players lose interest when they run out of goals. SentinelClans transforms your competitive meta by creating a highly engaging, self-sustaining loop of cooperation, rivalry, and investment.
EXPLORE THE CORE PILLARS
Next-Gen Visual GUI Engine
- The Experience: 100% command-free navigation. Every interaction—from roster management, banking, upgrades, and settings—is controlled through an ultra-smooth, responsive GUI.
- Customization Ready: Full support for CustomModelData and custom resource packs. Transform the default dark-SaaS interface into a uniquely branded masterpiece. (CustomModelData is coming soon).
- Role Hierarchy: Define clear chains of command with dynamic roles (Leader, Co-Leader, Captain, Member, Recruit), complete with per-role permission toggles in-game.
Instanced Clan-vs-Clan Duels
- Settle the Score: Instantly launch team-based matches (1v1 to 10v10) inside custom-defined arenas.
- Zero Exploits: Ironclad WorldGuard/WorldEdit protection boundaries paired with dynamic kit loaders. Includes advanced anti-kill-farming parameters to prevent leaderboard manipulation.
- Tension & Spectacle: Keep inventory options, specialized particle trails, custom countdown systems, and dynamic holographic match-state indicators.
Clan Upgrades
Automated Seasonal Leaderboards
- Hands-Off Operation: Establish automated, recurring monthly tournament seasons.
- Dynamic Respect System: Clans earn or lose points based on PvP combat actions, formal duel victories, and custom server accomplishments.
- Secure Distribution: Automatic end-of-season reward distribution targeting up to 20 custom positions.
TECHNICAL SPECIFICATIONS & PERFORMANCE
SentinelClans is engineered for enterprise-grade performance, ensuring your main server thread remains completely unburdened.- Google Guice Architecture: Extremely robust, clean dependency injection designed for maximum stability.
- Non-Blocking Operations: All database queries (MySQL / MariaDB), leaderboard sorting algorithms, and auto-saves run asynchronously on background threads to maintain a stable 20.0 TPS.
- Cross-Version Material Support: Zero issues running across legacy blocks or modern items.
- Developer-First API: Clean event-handling API with comprehensive documentation to easily extend functionality with custom plugins. (Not open yet!)
Player Commands
Admin Commands
Detailed Node Specifications
- sentinelclans.use — Grants execution authorization for all safe informational sub-commands.
- sentinelclans.chat — Authorizes access to the isolated internal communications network channels.
- sentinelclans.create — Authorizes creating new clans based on server economy balances.
- sentinelclans.manage — Essential for custom role promotions, player ejections, and status alterations.
- sentinelclans.leader — Restricts extreme structural alterations (such as disbands, name changes, or alliances).
- sentinelclans.vault — Determines container accessibility parameters for members.
- sentinelclans.spy — Permits administrators to intercept hidden strategic operations chat logs.
- sentinelclans.admin — Complete structural immunity, bypassing all regional protection frameworks and configuration locks.
Core Clan Structural Placeholders
| Placeholder Identifier String | Data Profile Output | Typical Value Sample |
| %sentinelclans_has_clan% | Boolean verification check. | true / false |
| %sentinelclans_clan_name% | Returns regular text string name value. | Vanguard |
| %sentinelclans_clan_tag% | Returns fully processed HEX/RGB styled tag. | &x&7&F&0&0&0&0[VNG] |
| %sentinelclans_clan_role% | Outputs current internal standing identifier. | Co-Leader |
| %sentinelclans_clan_members_count% | Numeric calculation of total active roster pool. | 14 |
| %sentinelclans_clan_members_max% | Maximum capacity cap determined by store status. | 25 |
| %sentinelclans_clan_online_count% | Evaluates localized active network presence. | 6 |
| %sentinelclans_clan_balance% | Real-time pooled server cash value output. | 450,230.50$ |
| %sentinelclans_clan_balance_formatted% | Compressed currency rendering format. | $450.2K |
| %sentinelclans_clan_respect% | Numeric total score index points scale. | 1,420 |
| %sentinelclans_clan_kills% | Aggregated structural dynamic pvp kill tally. | 842 |
| %sentinelclans_clan_deaths% | Aggregated death metrics counter score. | 310 |
| %sentinelclans_clan_kdr% | Mathematical formula evaluation: $K \div D$. | 2.71 |
| %sentinelclans_clan_status% | Fetches custom-set leaderboard motto info. | Dominating the East Coast. |
| %sentinelclans_clan_base_coords% | Structural text locator readout. | X: 400, Z: -1200 |
| %sentinelclans_clan_allies_count% | Measures signed security coalition matrix count. | 2 |
| %sentinelclans_clan_truces_count% | Simple count of non-aggression treaties active. | 4 |
| %sentinelclans_clan_duel_wins% | Tracks confirmed match arena victories. | 34 |
| %sentinelclans_clan_duel_losses% | Tracks structural instances of failures in war. | 12 |
| %sentinelclans_clan_vault_pages% | Total unlocked storage layout pages. | 3 |
Seasonal Leaderboard Metric Hooks
| Placeholder Identifier String | Data Profile Output | Typical Value Sample |
| %sentinelclans_top_name_1% | Absolute top-rated group name identifier. | Imperium |
| %sentinelclans_top_tag_1% | Absolute top-rated group colored tag presentation. | [IMP] |
| %sentinelclans_top_respect_1% | Point index standing of the number 1 slot holder. | 15,400 |
| %sentinelclans_top_name_2% | Second-ranked competitor group name. | ShadowCorp |
| %sentinelclans_top_respect_2% | Point index standing of the number 2 slot holder. | 12,110 |
| %sentinelclans_top_name_3% | Third-ranked competitor group name. | Bloodline |
| %sentinelclans_top_respect_3% | Point index standing of the number 3 slot holder. | 9,850 |
| %sentinelclans_top_name_4% | Fourth-ranked competitor group name. | VoidWalkers |
| %sentinelclans_top_name_5% | Fifth-ranked competitor group name. | Onyx |
| %sentinelclans_server_rank% | Current player's clan rank position across network. | 12 |
SYSTEM ENVIRONMENT
- Software: Spigot, Paper, Purpur, or Folia clones 1.21.4+
- Runtime: Java 21 (Optimized for modern garbage collection)
- Storage: Multi-threaded MySQL / MariaDB or Local Optimized YAML/SQLITE
- Dependencies: Vault & PlaceholderAPI
- Optional Integrations: WorldGuard 7.0+ & WorldEdit 7.3+
