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.

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	[page]	View interactive help pages.
/clan create	<name>	Create a new clan.
/clan level	-	Display XP progress bar for the current level.
/clan stats	[clan]	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	<name>	Join an open clan or send a request.
/clan leave	-	Leave your current clan (Blocked in combat).
/clan kick	<player>	Remove a member from the clan.
/clan promote	<player>	Promote a member to Moderator.
/clan demote	<player>	Demote a Moderator back to Member.
/clan ban	<player>	Ban a player from joining your clan.
/clan unban	<player>	Remove a ban from a player.
/clan invite	<player>	Invite a player to join your clan.
/clan accept	<name>	Accept a join invitation or an ally request.
/clan deny	<name>	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	[upgrade]	Open or upgrade shared chest storage.
/clan market	-	Open the clan shop (XP/Money currency).
/clan home	[create/delete]	Set or teleport to the clan base.
/clan manage	-	Open the main settings GUI.
/clan pvp	-	Toggle friendly-fire within the clan.
/clan transfer	<player>	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 <clan> - Toggle Verified status (displays a crown icon next to the tag).
• /ca info <clan> - Inspect stats and members of any clan.
• /ca chest <clan> - View and manage the shared chest of any clan.
• /ca clan delete <clan> - Forcefully disband a clan.
• /ca clan rename <old> <new> - Rename any clan instantly.
• /ca stats addxp/setlevel <clan> <amount> - Manage clan progression.
• /ca bank add/set/remove <clan> <amount> - Manage clan finances.
• /ca player join/kick <player> <clan> - Forcefully move players.

---

🧩 PlaceholderAPI Support

ApexClan offers extensive placeholders to design your tablists, scoreboards, and chat layouts:

• %apex_clan_tag% - Colored clan name.
• %apex_clan_tag_color% - Clan color code.
• %apex_clan_leader% - Name of the clan leader.
• %apex_clan_level% - Current level.
• %apex_clan_xp% - Current XP.
• %apex_clan_member_count% - Total members.
• %apex_clan_online_count% - Online member count.
• %apex_clan_kdr% - Kill/Death ratio.
• %apex_clan_kill% - Total kills.
• %apex_clan_deaths% - Total deaths.
• %apex_clan_rank% - Position on the global leaderboard.
• %apex_clan_verified_status% - Verified status icon.
• %apex_clan_top:[kdr/death/member/kill]:[1..100]% - Leaderboard details.

---

📞 Support & Community

• 💬 Discord: Join Community And API
• 🌐 SpigotMC: Spigot Resource

🌍 Supported Languages

English (ENG), Türkçe (TR), Español (ES), Français (FR), 日本語 (JP), Русский (RU).