getClan - NEW UPDATE [v2] - getClan 部落插件

GetClan 是一款功能丰富的 Minecraft 插件，它为服务器添加了完整的公会（Clan）系统，支持创建公会、管理成员、建立联盟、升级公会能力以及丰富的排行榜和 PlaceholderAPI 变量。

💡前置需求

• Java 16 或更高版本
• PlaceholderAPI
• Vault (与 EssentialsX 等经济插件配合使用)

🎮管理员命令

权限节点：getclan.admin

• /clan reload - 重载插件配置
• /clan setitem - 设置创建公会所需的物品
• /clan admin reset all [player] - 重置玩家的点数、击杀和死亡数
• /clan admin reset kills [player] - 重置玩家的击杀数
• /clan admin reset deaths [player] - 重置玩家的死亡数
• /clan admin reset points [player] - 重置玩家的点数
• /clan admin delete clan [player] - 删除玩家所在的公会
• /clan admin setpoints [player] [points] - 设置玩家的点数
• /clan admin upgrade disable - 禁用公会升级系统
• /clan admin upgrade enable - 启用公会升级系统
• /clan admin give [type] [player] [amount] - 给予玩家自定义物品（升级碎片）
• /clan admin setitem [type] [level] - 为指定类型和等级的升级设置所需物品

升级类型 (type):

• default (或 odlamek) - 基础碎片
• DROP_BOOST - 掉落加成
• MEMBERS - 成员上限
• POINTS_BOOST - 点数加成

🎮玩家命令

权限节点：getclan.use

• /player [nickname] - 查看玩家信息
• /clan create [tag] - 创建一个公会
• /clan join [tag] - 加入一个公会
• /clan leave - 离开当前公会
• /clan info [tag] - 查看公会信息
• /clan alliance [tag] - 发送联盟请求
• /clan invite [nickname] - 邀请玩家加入公会
• /clan kick [nickname] - 将玩家踢出公会
• /clan setowner [nickname] - 转移公会领袖
• /clan deputy [nickname] - 设置公会副手
• /clan removedeputy - 移除公会副手
• /clan delete - 解散当前公会
• /clan pvp - 切换公会内 PvP 开关
• /clan upgrade - 打开公会升级菜单

聊天命令

• !<消息> - 在公会频道聊天
• !!<消息> - 在联盟频道聊天

🔧PlaceholderAPI 变量

排行榜变量

将 <NUMER> 替换为具体名次（如 1, 2, 3）。

• %getclan_top_kill_<NUMER>_value% - 返回该名次玩家的击杀数
• %getclan_top_kill_<NUMER>_name% - 返回该名次玩家的名称
• %getclan_top_death_<NUMER>_value% - 返回该名次玩家的死亡数
• %getclan_top_death_<NUMER>_name% - 返回该名次玩家的名称
• %getclan_top_points_<NUMER>_value% - 返回该名次玩家的点数
• %getclan_top_points_<NUMER>_name% - 返回该名次玩家的名称
• %getclan_top_clan_<NUMER>_value% - 返回该名次公会的点数
• %getclan_top_clan_<NUMER>_name% - 返回该名次公会的标签

用户与公会变量

• %getclan_user_format_points% - 返回玩家点数（带格式）
• %getclan_user_points% - 返回玩家点数（原始值）
• %getclan_clan_format_points% - 返回公会点数（带格式）
• %getclan_clan_points% - 返回公会点数（原始值）
• %getclan_clan_format_tag% - 返回公会标签（带格式）
• %getclan_clan_format_tag_upper% - 返回公会标签（大写并带格式）
• %getclan_clan_tag% - 返回公会标签
• %getclan_clan_tag_upper% - 返回公会标签（大写）
• %getclan_user_kills% - 返回玩家击杀数
• %getclan_user_death% - 返回玩家死亡数
• %getclan_clan_members_online% - 返回公会在线成员数
• %getclan_clan_members_size% - 返回公会总成员数
• %getclan_user_has_clan% - 返回玩家是否拥有公会

关系变量 (Relational Placeholders)

• %rel_getclan_tag% - 返回关系上下文中的公会标签
• %rel_getclan_tag_upper% - 返回关系上下文中的公会标签（大写）

✨配置摘要

以下为配置文件 config.yml 中的关键选项：

基础设置

• langType：语言设置，可选 EN 或 PL
• defaultPoints：玩家初始点数（默认 500）
• limitAlliance：公会联盟数量上限（默认 2）
• pvpClan：是否开启公会内 PvP（默认 true）
• pvpAlliance：是否开启联盟间 PvP（默认 true）

公会与成员限制

• permissionLimitMember：基于权限设置成员上限，例如 getclan.default: 5
• clansTagLengthMin：公会标签最小长度（默认 2）
• clansTagLengthMax：公会标签最大长度（默认 6）

防滥用与经济系统

• systemAntiabuse：是否开启防排名滥用系统（默认 true）
• cooldown：击杀同一玩家的冷却时间（秒，默认 300）
• enablePayment：是否启用付费创建公会（默认 true）
• costType：付费方式，VAULT（经济）或 ITEM（物品）
• costCreate：创建成本（金钱数额或物品数量）

显示与格式

• colorOnlinePlayer：在线玩家名称颜色（默认 &a）
• colorOfflinePlayer：离线玩家名称颜色（默认 &7）
• noneDeputy：未设置副手时的显示文本
• noneTag：无公会标签时的占位符格式
• nonePointsClan：无公会点数时的占位符格式
• 多种 format... 选项：用于自定义玩家点数、公会点数、标签及聊天消息的显示格式。

升级系统配置 (`upgrades.yml`)

• upgradeEnable：是否启用升级系统（默认 false）
• whitelistMaterial：允许用于升级的物品材料白名单
• inventoryBase：升级菜单的 GUI 设置（大小、标题、装饰物品）
• upgrades：详细定义每种升级类型（POINTS_BOOST, MEMBERS, DROP_BOOST）的各个等级，包括显示物品、消耗、加成效果等。

❓注意事项

• 公会的总点数基于所有成员点数的平均值计算，因此无法直接为公会设置点数。
• 使用前请确保已正确安装所有前置插件。
• 升级系统的物品消耗和效果可在 upgrades.yml 中深度自定义。