KuhArmorTrimGUI

插件

· 作者 einekuh_machtmuh

KuhArmorTrimGUI 是一款 Minecraft 插件,允许玩家通过直观的内置图形用户界面(GUI)自定义盔甲纹饰,并可选集成 Vault 经济系统与 LuckPerms 权限支持。

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

最新 1.0.0 · 1.21.11 · Folia / Paper

一键开服(送7天)

KuhArmorTrimGUI

适用于 Minecraft 服务器的基于 GUI 的盔甲纹饰解锁、购买与进度系统。

通过直观的内置 GUI,让玩家完全掌控其盔甲的外观。玩家可以浏览盔甲类型、解锁纹饰图案和材质、使用游戏内货币购买外观装饰,并自动应用所选的纹饰。

服务器管理员可通过配置文件和命令,对定价、解锁要求、赛季通行证、保护规则和自定义选项拥有完全控制权。

  • 兼容性: Paper 1.21.9+ 和 Folia
  • 经济系统: 可选 Vault 集成
  • 权限系统: 可选 LuckPerms 集成
  • 存储方式: 本地 YAML 文件 —— 无需数据库

工作原理

  1. 打开 GUI — 玩家使用 /armortrims 或 /armtrm 访问菜单。
  2. 选择风格 — 浏览盔甲部件、纹饰图案和纹饰材质。
  3. 解锁或购买 — 通过进度解锁、管理员授予、权限或游戏内货币获取内容。
  4. 确认选择 — 确认屏幕显示所选物品、解锁状态和价格。
  5. 应用纹饰 — 当满足所需条件时,插件将应用所选外观。
  6. 保留进度 — 重连和服务器重启后,解锁记录和选择均会保留。
  7. 管理赛季 — 服务器管理员可配置季节性内容、独家解锁和限时赛季通行证。

功能特性

GUI 与自定义

  • 清晰的多页 GUI,用于浏览盔甲部件、纹饰图案和纹饰材质。
  • 带有物品预览、解锁状态和价格的购买确认屏幕。
  • 进度屏幕显示已解锁和总数、当前赛季及通行证状态。
  • 可直接通过 GUI 清除纹饰。
  • 可配置的 GUI 布局、物品顺序、页面大小、音效和消息。

解锁与进度

  • 解锁单个盔甲部件、纹饰图案和纹饰材质。
  • 为盔甲类型、盔甲部件、纹饰图案、纹饰材质和赛季通行证分别设置价格。
  • 通过管理员命令一次性授予所有解锁或单独解锁。
  • 支持基于权限的解锁。
  • 在玩家加入和背包变化时自动应用所选纹饰。
  • 重连和服务器重启后,解锁记录和选择均会持久保存。

赛季通行证

  • 创建无限数量的自定义赛季,每个赛季拥有独立设置。
  • 配置价格、持续时间和开始延迟。
  • 通过特定于赛季的解锁提供独家内容。
  • 在配置的持续时间结束后自动使通行证过期。
  • 按类别配置解锁,包括通配符支持。

纹饰保护

  • 阻止在锻造台手动更改盔甲纹饰。
  • 在拾取、掉落、死亡和支持的容器交互时清理盔甲纹饰。
  • 单独配置保护规则。
  • 强制执行解锁要求,并通过自动应用恢复所选外观。

经济与权限

  • Vault 经济(可选): 使用服务器的经济系统向玩家收费。
  • LuckPerms(可选): 将解锁数据镜像到权限节点中,便于管理。
  • 独立模式: 插件无需任何依赖即可运行。

完全可配置

  • 通过 messages.yml 自定义每条消息和 GUI 文本。
  • 通过 prices.yml 调整价格。
  • 在 seasons.yml 中配置赛季。
  • 控制解锁要求、保护规则、音效和显示顺序。
  • 支持在 Folia 上运行,采用区域安全的调度机制。

依赖项

插件 用途 必需
Vault 经济系统集成 否
LuckPerms 权限同步 否

这两个依赖项都不是必需的。如果没有 Vault,经济功能将被禁用。如果没有 LuckPerms,解锁数据将由 KuhArmorTrimGUI 本身管理。


