KuhArmorTrimGUI
适用于 Minecraft 服务器的基于 GUI 的盔甲纹饰解锁、购买与进度系统。
通过直观的内置 GUI,让玩家完全掌控其盔甲的外观。玩家可以浏览盔甲类型、解锁纹饰图案和材质、使用游戏内货币购买外观装饰,并自动应用所选的纹饰。
服务器管理员可通过配置文件和命令,对定价、解锁要求、赛季通行证、保护规则和自定义选项拥有完全控制权。
- 兼容性: Paper 1.21.9+ 和 Folia
- 经济系统: 可选 Vault 集成
- 权限系统: 可选 LuckPerms 集成
- 存储方式: 本地 YAML 文件 —— 无需数据库
工作原理
- 打开 GUI — 玩家使用
/armortrims 或 /armtrm 访问菜单。
- 选择风格 — 浏览盔甲部件、纹饰图案和纹饰材质。
- 解锁或购买 — 通过进度解锁、管理员授予、权限或游戏内货币获取内容。
- 确认选择 — 确认屏幕显示所选物品、解锁状态和价格。
- 应用纹饰 — 当满足所需条件时,插件将应用所选外观。
- 保留进度 — 重连和服务器重启后,解锁记录和选择均会保留。
- 管理赛季 — 服务器管理员可配置季节性内容、独家解锁和限时赛季通行证。
功能特性
GUI 与自定义
- 清晰的多页 GUI,用于浏览盔甲部件、纹饰图案和纹饰材质。
- 带有物品预览、解锁状态和价格的购买确认屏幕。
- 进度屏幕显示已解锁和总数、当前赛季及通行证状态。
- 可直接通过 GUI 清除纹饰。
- 可配置的 GUI 布局、物品顺序、页面大小、音效和消息。
解锁与进度
- 解锁单个盔甲部件、纹饰图案和纹饰材质。
- 为盔甲类型、盔甲部件、纹饰图案、纹饰材质和赛季通行证分别设置价格。
- 通过管理员命令一次性授予所有解锁或单独解锁。
- 支持基于权限的解锁。
- 在玩家加入和背包变化时自动应用所选纹饰。
- 重连和服务器重启后,解锁记录和选择均会持久保存。
赛季通行证
- 创建无限数量的自定义赛季,每个赛季拥有独立设置。
- 配置价格、持续时间和开始延迟。
- 通过特定于赛季的解锁提供独家内容。
- 在配置的持续时间结束后自动使通行证过期。
- 按类别配置解锁,包括通配符支持。
纹饰保护
- 阻止在锻造台手动更改盔甲纹饰。
- 在拾取、掉落、死亡和支持的容器交互时清理盔甲纹饰。
- 单独配置保护规则。
- 强制执行解锁要求,并通过自动应用恢复所选外观。
经济与权限
- Vault 经济(可选): 使用服务器的经济系统向玩家收费。
- LuckPerms(可选): 将解锁数据镜像到权限节点中,便于管理。
- 独立模式: 插件无需任何依赖即可运行。
完全可配置
- 通过
messages.yml 自定义每条消息和 GUI 文本。
- 通过
prices.yml 调整价格。
- 在
seasons.yml 中配置赛季。
- 控制解锁要求、保护规则、音效和显示顺序。
- 支持在 Folia 上运行,采用区域安全的调度机制。
依赖项
这两个依赖项都不是必需的。如果没有 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。
KuhArmorTrimGUI
A GUI-based armor trim unlocking, purchasing, and progression system for Minecraft servers.
Give your players full control over their armor's appearance with an intuitive in-game GUI. Players can browse armor types, unlock trim patterns and materials, purchase cosmetics with in-game currency, and automatically apply their selected trims.
Server admins get full control over pricing, unlock requirements, season passes, protection rules, and customization — all through configuration files and commands.
- Compatibility: Paper 1.21.9+ and Folia
- Economy: Optional Vault integration
- Permissions: Optional LuckPerms integration
- Storage: Local YAML files — no database required
How It Works
- Open the GUI — Players use
/armortrims or /armtrm to access the menu.
- Choose your style — Browse armor pieces, trim patterns, and trim materials.
- Unlock or purchase — Unlock content through progression, admin grants, permissions, or in-game currency.
- Confirm your selection — A confirmation screen displays the selected items, unlock status, and price.
- Apply your trims — The plugin applies the selected appearance when the required conditions are met.
- Keep your progress — Unlocks and selections persist across relogs and server restarts.
- Manage seasons — Server admins can configure seasonal content, exclusive unlocks, and time-limited season passes.
Features
GUI & Customization
- Clean, multi-page GUI for browsing armor pieces, trim patterns, and trim materials.
- Purchase confirmation screens with item previews, unlock status, and pricing.
- Progress screen showing unlocked and total counts, active seasons, and pass status.
- Clear trims directly through the GUI.
- Configurable GUI layout, item order, page size, sounds, and messages.
Unlocks & Progression
- Unlock individual armor pieces, trim patterns, and trim materials.
- Configure separate prices for armor types, armor pieces, trim patterns, trim materials, and season passes.
- Grant individual unlocks or everything at once through admin commands.
- Support for permission-based unlocks.
- Automatically apply selected trims on player join and inventory changes.
- Persistent unlocks and selections across relogs and server restarts.
Season Passes
- Create unlimited custom seasons with individual settings.
- Configure prices, durations, and start delays.
- Offer exclusive content through season-specific unlocks.
- Automatically expire passes after their configured duration.
- Configure unlocks by category, including wildcard support.
Trim Protection
- Block manual armor trim changes at smithing tables.
- Sanitize armor on pickup, drop, death, and supported container interactions.
- Configure protection rules individually.
- Enforce unlock requirements and restore selected appearances through auto-apply.
Economy & Permissions
- Vault Economy (optional): Charge players using their server's economy.
- LuckPerms (optional): Mirror unlocks into permission nodes for easier management.
- Standalone mode: The plugin works without either dependency.
Fully Configurable
- Customize every message and GUI text through
messages.yml.
- Adjust prices through
prices.yml.
- Configure seasons in
seasons.yml.
- Control unlock requirements, protection rules, sounds, and display order.
- Run on Folia with region-safe scheduling.
Dependencies
| Plugin |
Purpose |
Required |
| Vault |
Economy integration |
No |
| LuckPerms |
Permission synchronization |
No |
Neither dependency is required. Without Vault, economy features are disabled. Without LuckPerms, unlock data is managed by KuhArmorTrimGUI itself.
Commands
| Command |
Description |
/armortrims |
Open the armor trim GUI |
/armortrims reload |
Reload the configuration |
/armortrims info <player> |
View a player's unlocks and selections |
/armortrims unlock <player> piece <armor> <piece> |
Unlock an armor piece |
/armortrims unlock <player> trim <id> |
Unlock a trim pattern |
/armortrims unlock <player> material <id> |
Unlock a trim material |
/armortrims unlock <player> all |
Unlock everything |
/armortrims lock <player> <type> <id> |
Remove a specific unlock |
/armortrims lock <player> all |
Remove all unlocks |
/armortrims givepass <player> <season> |
Give a season pass |
/armortrims removepass <player> <season> |
Remove a season pass |
Command alias: /armtrm
Permissions
| Permission |
Default |
Description |
kuharmortrgui.use |
true |
Open the GUI |
kuharmortrgui.admin |
op |
Access admin commands |
kuharmortrgui.reload |
op |
Reload the configuration |
kuharmortrgui.admin.unlock |
op |
Manage unlocks |
kuharmortrgui.admin.lock |
op |
Remove unlocks |
kuharmortrgui.admin.givepass |
op |
Grant season passes |
kuharmortrgui.admin.removepass |
op |
Remove season passes |
kuharmortrgui.admin.info |
op |
View player information |
kuharmortrgui.unlock.trim.<id> |
false |
Permission-based trim unlock |
kuharmortrgui.unlock.trim-material.<id> |
false |
Permission-based trim material unlock |
kuharmortrgui.unlock.piece.<armor>.<piece> |
false |
Permission-based armor piece unlock |
kuharmortrgui.season.<season> |
false |
Season-specific access |
Default Pricing
All prices can be customized in prices.yml.
| Category |
Default Price Range |
| Armor materials |
0–25,000 coins |
| Armor pieces |
0–5,000 coins |
| Trim patterns |
1,000–1,750 coins |
| Trim materials |
500–3,000 coins |
| Season pass |
45,000 coins |
The currency name and individual prices are configurable.
Supported Content
Armor Types
7 armor types:
- Leather
- Chainmail
- Copper
- Iron
- Gold
- Diamond
- Netherite
Trim Patterns
18 supported patterns:
Sentry · Dune · Coast · Wild · Ward · Eye · Vex · Tide · Snout · Rib · Wayfinder · Shaper · Host · Raiser · Flow · Bolt · Silence · Spire
Trim Materials
11 supported materials:
Iron · Gold · Diamond · Lapis · Emerald · Netherite · Redstone · Amethyst · Quartz · Copper · Resin
Configuration
All settings can be customized without modifying the source code.
config.yml
- Enable or disable economy integration and set the currency name.
- Choose which unlock categories are required.
- Customize armor and trim material display order.
- Configure season pass pricing and duration.
- Enable or disable protection rules.
- Configure auto-apply behavior.
- Customize GUI page size, confirmation screens, and save behavior.
seasons.yml
- Create unlimited seasons with custom display names.
- Set season durations and start delays.
- Define season-specific unlocks by category.
- Use wildcards for bulk unlock rules.
- Enable or disable individual passes and set their prices.
prices.yml
- Configure prices for armor types and pieces.
- Set individual trim pattern and trim material prices.
- Set season pass prices.
messages.yml
- Customize all chat messages and GUI text.
- Configure purchase, unlock, selection, and error messages.
- Use color codes with the
& prefix.
- Customize sounds for purchases, unlocks, errors, GUI interactions, resets, and season events.
Storage
Player data is stored locally as YAML files in:
plugins/KuhArmorTrimGUI/data/
No external database is required.
Data is saved when:
- A player quits.
- The plugin reloads.
- An unlock, lock, or purchase operation occurs.
Support & Feedback
Found a bug or have a suggestion?
Join the Discord and open a ticket <3.
评论 0
登录后参与评分
还没有评论,来抢沙发吧