ApexClan

ApexClan is a premium, feature-rich clan plugin designed with performance, scalability, and modern server needs in mind. Fully optimized for Folia multi-threaded environments and utilizing a high-performance SQLite/MySQL/PostgreSQL structure, ApexClan ensures your server remains lag-free while offering deep, engaging mechanics for your players.

## ⭐ Why Choose ApexClan?

🚀 Folia & Paper Native: Engineered from the ground up to support Folia's region-threaded tick loop. No main-thread blocks or lag spikes. 💾 WAL Optimized Hybrid Storage: Supports SQLite, MySQL, MariaDB, PostgreSQL, H2, and MongoDB. Uses Write-Ahead Logging (WAL) for SQLite to achieve lightning-fast concurrent operations. 📈 Dynamic Leveling System: Allow clans to gain XP through server activities, leveling up to unlock customizable rewards, higher member limits, and prestige. 🤝 Deep Diplomacy: Forge alliances or declare rivalries. Features a private Ally Chat for coordinated warfare. 🔒 Secure Entry Types: Clan leaders can set their entry type to `OPEN`, `INVITE_ONLY` (with a clean request-management GUI), or `PASSWORD` protected. 🗃️ Upgradable Shared Chest: Give clans a shared inventory that they can expand by purchasing more rows using clan funds. 🌍 Global Localization: Comes pre-translated in English, Turkish, Spanish, French, Russian, and Japanese. 💸 Integrated Clan Economy: A centralized clan bank system integrated with Vault. Deposit, withdraw, and purchase market items.

## 🛠️ Key Feature Breakdown

### 📊 Clan Progression & Leaderboards Clans earn XP dynamically. As the clan levels up, they climb the leaderboard (`/clan top`) and unlock upgrades in the clan market.

### 💼 GUI-Driven Settings & Management A beautiful, highly intuitive user interface allows leaders to change colors, rename the clan, update descriptions, set minimum kill requirements, toggle friendly fire (PvP), and transfer leadership without remembering complex commands.

### 🛡️ Built-in Security & Combat Prevention Prevents players from leaving clans, joining new ones, or using teleportation commands like `/clan home` while tagged in PvP combat.

### 🔗 Robust Developer API Integrate ApexClan into your own custom plugins using the robust `ClanService` API.

```java ClanService api = Bukkit.getServicesManager().load(ClanService.class);

// Check if a player is banned from a clan if (api.isBanned("LegendaryClan", playerUUID)) { // Custom logic }

// Deposit money to a clan api.addMoney("Warriors", 1000. 0); ```

## 📜 Commands & Permissions

### Player Commands (Base: `/clan` or `/c`)

| Command | Arguments | Description | | :--- | :--- | :--- | | `/clan help` | `` | View interactive help pages. | | `/clan create` | `` | Create a new clan. | | `/clan level` | - | Display XP progress bar for the current level. | | `/clan stats` | `` | View detailed stats (Kills, Deaths, KDR, Level). | | `/clan top` | - | Display top clans based on kills/level. | | `/clan list` | - | List all existing clans on the server. | | `/clan logs` | - | Open GUI to view recent clan history. | | `/clan chat` | - | Toggle between Global and Clan-only chat. | | `/clan allychat` | - | Toggle chat with all your allied clans. | | `/clan join` | `` | Join an open clan or send a request. | | `/clan leave` | - | Leave your current clan (Blocked in combat). | | `/clan kick` | `` | Remove a member from the clan. | | `/clan promote` | `` | Promote a member to Moderator. | | `/clan demote` | `` | Demote a Moderator back to Member. | | `/clan ban` | `` | Ban a player from joining your clan. | | `/clan unban` | `` | Remove a ban from a player. | | `/clan invite` | `` | Invite a player to join your clan. | | `/clan accept` | `` | Accept a join invitation or an ally request. | | `/clan deny` | `` | Reject a join invitation or an ally request. | | `/clan requests` | - | Open the GUI to manage pending join requests. | | `/clan bank` | `bal / dep / with` | Manage clan bank funds. | | `/clan chest` | `` | Open or upgrade shared chest storage. | | `/clan market` | - | Open the clan shop (XP/Money currency). | | `/clan home` | `` | Set or teleport to the clan base. | | `/clan manage` | - | Open the main settings GUI. | | `/clan pvp` | - | Toggle friendly-fire within the clan. | | `/clan transfer` | `` | Transfer ownership (irreversible). | | `/clan delete` | - | Disband the clan completely. |

### Admin Commands (Base: `/ca` or `/clanadmin` | Permission: `apex.clan.admin`)

`/ca reload` - Reload all configurations, markets, and languages. `/ca verify ` - Toggle Verified status (displays a crown icon next to the tag). `/ca info ` - Inspect stats and members of any clan. `/ca chest ` - View and manage the shared chest of any clan. * `/ca clan delete ` -