# 部落
_团结。统治。征服._
**部落插件**是促进您的 Minecraft 服务器团队合作和竞争的终极工具。 它具有丰富的特性，玩家可以创建、管理和发展他们的部落，同时为争夺霸主而竞争。 无论您是在建立社区还是运行竞争性服务器，此插件旨在增强多人游戏体验。
**必需**
- Vault – 经济 & 权限 API
- 任何经济插件 – Vault 处理金钱所必需
**可选**
- PlaceholderAPI (PAPI) – 添加占位符支持
- Fcore – 集成额外的功能
- **部落创建**: 玩家可以使用唯一的名称和前缀创建部落。
- **部落管理**:
- 邀请、晋升、降级或踢出成员。
- 将领导权转移给其他成员。
- **部落聊天**: 使用 `/cc` 或 `/clan chat` 与您的部落私密交流。
- **部落箱**: 部落成员共享的虚拟部落箱，可进行升级（9–54 个槽）。
- **部落家园**:
- 为您的部落设置一个家园位置。
- 随时传送到部落家园。
- **部落旗帜**: 设置部落旗帜以宣示领土霸权。
- **PvP 管理**: 领导者可以启用或禁用部落成员之间的 PvP（自有和友盟部落）。
- **部落敌对/盟友**: 声明其他部落的敌对或结盟。
- **部落 KDR**: 根据成员的击杀和死亡来跟踪部落 KDR。
- **部落升级**: 通过升级扩大部落的玩家槽数。
- **加入请求**:
- 发送加入部落的请求。
- 领导者接受或拒绝请求。
- 切换部落加入状态。
- **经济集成**: 需要 Vault 来管理部落创建成本和升级费用。
- **PlaceholderAPI 支持**: 在服务器的任何位置显示与部落相关的占位符。
- **高度可配置**: 自定义设置，例如部落创建成本、最大成员数等。
- **多语言支持**: 支持多达 6 种语言：`en, fr, dt, ru, tr, cn`。
- **十六位色 Tribe 名称**: 部落名称支持自定义的 6 位十六进制颜色代码（例如，`#178ad6`）。
当使用 PlaceholderAPI 时，可以使用以下占位符：
- `%clans_name%` → 显示玩家的部落名称。
- `%clans_name_cm%` → 显示玩家的部落名称（仅用于 ChatManager）。
- `%clans_name_plain%` → 去除颜色代码后显示玩家的部落名称。
- `%clans_badge%` → 显示玩家的部落徽章。
- `%clans_list_<#>_name%` → 显示排行榜上该位置的部落名称。
- `%clans_list_<#>_leader%` → 显示排行榜上该位置的部落领导者。
- `%clans_list_<#>_balance%` → 显示排行榜上该位置的部落余额。
- `%clans_list_<#>_kdr%` → 显示排行榜上该位置的部落 KDR。
> 注意：将 `<#>` 替换为排行榜上的等级数字（例如，`%clans_list_1_name%` 表示顶级部落）。
- `clans.admin`
- 允许非 Op 玩家使用插件的 Op 命令。
### 任何人
| 命令 | 描述 |
|----------------------------------|-------------|
| `/clan top` | 列出所有顶级部落的排名。 |
| `/clan create ` | 使用指定的名称创建一个新的部落。 |
| `/clan join ` | 请求加入一个部落。 |
| `/clan accept` | 接受部落邀请。 |
| `/clan deny` | 拒绝部落邀请。 |
### 部落成员
| 命令 | 描述 |
|----------------------------------|-------------|
| `/clan home` | 传送到部落家园。 |
| `/clan online` | 显示所有在线部落成员。 |
| `/clan chest` / `/clan storage` | 打开部落箱。 |
| `/clan getbanner` | 给部落成员部落旗帜。 |
| `/clan deposit ` | 存入部落银行账户的资金。 |
| `/clan info` | 查看部落的信息。 |
| `/clan leave` | 离开当前部落。 |
| `/clan balance` | 查看部落的总余额。 |
| `/clan chat ` / `/cc `| 向部落私密聊天发送消息。 |
### 部落副领袖
| 命令 | 描述 |
|----------------------------------|-------------|
| `/clan invite ` | 邀请一名玩家加入您的部落。 |
| `/clan kick ` | 将一名玩家从部落中踢出。 |
| `/clan withdraw ` | 从部落银行账户中取款。 |
| `/clan raccept ` | 接受一名玩家加入部落的请求。 |
| `/clan rdeny ` | 拒绝一名玩家加入部落的请求。 |
| `/clan requests` | 查看挂起的加入请求。 |
| `/clan upgrade` | 升级部落玩家槽。 |
### 部落领袖
| 命令 | 描述 |
|----------------------------------|-------------|
| `/clan promote ` | 晋升部落成员。 |
| `/clan demote ` | 降级部落成员。 |
| `/clan pvp` | 在部落成员之间切换 PvP。 |
| `/clan transfer ` | 将部落领导权转移给另一名玩家。 |
| `/clan togglejoin` | 切换部落是否接受加入请求。 |
| `/clan sethome` | 设置部落家园位置。 |
| `/clan change ` | 更改部落前缀（带颜色代码）。 |
| `/clan setbanner` | 设置部落旗帜（必须持有旗帜）。 |
| `/clan upgradestorage` | 升级部落存储槽。 |
| `/clan war` / `/clan enemy` | 将部落声明为敌对部落。 |
| `/clan ally` | 将部落声明为盟友部落。 |
| `/clan unenemy` | 从部落移除敌对状态。 |
| `/clan unally` | 从部落移除盟友状态。 |
### 服务器管理员
| 命令 | 描述 |
|----------------------------------|-------------|
| `/clan reload` | 重新加载插件配置。 |
| `/clan delete` | 删除部落及其相关数据。 |
| `/clan updater` | 在线检查插件更新。 |
| `/clan updateconf` | 从旧版本更新到最新版本的配置。 |
部落排行榜是基于以下三个因素计算的：
- **成员人数** – 40% 的权重
- **银行余额** – 20% 的权重
- **部落 KDR（击杀/死亡）** – 40% 的权重
### 示例计算
假设我们有两个部落：
| 部落 | 成员 | 银行余额 | KDR |
|------------|---------|--------------|-------|
| Alpha | 10 | $5,000 | 2.0 |
| Beta | 8 | $10,000 | 1.5 |
**步骤 1：标准化每个因素**
- 成员：Alpha 10 / Max 10 → 1.0，Beta 8 / 10 → 0.8
- 银行：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
**步骤 2：应用权重**
- Alpha 得分 = (1.0 × 0.4) + (0.5 × 0.2) + (1.0 × 0.4) = 0.4 + 0.1 + 0.4 = **0.9**
- Beta 得分 = (0.8 × 0.4) + (1.0 × 0.2) + (0.75 × 0.4) = 0.32 + 0.2 + 0.3 = **0.82**
**步骤 3：排名**
- 1️⃣ Alpha (0.9)
- 2️⃣ Beta (0.82)
> 这表明即使 Beta 拥有更多的资金，Alpha 排名更高，因为它的成员更多且 KDR 更高。
创建一个部落默认需要 50,000 的资金。 部落不能被解散，只能转移给部落成员，部落排名是基于成员数量，默认最大成员限制是 50，可以通过 10,000 资金增加一个玩家槽数，这些费用可编辑在 `config.yml` 文件中。 部落箱也可以通过 9 个槽一次升级，并且可以在 `config.yml` 文件中禁用。
在 `config.yml` 文件中，您可以定义应禁止用作部落前缀的单词列表。 这也适用于部落重命名。
该插件现在支持六种语言，可以在 `config.yml` 文件中进行修改，更改语言后必须使用 `/clan reload` 命令才能激活新选择的语言。
### 支持的语言
- 英语 (en) [默认]
- 法语 (fr)
- 荷兰语 (de)
- 中文 (cn)
- 俄语 (ru)
- 土耳其语 (tr)
该插件可以在**[Fcore](https://modrinth.com/plugin/fcore)**没有的情况下完全正常工作，但有一个例外：**离线玩家踢出**需要 Fcore，因为它负责跟踪离线玩家的统计数据。
该插件的统计数据可以在 [Bstats](https://bstats.org/plugin/bukkit/Simple%20Clans/25416) 上找到
**_您对该插件的评论将不胜感激，这将有助于我们在未来改进它。_**