CrownClans

插件

· 作者 Pritfort

通过图形界面管理的氏族,包含战争、联盟、共享存储、等级提升、经济系统以及 PlaceholderAPI 支持。

0 本站下载 0 关注 更新于 1 个月前

最新 0.1.0-beta · 1.21.11 · Bukkit / BungeeCord

一键开服(送7天)

? 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

要创建另一种翻译:

  1. 将 plugins/CrownClans/lang/en.yml 复制到一个新文件,例如 lang/de.yml。
  2. 翻译显示的数值。
  3. 保留原始键和变量,如 {0} 和 {1}。
  4. 在 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 放在插件文件夹中。

移动现有数据

  1. 备份当前的氏族数据。
  2. 配置目标数据库连接。
  3. 在玩家不更改氏族数据时运行 /clan storage migrate <TYPE>。
  4. 确认复制成功。
  5. 更改 storage.yml 中的 type 并重启服务器。

迁移命令 不会覆盖非空的目标位置,也 不会 自动切换活动的存储类型。本地 FLATFILE、SQLITE、H2 和 HSQLDB 存储已通过保存和重新打开测试;远程数据库仍需在各个服务器环境中进行测试。


? 安装

  1. 将 CrownClans JAR 文件放入游戏服务器的 plugins/ 目录中。
  2. 启动服务器一次,以生成 config.yml、storage.yml 和语言文件。
  3. 根据你的服务器需求调整价格、进度系统、存储设置及语言选项。
  4. 重启服务器。
  5. (可选)安装 Vault 及其经济插件 以及 PlaceholderAPI。
  6. 如果使用 BungeeCord 命令转发功能,请将相同的 JAR 文件也放置在代理服务器上。

Beta 状态说明: 已测试 Paper 1.21.11 的游戏玩法及 PlaceholderAPI 集成。Folia 26.2 和 Paper 26.3 alpha 版本已通过启动检查。Spigot、Bukkit、Purpur 和 BungeeCord 上的游戏玩法测试仍在进行中。名称高亮显示依赖于记分板队伍(scoreboard teams),因此其他记分板插件已有的名称标签队伍可能会优先生效。

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源