Описание
# 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.
**Required**
- Vault – economy & permissions API
- Any Economy Plugin – needed for Vault to handle money
**Optional**
- PlaceholderAPI (PAPI) – adds placeholders support
- Fcore – extra features integration
- **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`).
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).
- `clans.admin`
- Allows Non-Op players to use the plugins op commands.
### 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. |
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.
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.
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)
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.
The plugin stats can be found on [Bstats](https://bstats.org/plugin/bukkit/Simple%20Clans/25416)
**_Your review about the plugin will be appreciated and will help us improve it in future._**