命令

命令 描述
/armortrims 打开盔甲纹饰 GUI
/armortrims reload 重新加载配置
/armortrims info <player> 查看玩家的解锁和选择情况
/armortrims unlock <player> piece <armor> <piece> 解锁一个盔甲部件
/armortrims unlock <player> trim <id> 解锁一个纹饰图案
/armortrims unlock <player> material <id> 解锁一个纹饰材质
/armortrims unlock <player> all 解锁所有内容
/armortrims lock <player> <type> <id> 移除特定解锁
/armortrims lock <player> all 移除所有解锁
/armortrims givepass <player> <season> 给予一个赛季通行证
/armortrims removepass <player> <season> 移除一个赛季通行证

命令别名: /armtrm


权限

权限 默认值 描述
kuharmortrgui.use true 打开 GUI
kuharmortrgui.admin op 访问管理员命令
kuharmortrgui.reload op 重新加载配置
kuharmortrgui.admin.unlock op 管理解锁
kuharmortrgui.admin.lock op 移除解锁
kuharmortrgui.admin.givepass op 授予赛季通行证
kuharmortrgui.admin.removepass op 移除赛季通行证
kuharmortrgui.admin.info op 查看玩家信息
kuharmortrgui.unlock.trim.<id> false 基于权限的纹饰解锁
kuharmortrgui.unlock.trim-material.<id> false 基于权限的纹饰材质解锁
kuharmortrgui.unlock.piece.<armor>.<piece> false 基于权限的盔甲部件解锁
kuharmortrgui.season.<season> false 特定于赛季的访问权限

默认定价

所有价格均可在 prices.yml 中进行自定义。

类别 默认价格范围
盔甲材质 0–25,000 金币
盔甲部件 0–5,000 金币
纹饰图案 1,000–1,750 金币
纹饰材质 500–3,000 金币
赛季通行证 45,000 金币

货币名称和具体价格均可配置。


支持的内容

盔甲类型

7 种盔甲类型:

  • 皮革
  • 链甲
  • 铜
  • 铁
  • 金
  • 钻石
  • 下界合金

装饰图案

支持 18 种图案:

Sentry · Dune · Coast · Wild · Ward · Eye · Vex · Tide · Snout · Rib · Wayfinder · Shaper · Host · Raiser · Flow · Bolt · Silence · Spire

装饰材质

支持 11 种材质:

Iron · Gold · Diamond · Lapis · Emerald · Netherite · Redstone · Amethyst · Quartz · Copper · Resin


配置

所有设置均可自定义,无需修改源代码。

config.yml

  • 启用或禁用经济集成,并设置货币名称。
  • 选择需要解锁的分类。
  • 自定义护甲和装饰材质的显示顺序。
  • 配置赛季通行证的价格和持续时间。
  • 启用或禁用保护规则。
  • 配置自动应用行为。
  • 自定义 GUI 页面大小、确认界面以及保存行为。

seasons.yml

  • 创建无限数量的赛季,并可自定义显示名称。
  • 设置赛季持续时间和开始延迟。
  • 按分类定义赛季特定的解锁内容。
  • 使用通配符批量设置解锁规则。
  • 启用或禁用单个通行证,并设置其价格。

prices.yml

  • 配置护甲类型和部件的价格。
  • 设置单个装饰图案和装饰材质的价格。
  • 设置赛季通行证价格。

messages.yml

  • 自定义所有聊天消息和 GUI 文本。
  • 配置购买、解锁、选择和错误提示消息。
  • 使用带 & 前缀的颜色代码。
  • 自定义购买、解锁、错误、GUI 交互、重置以及赛季事件的音效。

存储

玩家数据以 YAML 文件形式本地存储在以下路径:

plugins/KuhArmorTrimGUI/data/

无需外部数据库。

数据在以下情况保存:

  • 玩家退出游戏时。
  • 插件重新加载时。
  • 发生解锁、锁定或购买操作时。

支持与反馈

发现 Bug 或有建议?

加入 Discord 并提交工单 <3。

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源