FunctionalClans Extensive clan system - FunctionalClans

FunctionalClans 是一个允许玩家创建并管理公会的系统。会长可以自定义公会内各等级的权限，还能与其他公会结盟，并通过评级系统展开竞争。

💡重要通知

• 由于开发者个人原因，本插件的官方开发与支持已暂时冻结。
• 但关心此插件的开发者可能会在 Discord 中发布非官方更新。

🎮系统要求

• Java 版本：插件版本 2.0.1 及以上需要 Java 11 或更高版本。

❓依赖与常见问题

依赖项

本插件需要以下依赖才能正常运行

• Vault：用于经济系统。
• PlaceholderAPI：用于变量显示。

常见错误

• 错误提示：Disabled due to no Vault dependency found!

- **解决方法**：请先安装 Vault 插件。如果问题依旧，请安装一个与 Vault 兼容的经济插件（例如 EssentialsX）。

• 错误提示：Disabled due to PlaceholderAPI dependency not found!

- **解决方法**：请安装 PlaceholderAPI 插件。

⭐核心特色

公会类型

• 封闭式公会：玩家只能通过公会成员邀请加入。
• 开放式公会：玩家无需邀请即可申请加入。

等级与权限系统

• 共有 5 个等级（1 至 5 级）。
• 等级 1 至 4 的权限可由会长完全自定义。
• 等级 5 为会长等级，权限不可编辑。
• 可配置的权限包括：

- 踢出公会成员

- 发送入会邀请

- 向公会金库存取资金

- 升降成员等级

- 使用公会聊天与公告

- 发送/接收结盟请求

- 解除同盟关系

验证与评级系统

• 公会分为已验证和未验证两种状态。
• 已验证公会可享受以下功能：

- 与其他公会结盟

- 更改公会类型

- 参与 KDR 系统

- 赚取公会评级

• 公会评级反映了公会的活跃度与实力。

- 若评级低于配置文件中的最小值，公会将自动转为“未验证”状态。

• 赚取评级的方式：

- 击杀玩家（基于 KDR 系统）。击杀者为其公会赢得评级，失败者则从其公会扣除评级。

• KDR 系统说明：

- 仅对**已验证公会**的成员生效。

- 击杀者与受害者必须来自不同的、且未结盟的已验证公会，统计才会计入。

🔧玩家命令一览

所有玩家均可使用 /clan help (0-7) 查看分类命令帮助。

• 0: 全部命令
• 1-4: 各等级命令
• 5: 会长命令
• 6: 设置命令
• 7: 通用命令

通用命令

• /clan create <名称> - 创建公会 (fc.create)
• /clan delete - 解散公会 (fc.delete，仅会长)
• /clan info - 查看公会信息 (fc.info)
• /clan list - 查看公会列表 (fc.list)
• /clan members - 查看公会成员 (fc.members)
• /clan accept - 接受入会邀请 (fc.accept)
• /clan deny - 拒绝入会邀请 (fc.deny)
• /clan invite <玩家> - 邀请玩家 (fc.invite，需权限)
• /clan kick <玩家> - 踢出玩家 (fc.kick，需权限)
• /clan leave - 离开公会 (fc.leave)
• /clan leader <玩家> - 转让会长 (fc.leader，仅会长)
• /clan rename <新名称> - 重命名公会 (fc.rename，仅会长)
• /clan home - 传送至公会据点 (fc.home)
• /clan chat <消息> - 在公会聊天发言 (fc.chat，需权限)
• /clan msg <公告> - 发送公会公告 (fc.msg，需权限)
• /clan ally - 查看同盟列表 (fc.ally)
• /clan cash add <金额> - 向金库存钱 (fc.cash，需权限)
• /clan cash remove <金额> - 从金库取钱 (fc.cash，需权限)
• /clan top <rating/members/kills/deaths/kdr> <max/min> <页码> - 查看公会排行榜 (fc.top)
• /clan stats <rating/kills/deaths/kdr> <max/min> <页码> - 查看成员数据榜 (fc.stats)
• /clan request <UID> - 向开放式公会发送加入请求 (fc.request)

