ClanCL

插件

· 作者 BenitoST

高级且完全可配置的氏族系统

0 本站下载 0 关注 更新于 3 周前

需要前置:PlaceholderAPI、VaultUnlocked

最新 1.1.8 · 26.3 · Bukkit / Folia

一键开服(送7天)

ClanCL 是一款快速、轻量级的 Minecraft Paper 插件,允许玩家组建氏族(Clan),共享资源与经济,并在服务器中显示自定义氏族标签。


✨ 功能特性

  • 自定义氏族标签: 完全动态的氏族标签,支持 PlaceholderAPI。
  • 共享氏族箱子: 安全的多槽位共享物品栏(/clan chest),供氏族成员共享物品。
  • 氏族银行系统: 通过 Vault 集成经济系统,氏族可以存入、取出和管理共享资金。
  • 成员与职位管理: 灵活的邀请系统、踢出和封禁功能。
  • PlaceholderAPI 集成: 开箱即用,兼容 TAB、InteractiveChat、DecentHolograms 以及现代聊天格式化器(LPC、EssentialsX 等)。
  • 动态显示名称: 在氏族事件(加入、离开、创建、标签更改)发生时自动更新玩家的显示名称。
  • 全面的管理员控制: 完整的管理套件,用于检查箱子、修改余额以及强制管理任何氏族。
  • 整洁且可自定义的配置: 清晰的 YAML 配置文件,支持多行帮助菜单(usage: |-)。

? 命令与权限

玩家命令 (/clan)

(玩家命令访问权限由氏族内的职位权限管理,而非服务器权限节点)

氏族管理

  • /clan create <name> <tag> - 创建新氏族。名称格式化为 Xxxxx,标签为大写。
  • /clan invite <player> - 邀请玩家加入你的氏族 (默认:队长及以上)。
  • /clan join <tag> - 接受待处理的氏族邀请。
  • /clan leave - 离开当前氏族(首领无法在不解散或转移所有权的情况下离开)。
  • /clan disband <name> <tag> - 请求删除氏族 (仅限首领)。
  • /clan confirm disband - 确认删除氏族(60秒后过期)。

成员与职位

  • /clan kick <player> - 将成员踢出氏族 (默认:队长及以上)。
  • /clan ban <player> - 将玩家踢出并拉黑,禁止其加入 (默认:副首领及以上)。
  • /clan unban <player> - 从氏族黑名单中移除玩家 (默认:副首领及以上)。
  • /clan promote <player> - 晋升氏族成员 (默认:队长及以上)。
  • /clan demote <player> - 降级氏族成员 (默认:队长及以上)。

银行、家园与箱子

  • /clan bank - 查看当前氏族银行余额。
  • /clan bank deposit <amount> - 向氏族银行存入金钱(仅限整数)。所有成员可用。
  • /clan bank withdraw <amount> - 从氏族银行取出金钱(仅限整数)(默认:副首领及以上)。
  • /clan sethome - 设置氏族家园位置 (默认:副首领及以上)。
  • /clan home - 传送至氏族家园(3秒引导时间,移动即取消)。
  • /clan chest - 打开共享氏族箱子 (默认:老兵及以上)。

外交与 PvP

  • /clan ally <tag> - 向另一个氏族发送结盟请求。
  • /clan accept ally <tag> - 接受待处理的结盟请求。
  • /clan deny ally <tag> - 拒绝待处理的结盟请求。
  • /clan unally <tag> - 解除与某氏族的同盟关系。
  • /clan enemy <tag> - 将另一个氏族声明为敌人(无需对方接受)。
  • /clan unenemy <tag> - 从敌对列表中移除氏族。
  • /clan pvp - 切换氏族内部的友军伤害。
  • /clan pvp ally <tag> - 切换与同盟氏族的友军伤害。 (所有外交命令默认需要副首领及以上权限)

聊天与信息

  • /clan chat - 切换仅限氏族的专属聊天频道。
  • /clan chatally - 切换全同盟范围的聊天频道。
  • /clan online - 列出在线氏族成员。
  • /clan menu - 打开主氏族 GUI 菜单(也可使用 /clan)。
  • /clan info [tag] - 打开你所在氏族或其他氏族的 GUI 菜单。

管理员命令 (/adminclan 或 /aclan)

(如果用户缺乏员工权限,则隐藏于 Tab 补全和执行之外)

氏族与成员管理

  • /adminclan disband <name> <tag> - 强制解散氏族(银行余额将转移给管理员)。clancl.admin.disband
  • /adminclan kick <user> <tag> - 强制将玩家从氏族中踢出。clancl.admin.kick
  • /adminclan ban <user> <tag> - 禁止玩家加入特定氏族。clancl.admin.ban
  • /adminclan unban <user> <tag> - 解除玩家在某氏族中的封禁。clancl.admin.unban

箱子与经济

  • /adminclan viewchest <tag> - 检查氏族箱子。
    • 只读检查:clancl.mod.viewchest
    • 完全管理控制:clancl.admin.viewchest
  • /adminclan deposit <amount> <tag> - 强制向氏族银行存入金钱。clancl.admin.deposit
  • /adminclan withdraw <amount> <tag> - 强制从氏族银行取出金钱。clancl.admin.withdraw

管理员聊天监听

  • /adminclan spy <tag> - 监控特定氏族的私人氏族和同盟频道(可叠加)。clancl.admin.spy
  • /adminclan spyall - 全局监控所有氏族和同盟聊天频道。clancl.admin.spy
  • /adminclan cancelspy - 停止监听所有频道(断开连接时自动清除)。clancl.admin.spy

