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%)
?️ 图片

⚙️ 要求与兼容性
- 服务器软件: Paper / Purpur / Folia (1.21.1 或更高版本)
- Java 版本: Java 21+
依赖项:
- Vault + 经济插件提供商(EssentialsX、EconomyManager 等),用于实现银行功能。
- PlaceholderAPI(聊天、TAB 栏和全息图标签所必需)。
- LuckPerms(推荐)
- 已测试的聊天格式化器: LPC (Simple Chat Formatter)、InteractiveChat。(可选)
? 安装
- 下载最新的
ClanCL-1.1.8.jar。
- 将文件放入服务器的
plugins/ 目录中。
- 确保已安装 Vault 和 PlaceholderAPI。
- 重启服务器。
- 根据需要配置
plugins/ClanCL/config.yml!
ClanCL is a fast, lightweight Minecraft Paper plugin that enables players to form clans, share resources and economy, and display custom clan tags across the server.
✨ Features
- Custom Clan Tags: Fully dynamic clan tags with PlaceholderAPI support.
- Shared Clan Chest: Secure, multi-slot shared inventory (
/clan chest) for clan members to share items.
- Clan Bank System: Integrated economy through Vault so clans can deposit, withdraw, and manage shared funds.
- Member & Role Management: Flexible invite systems, kicks, and bans.
- PlaceholderAPI Integration: Ready out of the box for TAB, InteractiveChat, DecentHolograms, and modern chat formatters (LPC, EssentialsX, etc.).
- Dynamic Display Names: Automatically updates player display names on clan events (join, leave, create, tag change).
- Comprehensive Admin Control: Full administrative suite to inspect chests, modify balances, and manage any clan forcibly.
- Clean & Customizable Configs: Clean YAML configurations with multi-line help menus (
usage: |-).
? Commands & Permissions
Player Commands (/clan)
(Player command access is managed via in-clan role permissions rather than server permission nodes)
Clan Management
/clan create <name> <tag> - Create a new clan. The name is formatted as Xxxxx and the tag in uppercase.
/clan invite <player> - Invite a player to join your clan (Default: Captain+).
/clan join <tag> - Accept a pending clan invitation.
/clan leave - Leave your current clan (Leaders cannot leave without disbanding or transferring ownership).
/clan disband <name> <tag> - Request clan deletion (Leader only).
/clan confirm disband - Confirm clan deletion (expires after 60 seconds).
Members & Ranks
/clan kick <player> - Kick a member from the clan (Default: Captain+).
/clan ban <player> - Kick and blacklist a player from joining (Default: Co-Leader+).
/clan unban <player> - Remove a player from the clan blacklist (Default: Co-Leader+).
/clan promote <player> - Promote a clan member (Default: Captain+).
/clan demote <player> - Demote a clan member (Default: Captain+).
Bank, Home & Chest
/clan bank - View the current clan bank balance.
/clan bank deposit <amount> - Deposit money into the clan bank (whole numbers only). Available to all members.
/clan bank withdraw <amount> - Withdraw money from the clan bank (whole numbers only) (Default: Co-Leader+).
/clan sethome - Set the clan home location (Default: Co-Leader+).
/clan home - Teleport to the clan home (3-second warmup, cancels on movement).
/clan chest - Open the shared clan chest (Default: Veteran+).
Diplomacy & PvP
/clan ally <tag> - Send an alliance request to another clan.
/clan accept ally <tag> - Accept a pending alliance request.
/clan deny ally <tag> - Reject a pending alliance request.
/clan unally <tag> - Break an alliance with a clan.
/clan enemy <tag> - Declare another clan as an enemy (no acceptance required).
/clan unenemy <tag> - Remove a clan from the enemy list.
/clan pvp - Toggle friendly fire within your clan.
/clan pvp ally <tag> - Toggle friendly fire with an allied clan.
(All diplomacy commands default to Co-Leader+)
Chat & Info
/clan chat - Toggle exclusive clan-only chat channel.
/clan chatally - Toggle alliance-wide chat channel.
/clan online - List online clan members.
/clan menu - Open the main clan GUI menu (also /clan).
/clan info [tag] - Open the GUI menu for your clan or another clan.
Admin Commands (/adminclan or /aclan)
(Hidden from tab-complete and execution if the user lacks staff permissions)
Clan & Member Management
/adminclan disband <name> <tag> - Forcefully disband a clan (bank balance is transferred to the admin). clancl.admin.disband
/adminclan kick <user> <tag> - Forcefully kick a player from a clan. clancl.admin.kick
/adminclan ban <user> <tag> - Ban a player from joining a specific clan. clancl.admin.ban
/adminclan unban <user> <tag> - Unban a player from a clan. clancl.admin.unban
Chest & Economy
/adminclan viewchest <tag> - Inspect a clan chest.
- Read-only inspection:
clancl.mod.viewchest
- Full management control:
clancl.admin.viewchest
/adminclan deposit <amount> <tag> - Force deposit money into a clan bank. clancl.admin.deposit
/adminclan withdraw <amount> <tag> - Force withdraw money from a clan bank. clancl.admin.withdraw
Admin Chat Spy
/adminclan spy <tag> - Monitor private clan and ally channels for a specific clan (stackable). clancl.admin.spy
/adminclan spyall - Monitor all clan and alliance chat channels globally. clancl.admin.spy
/adminclan cancelspy - Stop spying on all channels (automatically cleared on disconnect). clancl.admin.spy
System & Maintenance
/adminclan backup create - Create a database backup. clancl.admin.backup
/adminclan backup restore <filename> - Restore a database backup. clancl.admin.backup
/adminclan export - Export all clan data to JSON format. clancl.admin.export
/adminclan import <filename.json> - Import clan data from JSON (overwrites current data). clancl.admin.import
/adminclan reload - Reload configurations and language files. clancl.admin.reload
Permissions Structure
1. Server Permission Nodes (LuckPerms / GroupManager)
Server permissions only govern administrative commands (/adminclan). Standard /clan commands are controlled internally by clan ranks.
clancl.bypass.cooldowntp - bypass to immediately teleport home /clan home.
clancl.staff - Base staff permission required to see or autocomplete /adminclan. Automatically granted by any child permission below.
clancl.admin.* - Full administrative access (includes all clancl.admin.* and clancl.mod.* permissions). Default: OP.
clancl.admin.viewchest - Full control over any clan chest.
clancl.admin.withdraw - Force withdraw funds from clan banks.
clancl.admin.deposit - Force deposit funds into clan banks.
clancl.admin.disband - Force disband clans.
clancl.admin.kick - Force kick players from clans.
clancl.admin.ban - Force ban players from clans.
clancl.admin.unban - Force unban players from clans.
clancl.admin.backup - Create and restore database backups.
clancl.admin.export - Export plugin data to JSON.
clancl.admin.import - Import plugin data from JSON.
clancl.admin.reload - Reload configs and language files.
clancl.admin.spy - Access to spy, spyall, and cancelspy commands.
clancl.mod.* - Moderator permission node.
clancl.mod.viewchest - Read-only inspection of clan chests.
? PlaceholderAPI Placeholders
All placeholders return empty ("") if the player is not in a clan (configurable in placeholders.no-clan).
Player's Clan Info
%clancl_name% — Displays the player's clan name.
%clancl_tag% — Displays formatted tag with rank prefix (e.g., &7[&6**STAFF&7]&r).
%clancl_tag_raw% — Raw clan tag without brackets or color codes.
%clancl_level% — Current clan level.
%clancl_points% — Progress points toward the next level.
%clancl_total_points% — Total lifetime clan points accumulated.
%clancl_clan_kills% — Total lifetime kills accumulated by all clan members.
%clancl_bank% — Raw bank balance integer.
%clancl_bank_formatted% — Formatted bank balance (e.g., 50.000).
%clancl_members% — Total member count.
%clancl_members_online% — Online member count.
Player Stats within Clan
%clancl_role% — Translated role name with color codes.
%clancl_role_symbol% — Role symbol prefix (**, *, +, ~, -).
%clancl_kills% — Individual player kills.
%clancl_deaths% — Individual player deaths.
Allies & Enemies
%clancl_ally_1% to %clancl_ally_5% — Name of the allied clan at specified slot. Add _tag for the tag (e.g., %clancl_ally_1_tag%).
%clancl_enemy_1% to %clancl_enemy_10% — Name of the enemy clan at specified slot. Add _tag for the tag (e.g., %clancl_enemy_1_tag%).
(Unassigned slots return NONE by default)
Clan Leaderboards (Top 1–10)
Global rankings sorted by level, lifetime points, and name. Placeholders do not depend on the executing player and update every 5 minutes (or instantly upon clan creation/disbandment). Unassigned slots return Not found.
%clancl_top_N_name% — Name of the Top N clan.
%clancl_top_N_tag% — Tag of the Top N clan.
%clancl_top_N_level% — Level of the Top N clan.
%clancl_top_N_points% — Total lifetime points of the Top N clan.
(Example usage: %clancl_top_1_name%, %clancl_top_10_level%)
?️ Images

⚙️ Requirements & Compatibility
- Server Software: Paper / Purpur / Folia (1.21.1 or higher)
- Java Version: Java 21+
Dependencies:
- Vault + Economy provider (EssentialsX, EconomyManager, etc.) for bank functionality.
- PlaceholderAPI (Obligatory for chat, TAB, and hologram tags).
- LuckPerms (Recommended)
- Tested Chat Formatters: LPC (Simple Chat Formatter), InteractiveChat. (optional)
? Installation
- Download the latest
ClanCL-1.1.8.jar.
- Place the file in your server's
plugins/ directory.
- Ensure Vault and PlaceholderAPI are installed.
- Restart your server.
- Configure
plugins/ClanCL/config.yml to your liking!
评论 0
登录后参与评分
还没有评论,来抢沙发吧