Clans - — 简易公会系统

Clans 是一款功能丰富的 Minecraft 氏族插件，支持氏族创建、成员管理、经济系统、联盟与敌对关系、排行榜等功能，帮助服务器打造更具合作性与竞争性的多人游戏体验。

⭐插件简介

玩家可以创建、管理并发展自己的氏族，与其他氏族争夺服务器主导地位。无论是社区型服务器还是竞技型服务器，Clans 都能进一步增强多人游戏体验。

💡依赖

必需依赖

• Vault – 经济与权限 API
• 任意经济插件 – Vault 处理金钱所需

可选依赖

• PlaceholderAPI (PAPI) – 添加变量支持
• Fcore – 提供额外功能集成

✨功能特色

• 氏族创建：玩家可以创建具有独特名称和前缀的氏族。
• 氏族管理：邀请、晋升、降职或踢出成员，也可以将领导权转让给其他成员。
• 氏族聊天：使用 /cc 或 /clan chat 与氏族成员进行私密交流。
• 氏族仓库：氏族成员共享的虚拟仓库，可升级至 9–54 个槽位。
• 氏族家园：
• 设置氏族家园位置。
• 随时传送至氏族家园。
• 氏族旗帜：设置氏族旗帜，彰显领地统治力。
• PvP 管理：领导者可以启用或禁用氏族成员之间，以及己方氏族与盟友氏族之间的 PvP。
• 氏族敌对与结盟：向其他氏族宣战或与其建立联盟。
• 氏族 KDR：根据成员的击杀数与死亡数统计氏族 KDR。
• 氏族升级：通过升级扩展氏族成员数量上限。
• 加入申请：
• 向氏族发送加入申请。
• 领导者可以接受或拒绝申请。
• 开关氏族是否接受加入申请。
• 经济系统集成：需要 Vault 来管理氏族创建费用和升级费用。
• PlaceholderAPI 支持：在服务器任意位置显示氏族相关变量。
• 高度可配置：可以自定义氏族创建费用、最大成员数等设置。
• 多语言支持：支持最多 6 种语言：en、fr、dt、ru、tr、cn。
• 十六进制颜色氏族名称：氏族名称支持自定义 6 位十六进制颜色代码，例如 #178ad6。

🎮PlaceholderAPI 变量

使用 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 <name> – 使用指定名称创建新氏族。
• /clan join <name> – 申请加入氏族。
• /clan accept – 接受氏族邀请。
• /clan deny – 拒绝氏族邀请。

氏族成员

• /clan home – 传送至氏族家园。
• /clan online – 显示所有在线氏族成员。
• /clan chest / /clan storage – 打开氏族仓库。
• /clan getbanner – 获取氏族旗帜。
• /clan deposit <amount> – 向氏族银行存入金额。
• /clan info – 查看当前所在氏族的信息。
• /clan leave – 离开当前氏族。
• /clan balance – 查看氏族总余额。
• /clan chat <msg> / /cc <msg> – 向氏族私聊频道发送消息。

氏族副领导者

• /clan invite <player> – 邀请玩家加入氏族。
• /clan kick <player> – 将玩家踢出氏族。
• /clan withdraw <amount> – 从氏族银行取出金额。
• /clan raccept <player> – 接受玩家的加入申请。
• /clan rdeny <player> – 拒绝玩家的加入申请。
• /clan requests – 查看待处理的加入申请。
• /clan upgrade – 升级氏族成员数量上限。

氏族领导者

• /clan promote <player> – 晋升氏族成员。
• /clan demote <player> – 降职氏族成员。
• /clan pvp – 切换氏族成员之间的 PvP 状态。
• /clan transfer <player> – 将领导权转让给其他玩家。
• /clan togglejoin – 切换氏族是否接受加入申请。
• /clan sethome – 设置氏族家园位置。
• /clan change <prefix> – 更改氏族前缀（支持颜色代码）。
• /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%

示例

假设有两个氏族

• Alpha：10 名成员、$5,000 银行余额、KDR 为 2.0
• Beta：8 名成员、$10,000 银行余额、KDR 为 1.5

第一步：标准化各项数据

• 成员数量：Alpha 为 10 / 10 → 1.0，Beta 为 8 / 10 → 0.8
• 银行余额：Alpha 为 5,000 / 10,000 → 0.5，Beta 为 10,000 / 10,000 → 1.0
• KDR：Alpha 为 2.0 / 2.0 → 1.0，Beta 为 1.5 / 2.0 → 0.75

第二步：应用权重

• Alpha 得分 = (1.0 × 0.4) + (0.5 × 0.2) + (1.0 × 0.4) = 0.9
• Beta 得分 = (0.8 × 0.4) + (1.0 × 0.2) + (0.75 × 0.4) = 0.82

第三步：排名

• 1️⃣ Alpha（0.9）
• 2️⃣ Beta（0.82）

这说明即使 Beta 拥有更多资金，Alpha 仍然会因为成员更多且 KDR 更高而排名更高。

💡配置说明

• 默认创建氏族需要支付 50,000 金钱。
• 氏族不能直接解散，只能将领导权转让给氏族成员。
• 氏族排名依据多个因素计算，其中默认最大成员数量为 50。
• 每次升级可增加 1 个成员槽位，费用为 10,000 金钱。
• 以上数值均可在 config.yml 中修改。
• 氏族仓库也支持升级，每次增加 9 个槽位。
• 氏族仓库升级功能可以在 config.yml 中禁用。
• 可以在 config.yml 中设置禁止用作氏族前缀的词语列表。
• 禁止词列表同样适用于氏族改名。

✨支持的语言

插件支持 6 种语言，可以在 config.yml 中修改。

• 修改语言后，必须使用 /clan reload，新语言才会生效。
• English (en) [Default]
• French (fr)
• Dutch (de)
• Chinese (cn)
• Russian (ru)
• Turkish (tr)

❓Fcore 集成说明

• 插件无需 Fcore 也可以完整运行。
• 唯一例外是踢出离线玩家功能，该功能需要 Fcore。
• Fcore 负责追踪离线玩家的数据。

🔧统计与反馈

• 插件统计数据可以在 Bstats 查看。
• 欢迎留下你对插件的评价，这将帮助我们在未来持续改进插件。

该插件可通过将 .jar 文件放入服务器的插件目录中进行安装，并在首次启动后自动生成配置文件。

🔧使用方法

• 将插件 .jar 文件放入服务器的 plugins 文件夹。
• 启动或重新加载服务器。
• 配置文件将生成在 /plugins/Clans/ 目录中，可根据需要进行自定义。

🎮配置

• 所有插件数据都存储在 config.yml 中。
• 公会数据存储在 clans.yml 中。
• 加入请求数据存储在 join_requests.yml 中。
• 邀请数据存储在 invites.yml 中。