⚔️ ClanSystem
适用于 Paper 1.21.x 的完整氏族系统,配有图形用户界面 (GUI)。
创建氏族、邀请玩家、分配角色、共享氏族家园和氏族末影箱,收集击杀数并在头顶显示你的氏族标签。所有功能均通过单一菜单 /clan 运行。
无依赖项: 无需 Vault、数据库或阴影处理。支持 PlaceholderAPI,但为可选。
? 内置英语和德语。 在 config.yml 中使用 language: en 或 language: de 进行切换——或者添加你自己的语言文件。
✨ 功能
? 氏族与角色
- 三种角色:所有者 (Owner)、经理 (Manager)(最多 2 名)和成员 (Member),各自拥有固定的权限
- 成员上限为 10,VIP 氏族为 15(所有者需具备
clan.vip 权限),两者均可配置
- 命名规则:3–5 个字符,仅限字母和数字,自动转为大写,并设有黑名单(如
ADMIN、MOD、TEAM …)
- 可选:创建氏族的最低经验等级以及两次创建之间的冷却时间
- 转移所有权、晋升/降级经理、踢出成员
?️ 完整的 GUI
/clan 打开所有功能:氏族信息、成员、邀请、角色、家园、末影箱、统计、设置
- 离开、解散和转移所有权均需通过确认对话框
- 每个按钮均可配置: 材质、槽位、名称、描述、数量、发光效果、自定义模型数据——或者完全隐藏
- 可调整菜单大小,列表中使用玩家头像,支持分页导航
- 菜单项目无法被取出或复制
✉️ 邀请
- 聊天中提供可点击的 接受 (Accept) 和 拒绝 (Deny) 按钮,带有悬停文本
- 邀请在 120 秒后过期(可配置,或禁用过期机制)
- 也可在 GUI 中接受或拒绝邀请
- 氏族会收到关于邀请、加入和拒绝的通知
? 氏族家园
- 每个氏族拥有一个共享家园,由所有者或经理设置
- 传送带有延迟(默认 5 秒),移动或受到伤害时取消传送
- 可配置冷却时间和禁止传送的世界
? 氏族末影箱
- 为整个氏族提供共享存储,共 54 格(双容器)
- 多名玩家可以同时打开,且不会发生任何复制漏洞
- 每次点击都会检查权限:被踢出的玩家将立即失去访问权限
- 可以屏蔽特定物品
- 当氏族解散时,其内容将被删除、掉落或交给所有者——由你选择
? 统计数据
- 记录每位玩家的击杀、死亡数和 K/D 比,以及氏族的总计数据
- 在统计菜单中显示氏族成员的击杀排行榜
- 三种数据源可供选择:
VANILLA – Minecraft 原生统计,回溯计算之前的所有击杀(默认)
INTERNAL – 内部计数器,从安装时开始计数
PLACEHOLDER – 来自其他插件的值
- 离线成员包含在氏族总计中
?️ 姓名标签与列表
- 名称前显示氏族标签,位于头顶上方及列表中,例如
[ABC] Steve
- 名称下方可自定义一行文字,例如
[ABC] 25 ⚔
- 列表按氏族排序
- 使用自定义符号作为占位符(
%sword% ⚔, %skull% ☠, %heart% ❤, %star% ✦ …)
? 氏族颜色
- 所有者可为其氏族名称着色(16 种颜色 + 粗体)——可通过 GUI 或
/clan color 命令设置
- 可选的独立权限支持自由十六进制颜色
? 氏族聊天
/clan chat <message> 仅向你的氏族发送消息
- 工作人员可使用聊天间谍功能(权限:
clan.chatspy)
⚙️ 氏族设置
每个氏族均可在 GUI 中切换以下选项:
- 友军伤害开/关
- 允许普通成员使用氏族家
- 允许普通成员使用氏族末影箱
- 氏族聊天开/关
? PlaceholderAPI(可选)
集成支持双向交互。
ClanSystem → 其他插件(记分板、TAB、聊天、全息图……):
| 占位符 |
内容 |
%clansystem_clan% |
氏族名称 |
%clansystem_tag% |
格式化后的标签,例如 [ABC] |
%clansystem_role% |
角色 |
%clansystem_members% / %clansystem_limit% |
成员数量 / 上限 |
%clansystem_kills% / %clansystem_deaths% / %clansystem_kd% |
玩家统计数据 |
%clansystem_clan_kills% / %clansystem_clan_kd% |
氏族统计数据 |
%clansystem_has_clan% |
true / false |
此外还可用:owner、managers、clan_deaths、clan_count、home、vip、role_raw、clan_plain 和 clan_color。
其他插件 → ClanSystem:来自其他插件的占位符可在姓名标签、氏族聊天、所有消息以及每个 GUI 物品中使用。
? 命令
| 命令 |
适用对象 |
描述 |
/clan |
所有人 |
打开氏族菜单 |
/clan help |
所有人 |
命令概览 |
/clan create <name> |
所有人 |
创建氏族 |
/clan info [clan] |
所有人 |
氏族信息 |
/clan members [clan] |
所有人 |
成员列表 |
/clan accept [clan] |
受邀玩家 |
接受邀请 |
/clan deny [clan] |
受邀玩家 |
拒绝邀请 |
/clan invite <player> |
族长、管理员 |
邀请一名玩家 |
/clan kick <player> |
族长、管理员 |
移除一名成员 |
/clan promote <player> |
族长 |
晋升为管理员 |
/clan demote <player> |
族长 |
降级一名管理员 |
/clan transfer <player> |
族长 |
转移所有权 |
/clan leave |
管理员、成员 |
退出氏族 |
/clan home |
所有成员 |
传送至氏族家园 |
/clan home set / delete |
族长、管理员 |
设置/删除氏族家园 |
/clan enderchest |
所有成员 |
打开氏族末影箱 |
/clan chat <message> |
所有成员 |
向氏族发送消息 |
/clan color <color|bold|reset> |
族长 |
修改氏族名称颜色 |
/clan delete |
族长 |
解散氏族 |
/clan reload |
管理员 |
重新加载配置 |
/clan admin <list|info|delete|setlimit|reload> |
管理员 |
管理氏族 |
别名:/clans 和 /clansystem。所有命令均支持 Tab 补全。
? 权限
| 权限 |
默认值 |
描述 |
clan.use |
everyone |
基本命令与 GUI |
clan.create |
everyone |
创建氏族 |
clan.vip |
– |
拥有者氏族的 VIP 成员上限 |
clan.chatspy |
OP |
读取所有氏族聊天 |
clan.color.hex |
OP |
氏族名称自由使用十六进制颜色 |
clan.bypass.limit |
OP |
绕过成员上限和等级要求 |
clan.bypass.name |
OP |
绕过名称规则 |
clan.bypass.cooldown |
OP |
绕过冷却时间与传送延迟 |
clan.admin |
OP |
以上所有权限 + 管理员命令 |
?️ 配置
config.yml – 语言、上限、名称规则、家、末影箱、统计信息、名牌标签、聊天格式以及 GUI 布局
lang/en.yml 和 lang/de.yml – 所有文本:消息、菜单标题、按钮名称、物品描述(lore)和日期格式,支持 & 颜色代码和十六进制颜色(&#RRGGBB)
- 自定义语言:复制
en.yml,翻译后并将 language 设置为该文件名
/clan reload 可在无需重启的情况下应用更改——包括切换语言
已在使用名牌插件?
ClanSystem 通过记分板队伍设置氏族标签。如果你已经在使用 TAB 或类似插件,请使用 nametag.enabled: false 关闭内置的名牌功能,并在那里改用 %clansystem_...% 占位符。
? 存储与性能
- 数据以 YAML 格式存储,每个氏族一个文件,位于
plugins/ClanSystem/data/ 目录下
- 保存操作异步运行,每 5 分钟自动保存一次(可配置)
- 氏族末影箱中的物品可以留存至 Minecraft 更新之后
- 除自动保存外,后台无其他重复任务运行
? 要求
- Paper 1.21.x
- Java 21
- 可选:PlaceholderAPI
- 不支持 Spigot 和 Folia
由 NanoNope 制作
⚔ ClanSystem
A complete clan system with a GUI for Paper 1.21.x.
Create clans, invite players, hand out roles, share a clan home and a clan ender chest, collect kills and wear your clan tag above your head. Everything runs through a single menu: /clan.
No dependencies: no Vault, no database, no shading. PlaceholderAPI is supported but optional.
? English and German built in. Switch with language: en or language: de in config.yml – or add your own language file.
✨ Features
? Clans & Roles
- Three roles: Owner, Manager (up to 2) and Member, each with fixed permissions
- Member limit of 10, or 15 for VIP clans (the owner needs
clan.vip), both configurable
- Name rules: 3–5 characters, letters and numbers only, automatically uppercase, with a blacklist (
ADMIN, MOD, TEAM …)
- Optional: minimum XP level to create a clan and a cooldown between two creations
- Transfer ownership, promote and demote managers, kick members
?️ Full GUI
/clan opens everything: clan info, members, invites, roles, home, ender chest, statistics, settings
- Leaving, disbanding and transferring ownership go through a confirmation dialog
- Every button is configurable: material, slot, name, lore, amount, glow, custom model data – or hide it completely
- Adjustable menu sizes, player heads in lists, page navigation
- Menu items can't be taken out or duplicated
✉️ Invites
- Clickable Accept and Deny buttons in chat, with hover text
- Invites expire after 120 seconds (configurable, or disable expiry)
- Invites can also be accepted or denied in the GUI
- The clan gets notified about invites, joins and declines
? Clan Home
- One shared home per clan, set by the owner or a manager
- Teleport with a delay (5 seconds by default), cancelled on movement or damage
- Configurable cooldown and blocked worlds
? Clan Ender Chest
- Shared storage with 54 slots (double chest) for the whole clan
- Several players can open it at the same time without any duplication exploits
- Permissions are checked on every click: kicked players lose access instantly
- Specific items can be blocked
- When a clan is disbanded, the contents are deleted, dropped or given to the owner – your choice
? Statistics
- Kills, deaths and K/D for every player and as a total for the clan
- Kill leaderboard of the clan's members in the statistics menu
- Three sources to choose from:
VANILLA – Minecraft statistics, counts all previous kills retroactively (default)
INTERNAL – own counter, starting at installation
PLACEHOLDER – values from any other plugin
- Offline members are included in the clan total
?️ Nametags & Tab List
- Clan tag in front of the name, above the head and in the tab list, e.g.
[ABC] Steve
- Fully customizable line below the name, e.g.
[ABC] 25 ⚔
- Tab list sorted by clan
- Custom symbols as placeholders (
%sword% ⚔, %skull% ☠, %heart% ❤, %star% ✦ …)
? Clan Color
- Owners can color their clan name (16 colors + bold) – in the GUI or with
/clan color
- Optional free hex colors behind a separate permission
? Clan Chat
/clan chat <message> sends a message to your own clan only
- Chat spy for staff (
clan.chatspy)
⚙️ Clan Settings
Every clan can toggle these in the GUI:
- Friendly fire on/off
- Allow regular members to use the clan home
- Allow regular members to use the clan ender chest
- Clan chat on/off
? PlaceholderAPI (optional)
The integration works both ways.
ClanSystem → other plugins (scoreboard, TAB, chat, holograms …):
| Placeholder |
Content |
%clansystem_clan% |
Clan name |
%clansystem_tag% |
Formatted tag, e.g. [ABC] |
%clansystem_role% |
Role |
%clansystem_members% / %clansystem_limit% |
Member count / limit |
%clansystem_kills% / %clansystem_deaths% / %clansystem_kd% |
Player stats |
%clansystem_clan_kills% / %clansystem_clan_kd% |
Clan stats |
%clansystem_has_clan% |
true / false |
Also available: owner, managers, clan_deaths, clan_count, home, vip, role_raw, clan_plain and clan_color.
Other plugins → ClanSystem: placeholders from other plugins work in nametags, clan chat, all messages and every GUI item.
? Commands
| Command |
Who |
Description |
/clan |
everyone |
Opens the clan menu |
/clan help |
everyone |
Command overview |
/clan create <name> |
everyone |
Create a clan |
/clan info [clan] |
everyone |
Clan information |
/clan members [clan] |
everyone |
Member list |
/clan accept [clan] |
invited players |
Accept an invite |
/clan deny [clan] |
invited players |
Deny an invite |
/clan invite <player> |
Owner, Manager |
Invite a player |
/clan kick <player> |
Owner, Manager |
Remove a member |
/clan promote <player> |
Owner |
Promote to manager |
/clan demote <player> |
Owner |
Demote a manager |
/clan transfer <player> |
Owner |
Transfer ownership |
/clan leave |
Manager, Member |
Leave the clan |
/clan home |
all members |
Teleport to the clan home |
/clan home set / delete |
Owner, Manager |
Set / delete the clan home |
/clan enderchest |
all members |
Open the clan ender chest |
/clan chat <message> |
all members |
Message your clan |
/clan color <color|bold|reset> |
Owner |
Color the clan name |
/clan delete |
Owner |
Disband the clan |
/clan reload |
Admin |
Reload the configuration |
/clan admin <list|info|delete|setlimit|reload> |
Admin |
Manage clans |
Aliases: /clans and /clansystem. Tab completion works for every command.
? Permissions
| Permission |
Default |
Description |
clan.use |
everyone |
Basic commands and GUI |
clan.create |
everyone |
Create a clan |
clan.vip |
– |
The owner's clan gets the VIP member limit |
clan.chatspy |
OP |
Read all clan chats |
clan.color.hex |
OP |
Free hex colors for the clan name |
clan.bypass.limit |
OP |
Bypass the member limit and level requirement |
clan.bypass.name |
OP |
Bypass the name rules |
clan.bypass.cooldown |
OP |
Bypass cooldowns and the teleport delay |
clan.admin |
OP |
All permissions above + admin commands |
?️ Configuration
config.yml – language, limits, name rules, home, ender chest, statistics, nametags, chat format and the GUI layout
lang/en.yml and lang/de.yml – every text: messages, menu titles, button names, lore and the date format, with & color codes and hex colors (&#RRGGBB)
- Your own language: copy
en.yml, translate it and set language to the file name
/clan reload applies changes without a restart – including a language switch
Already using a nametag plugin?
ClanSystem sets clan tags through scoreboard teams. If you already use TAB or a similar plugin, turn off the built-in nametags with nametag.enabled: false and use the %clansystem_...% placeholders there instead.
? Storage & Performance
- Data is stored as YAML, one file per clan in
plugins/ClanSystem/data/
- Saving runs asynchronously, with an autosave every 5 minutes (configurable)
- Items in the clan ender chest survive Minecraft updates
- Apart from the autosave, no repeating tasks run in the background
? Requirements
- Paper 1.21.x
- Java 21
- Optional: PlaceholderAPI
- Spigot and Folia are not supported
Made by NanoNope
评论 0
登录后参与评分
还没有评论,来抢沙发吧