设置命令 (会长)

• /clan settings message <消息> - 设置公会留言 (fc.message)
• /clan settings status <状态> - 设置公会状态 (fc.status)
• /clan settings social <社交媒体> - 设置社交链接 (fc.social)
• /clan settings type <0/1> - 设置公会类型 (0封闭/1开放) (fc.type)
• /clan settings role - 查看角色权限 (fc.role)
• /clan settings setrole - 设置角色权限 (fc.setrole)
• /clan settings sethome - 设置公会据点 (fc.sethome)
• /clan settings removehome - 移除公会据点 (fc.removehome)
• /clan settings pvp - 切换公会PVP模式 (fc.mpvp)
• /clan addrank <玩家> - 提升成员等级 (fc.addrank，需权限)
• /clan removerank <玩家> - 降低成员等级 (fc.removerank，需权限)
• /clan ally add <UID> - 发送结盟请求 (fc.ally，需权限)
• /clan ally remove <UID> - 解除同盟关系 (fc.ally，需权限)
• /clan update members - 增加成员上限 (fc.update，仅会长)

🔧管理员命令

• /fc update - 刷新缓存 (fc.admin.update)
• /fc verify <UID> - 验证公会 (fc.admin.verify)
• /fc info <UID> - 查看指定公会信息 (fc.admin.info)
• /fc members <UID> - 查看指定公会成员 (fc.admin.members)
• /fc delete <UID> - 删除指定公会 (fc.admin.delete)
• /fc leader <UID> <玩家> - 转移指定公会的会长 (fc.admin.leader)

✨PlaceholderAPI 变量

玩家所在公会变量

格式：%fc_player_clan_<变量名>%

• %fc_player_clan_name% - 公会名称
• %fc_player_clan_leader% - 会长
• %fc_player_clan_cash% - 金库余额
• %fc_player_clan_rating% - 公会评级
• %fc_player_clan_type% - 公会类型
• %fc_player_clan_status% - 公会状态
• %fc_player_clan_verification% - 验证状态
• %fc_player_clan_online-player% - 在线成员数
• %fc_player_clan_count-player% - 总成员数
• %fc_player_clan_message% - 公会留言
• %fc_player_clan_uid% - 公会UID

指定UID公会变量

格式：%fc_clan_<变量名>_uid_<公会UID>%

• 将 <公会UID> 替换为具体公会的唯一标识符即可使用，例如 %fc_clan_name_uid_123%。

排行榜变量

• 公会/成员排行榜：%fc_<top/stats>_<name/count>_<排序项>_<max/min>_<名次>%
• 玩家个人排名：%fc_my_<top/stats>_<count/number>_<排序项>_<max/min>%
• 排序项：rating（评级）， members（成员数，仅top）， kills（击杀）， deaths（死亡）， kdr（击杀死亡比）。

玩家个人数据变量 (需在公会中)

• %fc_player_rank% - 公会内等级
• %fc_player_rank-name% - 等级名称
• %fc_player_kills% - 击杀数
• %fc_player_deaths% - 死亡数
• %fc_player_kdr% - 个人KDR
• %fc_player_rating% - 个人贡献评级

全局变量

• %fc_all_count_clans% - 服务器公会总数

❓其他常见问题

• 插件未来会更新吗？

- 是的，未来可能会有更新。您可以在 Discord 中提出建议，如果符合插件的设计方向，可能会被加入。

• 我发现错误或使用问题，该联系谁？

- 请通过 Discord 联系开发者。

• 如何查看公会的 UID？

- 将鼠标悬停在公会列表 (`/clan list`) 中的公会名称上，即可在提示信息中查看其 UID。

🔧数据统计与联系

• 数据收集：FunctionalClans 通过 bStats 收集匿名的服务器使用统计以帮助改进插件。您可以在 plugins/bStats/config.yml 中禁用此功能。
• 联系方式：如有任何问题或建议，请通过 Discord 联系开发者。