系统与维护

  • /adminclan backup create - 创建数据库备份。clancl.admin.backup
  • /adminclan backup restore <filename> - 恢复数据库备份。clancl.admin.backup
  • /adminclan export - 将所有氏族数据导出为 JSON 格式。clancl.admin.export
  • /adminclan import <filename.json> - 从 JSON 导入氏族数据(覆盖当前数据)。clancl.admin.import
  • /adminclan reload - 重新加载配置文件和语言文件。clancl.admin.reload

权限结构

1. 服务器权限节点 (LuckPerms / GroupManager)

服务器权限仅管理管理员命令(/adminclan)。标准的 /clan 命令由氏族内部职位进行控制。

  • clancl.bypass.cooldowntp - 允许立即传送至 /clan home,无视冷却时间。
  • clancl.staff - 查看或自动补全 /adminclan 命令所需的基础管理权限。任何下方的子权限都会自动授予此权限。
  • clancl.admin.* - 完整的行政访问权限(包含所有 clancl.admin.* 和 clancl.mod.* 权限)。默认:OP(管理员)。
    • clancl.admin.viewchest - 完全控制任意氏族箱子。
    • clancl.admin.withdraw - 强制从氏族银行提取资金。
    • clancl.admin.deposit - 强制向氏族银行存入资金。
    • clancl.admin.disband - 强制解散氏族。
    • clancl.admin.kick - 强制将玩家踢出氏族。
    • clancl.admin.ban - 强制禁止玩家加入氏族。
    • clancl.admin.unban - 强制解除对玩家的氏族禁令。
    • clancl.admin.backup - 创建和恢复数据库备份。
    • clancl.admin.export - 将插件数据导出为 JSON 格式。
    • clancl.admin.import - 从 JSON 文件导入插件数据。
    • clancl.admin.reload - 重新加载配置文件和语言文件。
    • clancl.admin.spy - 拥有 spy、spyall 和 cancelspy 命令的访问权限。
  • clancl.mod.* - 版主权限节点。
    • clancl.mod.viewchest - 只读检查氏族箱子内容。

? PlaceholderAPI 占位符

如果玩家不在任何氏族中,所有占位符均返回空值("")(可在 placeholders.no-clan 配置文件中设置)。

玩家氏族信息

  • %clancl_name% — 显示玩家的氏族名称。
  • %clancl_tag% — 显示带有等级前缀的格式化标签(例如 &7[&6**STAFF&7]&r)。
  • %clancl_tag_raw% — 原始氏族标签,不含括号或颜色代码。
  • %clancl_level% — 当前氏族等级。
  • %clancl_points% — 升至下一等级所需的进度点数。
  • %clancl_total_points% — 累计的终身氏族总点数。
  • %clancl_clan_kills% — 所有氏族成员累计的终身击杀数。
  • %clancl_bank% — 银行余额整数(原始值)。
  • %clancl_bank_formatted% — 格式化后的银行余额(例如 50.000)。
  • %clancl_members% — 成员总数。
  • %clancl_members_online% — 在线成员数量。

玩家在氏族中的统计数据

  • %clancl_role% — 带颜色代码的翻译后角色名称。
  • %clancl_role_symbol% — 角色符号前缀(**, *, +, ~, -)。
  • %clancl_kills% — 玩家个人的击杀数。
  • %clancl_deaths% — 玩家个人的死亡数。

盟友与敌人

  • %clancl_ally_1% 到 %clancl_ally_5% — 指定槽位的盟友氏族名称。添加 _tag 可获取标签(例如 %clancl_ally_1_tag%)。
  • %clancl_enemy_1% 到 %clancl_enemy_10% — 指定槽位的敌对氏族名称。添加 _tag 可获取标签(例如 %clancl_enemy_1_tag%)。 (未分配的槽位默认返回 NONE)

氏族排行榜(前 1–10 名)

按等级、终身点数和名称排序的全局排名。占位符不依赖于执行玩家的身份,每 5 分钟更新一次(或在氏族创建/解散时即时更新)。未分配的槽位返回 Not found。

  • %clancl_top_N_name% — 第 N 名氏族的名称。
  • %clancl_top_N_tag% — 第 N 名氏族的标签。
  • %clancl_top_N_level% — 第 N 名氏族的等级。
  • %clancl_top_N_points% — 第 N 名氏族的终身总点数。

(使用示例:%clancl_top_1_name%, %clancl_top_10_level%)


?️ 图片

This image shows the plugin's main menu, displaying basic information for each clan.


⚙️ 要求与兼容性

  • 服务器软件: Paper / Purpur / Folia (1.21.1 或更高版本)
  • Java 版本: Java 21+

依赖项:

  • Vault + 经济插件提供商(EssentialsX、EconomyManager 等),用于实现银行功能。
  • PlaceholderAPI(聊天、TAB 栏和全息图标签所必需)。
  • LuckPerms(推荐)
  • 已测试的聊天格式化器: LPC (Simple Chat Formatter)、InteractiveChat。(可选)

? 安装

  1. 下载最新的 ClanCL-1.1.8.jar。
  2. 将文件放入服务器的 plugins/ 目录中。
  3. 确保已安装 Vault 和 PlaceholderAPI。
  4. 重启服务器。
  5. 根据需要配置 plugins/ClanCL/config.yml!

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源