? CrownClans
专为 Minecraft 生存、SMP、PvP 和角色扮演服务器设计的 GUI 家族系统。
CrownClans 为玩家提供了组建团队并随时间发展的动力。创建家族,招募成员,赚取积分,解锁共享储物箱,管理金库,协商联盟,宣战,并向轮换的买家出售资源。
该插件使用游戏内库存菜单来处理大多数操作。玩家无需记忆冗长的命令列表:输入 /clan 或 /c 即可根据当前情况打开相应的界面。
不需要客户端模组。 玩家使用正常的 Minecraft 库存、聊天提示和命令。
? 对玩家的工作方式
加入家族之前
没有家族的玩家打开 /clan 后会看到一个起始菜单,其中包含以下选项:
- 创建家族,需支付可配置金额的费用。
- 浏览家族,按加入方式进行筛选。
- 查看家族排行榜及公开的家族信息。
- 使用全局买家出售可用资源。
在浏览家族时,玩家可以选择三种加入方式:
| 加入方式 |
发生的情况 |
| 开放 |
如果家族有空位,玩家立即加入 |
| 申请 |
发送请求;家族工作人员可以在 GUI 中接受或拒绝 |
| 付费 |
玩家支付家族的入门费;费用将加入家族金库 |
默认情况下,创建家族的费用为 5,000。新家族的付费入门费默认为 1,000。这两个值都可以在 config.yml 中更改。
名称可以包含 Minecraft 颜色代码,例如 &a。默认可见名称长度为 2–6 个字母或数字;格式化代码不计入可见字符。
加入家族之后
同样的 /clan 命令会打开家族仪表板,而不是起始菜单。在那里,成员可以访问:
- 家族名称、当前等级、积分以及下一级所需的积分。
- 金库余额及其当前容量。
- 成员列表和个人统计数据。
- 共享家族储物箱。
- 盟友、敌人及其他家族关系。
- 家族家园。
- 家族买家和全局买家。
- 资源捐赠和家族排行榜。
- 在其家族角色允许的情况下进行的管理设置。
当菜单需要名称或数字时,它会要求玩家在聊天中输入该值。输入 cancel 以放弃该提示。
? 家族等级、积分和储物箱
CrownClans 有 9 个家族等级。服务器所有者可以编辑每个等级的总积分要求。更高等级会增加金库容量并解锁更多共享储物箱。
| 等级 |
默认金库容量 |
共享储物箱槽位 |
| 1 |
100,000 |
9 |
| 2 |
250,000 |
18 |
| 3 |
500,000 |
27 |
| 4 |
1,000,000 |
36 |
| 5 |
2,000,000 |
45 |
| 6 |
3,500,000 |
54 |
| 7 |
5,000,000 |
63 |
| 8 |
7,500,000 |
72 |
| 9 |
10,000,000 |
81 |
储物箱最多有 两页。一次只能由一名家族成员编辑;其他成员仍可打开只读视图。这有助于防止两名玩家同时更改相同的存储物品。
默认战斗积分
| 行为 |
积分 |
| 击杀敌对家族的成员 |
+150 |
| 击杀中立玩家 |
+35 |
| 击杀盟友 |
−100 |
| 击杀家族成员 |
−150 |
所有这些值都是可配置的。默认情况下适用 30 分钟重复受害者冷却时间,以便同一对手不能连续被刷分。
成员还可以通过 GUI 捐赠普通资源:
| 捐赠资源 |
默认每项积分 |
| 钻石 |
3 |
| 远古残骸 |
15 |
| 下界合金锭 |
30 |
家族买家在向它出售有价值资源时还可以额外奖励积分。玩家可以在仪表板上看到自己的击杀数、死亡数、K/D 比率、在家族中的时间以及在线时间。
? 外交与 PvP
联盟需要双方同意。 一个家族发送提案,另一个家族接受它。一个家族也可以终止现有的联盟。
战争在授权的家族成员宣布后立即开始。 服务器会在聊天中宣布这一声明。结束战争则不同:两个家族都必须确认和平,战争才会结束。
家族工作人员可以配置:
- 同家族成员之间的 PvP。
- 联盟家族之间的 PvP。
- 家族成员和盟友是否获得彩色名称高亮显示。
- 附近的敌人是否获得彩色名称高亮显示。
敌人高亮显示仅适用于默认半径 7 格 内的范围,并且需要视线。它通过计分板队伍改变名称颜色;它不是玩家模型周围的发光轮廓。
? 家族家园与旗帜
每个家族可以有 一个家族家园。副首领或首领可以设置或删除它。一旦存在家园,所有家族成员都可以使用 /clanhome。
传送使用带有 5 秒倒计时 的 Boss 栏。随着传送接近,其颜色会发生变化。服务器所有者可以配置移动和伤害来取消传送。
首领可以在 GUI 中自定义家族旗帜:
其他玩家可以在首领上方看到临时旗帜,而不会永久替换首领的盔甲。在家族家园会出现家族旗帜的动画版本。
? 经济与轮换买家
CrownClans 可以使用其内置经济或通过 Vault 连接的经济。
- 如果有注册的 Vault 经济提供商,家族付款使用该提供商。
- 如果没有,CrownClans 使用其内部余额。
- 默认起始内部余额为每位新玩家 10,000。
- Vault 本身不提供经济;另一个插件必须注册实际余额提供商。
全局买家
全局买家默认显示多达 18 个报价。玩家出售列出的资源,款项直接支付给该玩家。每个报价都有各自的剩余库存。
家族买家
每个氏族都会收到最多 15 个专属报价。提供给其他氏族的物品和价格可能不同。这些销售所得款项将存入氏族金库,受其容量限制。
氏族买家还有一个销售倍率。默认设置下,它从 x1 开始,在卖出 1,000 件物品后达到 x1.5,最终在卖出 350,000 件物品后达到 x10。倍率步进可在配置中编辑。
买卖双方默认每 5 小时轮换一次报价。价格在配置的限制范围内随机生成,且每个报价都有有限的库存。贵重材料的库存范围可以配置得比普通材料更小。
普通点击可出售最多 64 件匹配物品。Shift+点击会尝试出售更多,上限受玩家库存、报价库存以及氏族销售时的可用金库空间限制。带有物品元数据的自定义物品不参与买家销售。
? 角色与管理权限
氏族角色决定了谁可以管理氏族。它们独立于 Bukkit 权限。
| 角色 |
玩家可执行的操作 |
| 成员 (Member) |
查看仪表板和成员列表,使用已解锁的存储和氏族家园,存款,捐赠资源并使用买家 |
| 官员 (Officer) |
成员的所有操作,加上邀请、审核申请、踢出低级别成员以及部分氏族高亮设置 |
| 副官 (Deputy) |
官员的所有操作,加上外交、准入模式和费用更改、友军伤害设置,以及设置或删除氏族家园 |
| 所有者 (Owner) |
完全管理:提取金库资金、重命名氏族、分配角色、转让领导权、编辑旗帜并解散氏族 |
官员无法踢出其他官员、副官或所有者。只有所有者可以分配角色或转让所有权。
金库旨在用于集体贡献:所有成员都可以存款,但只有所有者可以取款。其他氏族可以看到公开的氏族档案,但管理界面仅限授权成员访问。
? 平台与版本
| 平台 |
当前验证状态 |
| Paper 1.21.11 |
已在 Java 21 环境下进行过游戏内测试 |
| Folia 26.2 |
插件启动已在 Java 25 上检查;多人游戏测试待定 |
| Paper 26.3 build 41 alpha |
插件启动已在 Java 25 上检查;完整游戏测试待定 |
| Spigot / Bukkit / Purpur |
基于 Spigot API 1.21.11 构建;单独的实际测试待定 |
| BungeeCord |
包含命令桥接功能;代理实际测试待定 |
JAR 包针对 Java 21 编译。启动服务器所使用的 Java 版本也必须满足该特定 Minecraft 服务器构建的要求。
BungeeCord 设置
在代理和游戏服务器上安装相同的 CrownClans JAR 文件。代理桥接会将 /clan、/c 和 /clanhome 转发到已连接的游戏服务器。
氏族状态保留在游戏服务器上。此测试版不会在多个独立的游戏服务器之间同步实时氏族数据,即使这些服务器指向同一个 SQL 数据库。
? 可选集成
| 插件 |
是否必需? |
用途 |
| Vault |
否 |
将氏族支付连接到外部经济系统 |
| 兼容 Vault 的经济提供商 |
仅在需要 Vault 经济时 |
提供玩家的真实余额 |
| PlaceholderAPI |
否 |
使 CrownClans 数值能在兼容记分板、TAB 显示和其他插件中使用 |
CrownClans 可以使用其内置经济系统和自己的 GUI 独立运行,无需这些集成。安装 PlaceholderAPI 后,crownclans 扩展会自动注册;无需下载单独的 eCloud 扩展。
? 命令
大多数玩家操作也对应 GUI 按钮。
| 命令 |
功能 |
/clan, /c |
打开主菜单或氏族仪表板 |
/clan create <name> |
创建氏族 |
/clan join <clan> |
加入或申请,取决于氏族的准入模式 |
/clan apply <clan> |
加入操作的替代方式 |
/clan invite <player> |
邀请一名玩家 |
/clan kick <player> |
移除低级别成员 |
/clan leave |
离开氏族 |
/clan disband |
作为所有者解散氏族 |
/clan deposit <amount> |
向金库存入资金 |
/clan withdraw <amount> |
作为所有者提取资金 |
/clan ally <clan> |
提议或接受结盟 |
/clan break <clan> |
结束联盟 |
/clan war <clan> |
宣战 |
/clan peace <clan> |
提议或确认和平 |
/clan rename <name> |
作为所有者重命名氏族 |
/clan fee <amount> |
更改付费准入费用 |
/clanhome |
传送至氏族家园 |
/clanhome set <name> |
设置并命名氏族家园 |
/clanhome delete |
删除氏族家园 |
/clan storage status |
显示当前使用的存储类型 |
/clan storage migrate <TYPE> |
将氏族数据复制到另一种存储类型 |
? Bukkit 权限
CrownClans 目前拥有两个权限节点:
| 权限 |
默认值 |
效果 |
crownclans.use |
所有人 |
允许使用 /clan、/c、其子命令以及代理命令转发 |
crownclans.admin |
操作员 |
允许使用存储状态和存储迁移命令 |
LuckPerms 示例:
/lp group default permission set crownclans.use true
/lp group admin permission set crownclans.admin true
管理员权限控制存储管理;它不替代氏族内的角色。/clanhome 没有单独的 Bukkit 权限节点:传送需要是成员且存在家园,而设置或删除则需要副官或所有者权限。
? PlaceholderAPI 与记分板
如果记分板插件处理了 PlaceholderAPI 占位符,则可以在其中使用 CrownClans 的占位符。
例如,在适当的记分板 lines: 部分内:
lines:
- "&f氏族: &e%crownclans_name%"
- "&f等级: &a%crownclans_level%"
- "&f积分: &6%crownclans_points%"
- "&6#1 &f%crownclans_top_1_name% &7- &e%crownclans_top_1_points%"
- "&6#16 &f%crownclans_top_16_name% &7- &e%crownclans_top_16_points%"
周围的计分板语法取决于你使用的计分板插件。
| 占位符 |
输出 |
%crownclans_name% |
无颜色的氏族名称;如果玩家没有氏族则显示 нет |
%crownclans_name_colored% |
带有颜色代码的氏族名称 |
%crownclans_has_clan% |
true 或 false |
%crownclans_level% |
玩家的氏族等级,若无氏族则为 0 |
%crownclans_points% |
玩家的氏族积分 |
%crownclans_rank% |
玩家在氏族排行榜中的位置 |
%crownclans_members% |
氏族成员数量 |
%crownclans_treasury% |
国库余额 |
%crownclans_kills%, %crownclans_deaths%, %crownclans_kd% |
玩家统计数据 |
%crownclans_top_count% |
现有氏族的数量 |
%crownclans_top_16% |
排名第 16 的氏族的格式化行 |
%crownclans_top_16_name% |
排名第 16 的氏族名称 |
%crownclans_top_16_points% |
排名第 16 的氏族的积分 |
将 16 替换为其他正整数位置,例如 1、10 或 25。前几名条目也支持 _level、_members、_leader 和 _treasury。如果请求的位置不存在,默认输出为 —。
缺失氏族的文本、缺失排名的文本以及完整排名行的格式都可以在 config.yml 中更改。
⚙️ 配置示例
编辑生成文件中的命名条目。这些示例仅为摘录,不能替代整个配置文件。编辑后请重启服务器。
示例 1 — 较小服务器的更快进度
编辑 plugins/CrownClans/config.yml:
clan:
creation-cost: 2500
rename-cost: 750
max-name-length: 6
level-total-xp: [0, 500, 1800, 4000, 8000, 15000, 25000, 40000, 60000]
capacities: [100000, 250000, 500000, 1000000, 2000000, 3500000, 5000000, 7500000, 10000000]
combat:
enemy-kill-xp: 150
neutral-kill-xp: 35
ally-kill-xp: -100
same-clan-kill-xp: -150
repeat-victim-cooldown-seconds: 1800
这使得创建氏族和升级变得更加容易,同时保留了原有的国库进度。等级列表包含 九个总点数阈值,从等级 1 的 0 开始。
示例 2 — 买家库存和价格
在现有的 buyer.goods 列表中编辑特定条目:
buyer:
rotate-hours: 5
global-offers: 18
clan-offers: 15
price-random-factor-min: 0.80
price-random-factor-max: 1.20
goods:
STONE: '5:5000:9000'
DIAMOND: '250:200:500'
NETHERITE_INGOT: '1800:20:65'
每个物品使用 基础价格:最小库存:最大库存。例如,钻石的基础价格为 250,随机生成的库存介于 200 到 500 之间。随机价格因子随后可以使其实际价格低于或高于基础价格。
如果你想保留其他材料,请在现有文件内编辑列出的条目。
示例 3 — 买家倍数
config.yml 中的 multiplier-steps 列表使用 已售出物品总数:倍数:
buyer:
multiplier-steps:
- '0:1.0'
- '1000:1.5'
- '5000:2.0'
- '15000:3.0'
- '40000:4.0'
- '80000:5.0'
- '140000:6.0'
- '220000:7.5'
- '300000:9.0'
- '350000:10.0'
氏族从 x1 开始。通过这些设置,总共卖出 1,000 件物品可解锁 x1.5,而 350,000 件物品可解锁 x10。插件将结果倍数上限设置为 x10。
示例 4 — 自定义文本和传送
编辑 plugins/CrownClans/config.yml:
placeholders:
no-clan: 'нет'
no-top: '—'
top-format: '{rank}. {clan} | {points} points'
home:
delay-seconds: 5
cancel-on-move: true
cancel-on-damage: true
top-format 接受 {rank}、{clan}、{points}、{level} 和 {members}。例如,将 no-clan 更改为 'No Clan' 会改变 %crownclans_name% 对于无氏族玩家显示的文本。
? 语言
包含英文和俄文。 在 plugins/CrownClans/config.yml 中选择一种:
language: en
要创建另一种翻译:
- 将
plugins/CrownClans/lang/en.yml 复制到一个新文件,例如 lang/de.yml。
- 翻译显示的数值。
- 保留原始键和变量,如
{0} 和 {1}。
- 在
config.yml 中设置 language: de 并重启服务器。
缺失的翻译键将回退到英文。
?️ 数据存储
CrownClans 提供 11 种存储类型:
| 本地存储 |
服务器或自定义存储 |
FLATFILE, SQLITE, H2, HSQLDB |
MYSQL, MARIADB, POSTGRESQL, SUPABASE, SQLSERVER, ORACLE, CUSTOM_JDBC |
默认为 FLATFILE。要使用 SQLite,请编辑 plugins/CrownClans/storage.yml:
type: SQLITE
MySQL 设置使用同一文件中的连接设置:
type: MYSQL
host: localhost
port: 3306
database: crownclans
username: crownclans
password: 'replace-with-your-password'
SUPABASE 使用带有 SSL 的 PostgreSQL。CUSTOM_JDBC 需要兼容的 JDBC URL,并在必要时将驱动程序 JAR 放在插件文件夹中。
移动现有数据
- 备份当前的氏族数据。
- 配置目标数据库连接。
- 在玩家不更改氏族数据时运行
/clan storage migrate <TYPE>。
- 确认复制成功。
- 更改
storage.yml 中的 type 并重启服务器。
迁移命令 不会覆盖非空的目标位置,也 不会 自动切换活动的存储类型。本地 FLATFILE、SQLITE、H2 和 HSQLDB 存储已通过保存和重新打开测试;远程数据库仍需在各个服务器环境中进行测试。
? 安装
- 将 CrownClans JAR 文件放入游戏服务器的
plugins/ 目录中。
- 启动服务器一次,以生成
config.yml、storage.yml 和语言文件。
- 根据你的服务器需求调整价格、进度系统、存储设置及语言选项。
- 重启服务器。
- (可选)安装 Vault 及其经济插件 以及 PlaceholderAPI。
- 如果使用 BungeeCord 命令转发功能,请将相同的 JAR 文件也放置在代理服务器上。
Beta 状态说明: 已测试 Paper 1.21.11 的游戏玩法及 PlaceholderAPI 集成。Folia 26.2 和 Paper 26.3 alpha 版本已通过启动检查。Spigot、Bukkit、Purpur 和 BungeeCord 上的游戏玩法测试仍在进行中。名称高亮显示依赖于记分板队伍(scoreboard teams),因此其他记分板插件已有的名称标签队伍可能会优先生效。
? CrownClans
A GUI-focused clan system for Minecraft Survival, SMP, PvP and roleplay servers.
CrownClans gives players a reason to form teams and develop them over time. Create a clan, recruit members, earn points, unlock shared storage, manage a treasury, negotiate alliances, declare wars and sell resources to rotating buyers.
The plugin uses in-game inventory menus for most actions. Players do not need to memorize a long list of commands: /clan or /c opens the interface appropriate for their current situation.
No client-side mod is required. Players use normal Minecraft inventories, chat prompts and commands.
? How it works for players
Before joining a clan
A player without a clan opens /clan and sees a starting menu with options to:
- Create a clan for a configurable amount of money.
- Browse clans by joining method.
- View the clan leaderboard and public clan information.
- Use the global buyer to sell available resources.
When browsing clans, the player can choose between three joining methods:
| Joining method |
What happens |
| Open |
The player joins immediately if the clan has room |
| Application |
A request is sent; clan staff can accept or reject it in the GUI |
| Paid |
The player pays the clan's entry fee; the fee is added to the clan treasury |
Clan creation costs 5,000 by default. A new clan's paid-entry fee starts at 1,000 by default. Both values can be changed in config.yml.
Names may contain Minecraft color codes such as &a. The default visible name length is 2–6 letters or digits; formatting codes do not count as visible characters.
After joining a clan
The same /clan command opens a clan dashboard instead of the starting menu. From there, members can access:
- Clan name, current level, points and points needed for the next level.
- Treasury balance and its current capacity.
- Member list and personal statistics.
- Shared clan storage.
- Allies, enemies and other clan relations.
- Clan home.
- Clan buyer and global buyer.
- Resource donations and clan leaderboard.
- Management settings when their clan role allows it.
When a menu needs a name or number, it asks the player to enter the value in chat. Enter cancel to abandon that prompt.
? Clan levels, points and storage
CrownClans has 9 clan levels. The server owner can edit the total point requirement for every level. Higher levels increase the treasury capacity and open more shared storage.
| Level |
Default treasury capacity |
Shared storage slots |
| 1 |
100,000 |
9 |
| 2 |
250,000 |
18 |
| 3 |
500,000 |
27 |
| 4 |
1,000,000 |
36 |
| 5 |
2,000,000 |
45 |
| 6 |
3,500,000 |
54 |
| 7 |
5,000,000 |
63 |
| 8 |
7,500,000 |
72 |
| 9 |
10,000,000 |
81 |
The storage has up to two pages. One clan member may edit it at a time; other members can still open a read-only view. This helps prevent two players from changing the same stored items simultaneously.
Default combat points
| Action |
Points |
| Kill a player from an enemy clan |
+150 |
| Kill a neutral player |
+35 |
| Kill an ally |
−100 |
| Kill a clanmate |
−150 |
All of these values are configurable. A 30-minute repeat-victim cooldown applies by default so the same opponent cannot be farmed for points continuously.
Members can also donate ordinary resources through the GUI:
| Donated resource |
Default points per item |
| Diamond |
3 |
| Ancient Debris |
15 |
| Netherite Ingot |
30 |
The clan buyer can additionally award points when valuable resources are sold to it. Players can see their own kills, deaths, K/D ratio, time in the clan and online time in the dashboard.
? Diplomacy and PvP
Alliances require agreement. One clan sends a proposal, and the other clan accepts it. A clan can also end an existing alliance.
Wars begin immediately when an authorized clan member declares one. The server announces the declaration in chat. Ending a war is different: both clans must confirm peace before the war ends.
Clan staff can configure:
- PvP between members of the same clan.
- PvP between allied clans.
- Whether clanmates and allies receive colored name highlighting.
- Whether nearby enemies receive colored name highlighting.
Enemy highlighting only applies within a configurable radius of 7 blocks by default and requires line of sight. It changes name colors through scoreboard teams; it is not a glowing outline around player models.
? Clan home and banner
Each clan can have one clan home. A Deputy or Owner can set or delete it. All clan members can use /clanhome once a home exists.
Teleportation uses a boss bar with a 5-second countdown by default. Its color changes as the teleport approaches. Server owners may configure movement and damage to cancel the teleport.
The Owner can customize the clan banner in a GUI:
- Base color.
- Border color.
- Accent color.
- Banner pattern.
Other players can see a temporary banner above the leader without permanently replacing the leader's armor. An animated version of the clan banner appears at the clan home.
? Economy and rotating buyers
CrownClans can use either its built-in economy or an economy connected through Vault.
- With a registered Vault economy provider, clan payments use that provider.
- Without one, CrownClans uses its internal balances.
- The default starting internal balance is 10,000 per new player.
- Vault by itself does not provide an economy; another plugin must register the actual balance provider.
Global buyer
The global buyer displays up to 18 offers by default. A player sells a listed resource, and the payment goes directly to that player. Each offer has its own remaining stock.
Clan buyer
Every clan receives its own selection of up to 15 offers. The items and prices may differ from those offered to other clans. Payment from these sales goes into the clan treasury, subject to its capacity.
The clan buyer also has a sales multiplier. It begins at x1, reaches x1.5 after 1,000 items sold with the default settings, and eventually reaches x10 after 350,000 items sold. Multiplier steps can be edited in the configuration.
Both buyers rotate their offers every 5 hours by default. Prices are randomized within configured limits, and each offer has a finite stock. Valuable materials can be configured with smaller stock ranges than common materials.
Normal clicks sell up to 64 matching items. Shift-clicking attempts to sell more, limited by the player's inventory, the offer's stock and, for clan sales, available treasury space. Custom items with item metadata are excluded from buyer sales.
? Roles and management rights
Clan roles determine who can manage the clan. They are separate from Bukkit permissions.
| Role |
What the player can do |
| Member |
View the dashboard and members, use unlocked storage and clan home, deposit money, donate resources and use buyers |
| Officer |
Member actions plus invitations, application review, kicking lower-ranked members and selected clan highlighting settings |
| Deputy |
Officer actions plus diplomacy, entry mode and fee changes, friendly-fire settings, and setting or deleting the clan home |
| Owner |
Full management: withdraw treasury money, rename the clan, assign roles, transfer leadership, edit the banner and disband the clan |
An Officer cannot kick another Officer, Deputy or Owner. Only the Owner can assign roles or transfer ownership.
The treasury is designed for group contributions: all members can deposit, while only the Owner can withdraw. Other clans can see a public clan profile, but the management interface is restricted to authorized members.
? Platforms and versions
| Platform |
Current verification |
| Paper 1.21.11 |
Tested in-game on Java 21 |
| Folia 26.2 |
Plugin startup checked on Java 25; multiplayer gameplay testing is pending |
| Paper 26.3 build 41 alpha |
Plugin startup checked on Java 25; full gameplay testing is pending |
| Spigot / Bukkit / Purpur |
Built against Spigot API 1.21.11; separate live tests are pending |
| BungeeCord |
Command bridge is included; a live proxy test is pending |
The JAR targets Java 21. The Java version used to start your server must also meet the requirements of that particular Minecraft server build.
BungeeCord setup
Install the same CrownClans JAR on both the proxy and the game server. The proxy bridge forwards /clan, /c and /clanhome to the connected game server.
Clan state is held on the game server. This beta does not synchronize live clan data between multiple independent game servers, even if those servers point to the same SQL database.
? Optional integrations
| Plugin |
Required? |
Purpose |
| Vault |
No |
Connects clan payments to an external economy |
| Vault-compatible economy provider |
Only if you want Vault economy |
Supplies the player's actual balance |
| PlaceholderAPI |
No |
Enables CrownClans values in compatible scoreboards, TAB displays and other plugins |
CrownClans works without these integrations by using its built-in economy and its own GUI. With PlaceholderAPI installed, the crownclans expansion registers automatically; there is no separate eCloud expansion to download.
? Commands
Most player actions also have GUI buttons.
| Command |
Function |
/clan, /c |
Open the starting menu or clan dashboard |
/clan create <name> |
Create a clan |
/clan join <clan> |
Join or apply, depending on the clan's entry mode |
/clan apply <clan> |
Alternative to the join action |
/clan invite <player> |
Invite a player |
/clan kick <player> |
Remove a lower-ranked member |
/clan leave |
Leave a clan |
/clan disband |
Disband a clan as its Owner |
/clan deposit <amount> |
Put money into the treasury |
/clan withdraw <amount> |
Withdraw money as the Owner |
/clan ally <clan> |
Propose or accept an alliance |
/clan break <clan> |
End an alliance |
/clan war <clan> |
Declare war |
/clan peace <clan> |
Propose or confirm peace |
/clan rename <name> |
Rename a clan as its Owner |
/clan fee <amount> |
Change the paid-entry fee |
/clanhome |
Teleport to the clan home |
/clanhome set <name> |
Set and name the clan home |
/clanhome delete |
Delete the clan home |
/clan storage status |
Show the active storage type |
/clan storage migrate <TYPE> |
Copy clan data to another storage type |
? Bukkit permissions
CrownClans currently has two permission nodes:
| Permission |
Default |
Effect |
crownclans.use |
Everyone |
Allows /clan, /c, their subcommands and proxy command forwarding |
crownclans.admin |
Operators |
Allows storage status and storage migration commands |
LuckPerms example:
/lp group default permission set crownclans.use true
/lp group admin permission set crownclans.admin true
The admin permission controls storage administration; it does not replace in-clan roles. /clanhome has no separate Bukkit permission node: teleporting requires membership and an existing home, while setting or deleting it requires Deputy or Owner.
? PlaceholderAPI and scoreboard
CrownClans placeholders can be used by a scoreboard plugin if that plugin processes PlaceholderAPI placeholders.
For example, inside an appropriate scoreboard lines: section:
lines:
- "&fClan: &e%crownclans_name%"
- "&fLevel: &a%crownclans_level%"
- "&fPoints: &6%crownclans_points%"
- "&6#1 &f%crownclans_top_1_name% &7- &e%crownclans_top_1_points%"
- "&6#16 &f%crownclans_top_16_name% &7- &e%crownclans_top_16_points%"
The surrounding scoreboard syntax depends on the scoreboard plugin you use.
| Placeholder |
Output |
%crownclans_name% |
Clan name without colors; нет if the player has no clan |
%crownclans_name_colored% |
Clan name with color codes |
%crownclans_has_clan% |
true or false |
%crownclans_level% |
Player's clan level, or 0 without a clan |
%crownclans_points% |
Player's clan points |
%crownclans_rank% |
Player's clan leaderboard position |
%crownclans_members% |
Number of clan members |
%crownclans_treasury% |
Treasury balance |
%crownclans_kills%, %crownclans_deaths%, %crownclans_kd% |
Player statistics |
%crownclans_top_count% |
Number of existing clans |
%crownclans_top_16% |
Formatted line for the clan in position 16 |
%crownclans_top_16_name% |
Name of the clan in position 16 |
%crownclans_top_16_points% |
Points of the clan in position 16 |
Replace 16 with another positive position, such as 1, 10 or 25. Top entries also support _level, _members, _leader and _treasury. If a requested position does not exist, the default output is —.
The missing-clan text, missing-top text and complete top-line format can all be changed in config.yml.
⚙️ Configuration examples
Edit the named entries in the generated files. These examples are excerpts, not replacements for the entire configuration. Restart the server after editing.
Example 1 — faster progression for a smaller server
Edit plugins/CrownClans/config.yml:
clan:
creation-cost: 2500
rename-cost: 750
max-name-length: 6
level-total-xp: [0, 500, 1800, 4000, 8000, 15000, 25000, 40000, 60000]
capacities: [100000, 250000, 500000, 1000000, 2000000, 3500000, 5000000, 7500000, 10000000]
combat:
enemy-kill-xp: 150
neutral-kill-xp: 35
ally-kill-xp: -100
same-clan-kill-xp: -150
repeat-victim-cooldown-seconds: 1800
This makes clan creation and leveling more accessible while retaining the original treasury progression. The level list contains nine total point thresholds, starting with 0 for level 1.
Example 2 — buyer stock and prices
Edit specific entries in the existing buyer.goods list:
buyer:
rotate-hours: 5
global-offers: 18
clan-offers: 15
price-random-factor-min: 0.80
price-random-factor-max: 1.20
goods:
STONE: '5:5000:9000'
DIAMOND: '250:200:500'
NETHERITE_INGOT: '1800:20:65'
Each item uses base price:minimum stock:maximum stock. For example, a diamond has a base price of 250 and a randomly generated stock between 200 and 500. The random price factors can then move its actual price below or above the base.
Edit the listed entries inside your existing file if you want to retain its other materials.
Example 3 — buyer multiplier
The multiplier-steps list in config.yml uses total items sold:multiplier:
buyer:
multiplier-steps:
- '0:1.0'
- '1000:1.5'
- '5000:2.0'
- '15000:3.0'
- '40000:4.0'
- '80000:5.0'
- '140000:6.0'
- '220000:7.5'
- '300000:9.0'
- '350000:10.0'
A clan starts at x1. With these settings, selling a total of 1,000 items unlocks x1.5, and 350,000 items unlocks x10. The plugin caps the resulting multiplier at x10.
Example 4 — customize text and teleportation
Edit plugins/CrownClans/config.yml:
placeholders:
no-clan: 'нет'
no-top: '—'
top-format: '{rank}. {clan} | {points} points'
home:
delay-seconds: 5
cancel-on-move: true
cancel-on-damage: true
top-format accepts {rank}, {clan}, {points}, {level} and {members}. For example, changing no-clan to 'No Clan' changes what %crownclans_name% displays for a clanless player.
? Languages
English and Russian are included. Select one in plugins/CrownClans/config.yml:
language: en
To create another translation:
- Copy
plugins/CrownClans/lang/en.yml to a new file such as lang/de.yml.
- Translate the displayed values.
- Preserve the original keys and variables such as
{0} and {1}.
- Set
language: de in config.yml and restart the server.
Missing translation keys fall back to English.
?️ Data storage
CrownClans provides 11 storage types:
| Local storage |
Server or custom storage |
FLATFILE, SQLITE, H2, HSQLDB |
MYSQL, MARIADB, POSTGRESQL, SUPABASE, SQLSERVER, ORACLE, CUSTOM_JDBC |
The default is FLATFILE. To use SQLite, edit plugins/CrownClans/storage.yml:
type: SQLITE
A MySQL setup uses the connection settings in the same file:
type: MYSQL
host: localhost
port: 3306
database: crownclans
username: crownclans
password: 'replace-with-your-password'
SUPABASE uses PostgreSQL with SSL. CUSTOM_JDBC requires a compatible JDBC URL and, if needed, a driver JAR placed in the plugin folder.
Moving existing data
- Back up the current clan data.
- Configure the target database connection.
- Run
/clan storage migrate <TYPE> while players are not changing clan data.
- Confirm that the copy succeeded.
- Change
type in storage.yml and restart the server.
The migration command does not overwrite a non-empty destination and does not automatically switch the active storage type. Local FLATFILE, SQLITE, H2 and HSQLDB storage have been covered by save-and-reopen tests; remote databases still need testing in individual server environments.
? Installation
- Place the CrownClans JAR in your game server's
plugins/ directory.
- Start the server once to generate
config.yml, storage.yml and language files.
- Adjust prices, progression, storage and language for your server.
- Restart the server.
- Optionally install Vault with an economy provider and PlaceholderAPI.
- If using BungeeCord command forwarding, place the same JAR on the proxy too.
Beta status: Paper 1.21.11 gameplay and PlaceholderAPI integration were tested. Folia 26.2 and Paper 26.3 alpha passed startup checks. Gameplay testing on Spigot, Bukkit, Purpur and BungeeCord is still pending. Name highlighting uses scoreboard teams, so a separate scoreboard plugin's existing name-tag teams may take priority.
评论 0
登录后参与评分
还没有评论,来抢沙发吧