Changelog

v1.0.0 — Initial Release

⚔️ Clan System

• Create and disband clans with unique name and tag
• Configurable name length (3-16) and tag length (2-5)
• Optional creation cost via Vault economy
• YAML-based persistent data storage

👥 Role Hierarchy

• Three-tier role system: Leader, Officer, Member
• Promote and demote members
• Transfer leadership to another member
• Role-based permission checks for all actions

🖥️ GUI Menu

• Full interactive inventory menu via /clan
• Main menu with clan overview and action buttons
• Members list with player heads and role indicators
• Top clans leaderboard view
• Dynamic button visibility based on player role
• Glass pane border styling

💬 Clan Chat

• Private messaging channel for clanmates
• Toggle mode with /clan chat
• Direct message mode with /clan chat <message>
• Automatic clan tag prefix in global chat

💰 Economy

• Clan bank system with player deposits
• Level-up costs paid from clan bank
• Vault integration for creation costs and deposits
• Works without Vault installed

📈 Leveling

• 10-level progression system
• Configurable cost per level in config.yml
• Additional member slots per level (default +3)
• Level-up broadcasts to all clan members

⚔️ PvP Protection

• Toggleable friendly fire per clan
• Blocks melee and projectile damage between clanmates
• Leader-only toggle control

📊 Statistics

• Automatic kill and death tracking per clan
• K/D ratio calculation
• Displayed in info, GUI, and placeholders

🔗 PlaceholderAPI

• 15 placeholders covering all clan data
• Supports offline player lookups
• Persistent expansion registration

📨 Invite System

• Invite online players to your clan
• Configurable timeout (default 60 seconds)
• Accept and deny commands
• Full member cap enforcement

🔧 Configuration

• config.yml for all gameplay settings
• messages.yml for every message, label, and GUI string
• Placeholder support in messages with {prefix}, {name}, {player}, etc.

📋 Commands

• /clan — Open GUI menu
• /clan create <name> <tag> — Create clan
• /clan disband — Disband clan
• /clan invite <player> — Invite player
• /clan accept / /clan deny — Handle invitations
• /clan leave — Leave clan
• /clan kick <player> — Kick member
• /clan promote <player> — Promote to Officer
• /clan demote <player> — Demote to Member
• /clan setleader <player> — Transfer leadership
• /clan info [clan] — View clan info
• /clan list — List all clans
• /clan top — Top clans leaderboard
• /clan chat [message] — Clan chat
• /clan desc <text> — Set description
• /clan pvp — Toggle friendly fire
• /clan deposit <amount> — Deposit to bank
• /clan levelup — Level up clan
• /clan help — Help page
• Full tab completion for all subcommands and arguments
• Aliases: /clans, /c

🔌 Compatibility

• Minecraft 1.21+
• Java 21+
• Soft depends: Vault, PlaceholderAPI