![Main Banner](https://cdn.flubel.com/clans_banner.png) ![](https://img.shields.io/github/actions/workflow/status/Flubel/Clans/maven.yml?branch=master&style=for-the-badge&color=ff5555) ![](https://img.shields.io/bstats/players/25416?style=for-the-badge&logo=datadog&color=9B59B6&label=Active%20Players) ![](https://img.shields.io/bstats/servers/25416?style=for-the-badge&logo=serverfault&color=F1C40F&label=Active%20Servers) # Clans _Unite. Dominate. Conquer._ The **Clans Plugin** is the ultimate tool for fostering teamwork and competition on your Minecraft server. With a rich set of features, players can create, manage, and grow their clans while competing for dominance. Whether you're building a community or running a competitive server, this plugin is designed to enhance the multiplayer experience. ![Dependencies](https://cdn.flubel.com/dep.png) **Required** - Vault – economy & permissions API - Any Economy Plugin – needed for Vault to handle money **Optional** - PlaceholderAPI (PAPI) – adds placeholders support - Fcore – extra features integration ![Features](https://cdn.flubel.com/feat.png) - **Clan Creation**: Players can create clans with unique names and prefixes. - **Clan Management**: - Invite, promote, demote, or kick members. - Transfer leadership to other members. - **Clan Chat**: Communicate privately with your clan using `/cc` or `/clan chat`. - **Clan Chest**: A virtual clan chest shared amongst clan members that can be upgraded (9–54 slots). - **Clan Home**: - Set a home location for your clan. - Teleport to the clan home anytime. - **Clan Banner**: Set a clan banner to assert land dominance. - **PvP Management**: Leaders can enable or disable PvP among clan members (own and allied clans). - **Clan Enemies/Allies**: Declare enemies or form alliances with other clans. - **Clan KDR**: Track clan KDR based on members’ kills and deaths. - **Clan Upgrades**: Expand your clan’s player slots with upgrades. - **Join Requests**: - Send requests to join clans. - Accept or deny requests as a leader. - Toggle clan join status. - **Economy Integration**: Requires Vault to manage clan creation costs and upgrades. - **PlaceholderAPI Support**: Display clan-related placeholders anywhere on your server. - **Highly Configurable**: Customize settings like clan creation costs, max members, and more. - **Multi-Language Support**: Supports up to 6 languages: `en, fr, dt, ru, tr, cn`. - **Hex Colored Clan Names**: Clan names support custom 6-digit hex color codes (e.g., `#178ad6`). ![Placeholders](https://cdn.flubel.com/plac.png) These placeholders are available when using PlaceholderAPI: - `%clans_name%` → Shows the player's clan name. - `%clans_name_cm%` → Shows the player's clan name (for ChatManager only). - `%clans_name_plain%` → Shows the player's clan name stripped from color codes. - `%clans_badge%` → Shows the player's clan badge. - `%clans_list_<#>_name%` → Shows the name of the clan at that position in the leaderboard. - `%clans_list_<#>_leader%` → Shows the leader of the clan at that position. - `%clans_list_<#>_balance%` → Shows the balance of the clan at that position. - `%clans_list_<#>_kdr%` → Shows the KDR of the clan at that position. > Note: Replace `<#>` with the rank number in the leaderboard (e.g., `%clans_list_1_name%` for the top clan). ![Permissions](https://cdn.flubel.com/perm.png) - `clans.admin` - Allows Non-Op players to use the plugins op commands. ![Commamds](https://cdn.flubel.com/cmnd.png) ### Anyone | Command | Description | |----------------------------------|-------------| | `/clan top` | List ranking for all top clans. | | `/clan create ` | Create a new clan with the specified name. | | `/clan join ` | Request to join a clan. | | `/clan accept` | Accept a clan invite. | | `/clan deny` | Deny a clan invite. | ### Clan Members | Command | Description | |----------------------------------|-------------| | `/clan home` | Teleport to the clan home. | | `/clan online` | Show all online clan members. | | `/clan chest` / `/clan storage` | Open the clan chest. | | `/clan getbanner` | Give the clan member the clan banner. | | `/clan deposit ` | Deposit money to the clan’s bank balance. | | `/clan info` | View information about the clan you’re in. | | `/clan leave` | Leave your current clan. | | `/clan balance` | View the clan’s total balance. | | `/clan chat ` / `/cc `| Sends a message to private clan chat. | ### Clan Co-Leaders | Command | Description | |----------------------------------|-------------| | `/clan invite ` | Invite a player to your clan. | | `/clan kick ` | Kick a player from your clan. | | `/clan withdraw ` | Withdraw money from the clan’s bank balance. | | `/clan raccept ` | Accept a player’s request to join the clan. | | `/clan rdeny ` | Deny a player’s request to join the clan. | | `/clan requests` | View pending join requests. | | `/clan upgrade` | Upgrade the clan player slot. | ### Clan Leaders | Command | Description | |----------------------------------|-------------| | `/clan promote ` | Promote a clan member. | | `/clan demote ` | Demote a clan member. | | `/clan pvp` | Toggle PvP between clan members. | | `/clan transfer ` | Transfer clan leadership to another player. | | `/clan togglejoin` | Toggle whether the clan accepts join requests. | | `/clan sethome` | Set the clan’s home location. | | `/clan change ` | Change the clan’s prefix (color coded). | | `/clan setbanner` | Set the clan banner (must be holding one). | | `/clan upgradestorage` | Upgrade the clan storage slots. | | `/clan war` / `/clan enemy` | Declare a clan as enemy. | | `/clan ally` | Declare a clan as ally. | | `/clan unenemy` | Remove enemy status from a clan. | | `/clan unally` | Remove ally status from a clan. | ### Server Admins | Command | Description | |----------------------------------|-------------| | `/clan reload` | Reload the plugin configuration. | | `/clan delete` | Delete the clan and its relevant data. | | `/clan updater` | Check online for plugin updates. | | `/clan updateconf` | Update the config from an older version to the latest version. | ![Leaderboards](https://cdn.flubel.com/lead.png) The clan leaderboard is calculated based on three factors: - **Number of Members** – 40% weight - **Bank Balance** – 20% weight - **Clan KDR (Kills/Deaths)** – 40% weight ### Example Calculation Suppose we have two clans: | Clan | Members | Bank Balance | KDR | |------------|---------|--------------|-------| | Alpha | 10 | $5,000 | 2.0 | | Beta | 8 | $10,000 | 1.5 | **Step 1: Normalize each factor** - Members: Alpha 10 / Max 10 → 1.0, Beta 8 / 10 → 0.8 - Bank: Alpha 5,000 / Max 10,000 → 0.5, Beta 10,000 / 10,000 → 1.0 - KDR: Alpha 2.0 / Max 2.0 → 1.0, Beta 1.5 / 2.0 → 0.75 **Step 2: Apply weights** - Alpha Score = (1.0 × 0.4) + (0.5 × 0.2) + (1.0 × 0.4) = 0.4 + 0.1 + 0.4 = **0.9** - Beta Score = (0.8 × 0.4) + (1.0 × 0.2) + (0.75 × 0.4) = 0.32 + 0.2 + 0.3 = **0.82** **Step 3: Rank** - 1️⃣ Alpha (0.9) - 2️⃣ Beta (0.82) > This shows that even though Beta has more money, Alpha ranks higher because of more members and a higher KDR. ![Functionality](https://cdn.flubel.com/func.png) Creating a clan requires by default 50,000 money. A clan can not be disbanded only transferred to a clan member only, clan ranking is based on most members, by default max member limit is 50, it can be upgraded by 1 player slot for 10,000 Money, these figures are editable in `config.yml`. Same goes for clan chests but they're upgrade able by 9 slots at a time, and can be disabled in `config.yml` as well. In the `config.yml` file, you can define a list of words that should be prohibited as clan's prefix. This also applied to clan renaming. ![Languages](https://cdn.flubel.com/lang.png) The plugin now supports six languages that can be modified in the `config.yml` file, once the language has been changes the command `/clan reload` must be used for the new selected language to be active. ### Supported Languages - English (en) [Default] - French (fr) - Dutch (de) - Chinese (cn) - Russian (ru) - Turkish (tr) ![Notice](https://cdn.flubel.com/notice.png) The plugin functions fully without **[Fcore](https://modrinth.com/plugin/fcore)**, with one exception: **Offline Player Kicking** requires Fcore, as it is responsible for tracking offline player stats. ![Stats](https://cdn.flubel.com/stats.png) The plugin stats can be found on [Bstats](https://bstats.org/plugin/bukkit/Simple%20Clans/25416) ![](https://bstats.org/signatures/bukkit/Simple%20Clans.svg) **_Your review about the plugin will be appreciated and will help us improve it in future._**

MrFiend

Clans

Organizations

Stars

Watching