MaskUI

插件

· 作者 SkulZOnTheYT

MaskUI 是一个 Paper 插件,允许玩家通过库存图形界面购买可穿戴的生物头部面具。每个面具在佩戴时都会提供不同的药水效果组合。

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

需要前置:EssentialsX

最新 1.0.0 · 26.3 · Bukkit / Paper

一键开服(送7天)

MaskUI 是一款面向 Paper 服务器的生存面具插件。玩家可以购买并装备各种面具,这些面具体现了探索、挖矿、战斗、下界旅行以及一般生存等不同方面的效果。

该插件包含七种面具等级、基于库存的商店、Vault 经济支持、面具出售功能以及购买追踪机制。

特性

  • 七种具有不同效果和生存用途的面具
  • 基于库存的面具商店
  • 在主手或副手中右键点击即可装备面具
  • 装备面具后自动生效
  • Vault 经济支持
  • 可自定义价格和消息
  • 支持面具出售及可配置的退款金额
  • 购买追踪以防止重复退款
  • 使用持久化的物品标签来识别真实的 MaskUI 面具
  • 支持 Minecraft 1.16.x–1.21.x

面具

每种面具均提供生命视觉 I 效果,并根据其设计用途附加其他效果。

等级 面具 默认价格 用途
1 Skeleton 5,000 探索
2 Zombie 10,000 耐久与恢复
3 Creeper 15,000 机动性与防御
4 Piglin 20,000 下界探索
5 Steve 25,000 挖矿与建造
6 Wither Skeleton 30,000 战斗
7 Dragon 35,000 全面生存

较高等级提供更强的整体能力和实用性,但每种面具都是围绕特定用途设计的,而非简单地继承前一个等级的所有效果。

在游戏中使用 /mask wiki 查看完整的效果列表。

依赖

  • Paper 或 Spigot 1.16.x–1.21.x
  • Vault
  • 一个兼容 Vault 的经济插件,例如 EssentialsX Economy

如果 Vault 无法找到经济提供商,则禁用面具购买功能。其他可用的命令和菜单仍可正常使用。

安装

  1. 下载最新的 MaskUI JAR 文件。
  2. 安装 Vault 和一个兼容 Vault 的经济插件。
  3. 将插件 JAR 文件放入服务器的 plugins 目录中。
  4. 启动或重启服务器。
  5. 编辑 plugins/MaskUI/config.yml 以自定义插件配置。
  6. 修改配置后使用 /mask reload 重载。

命令

命令 描述 权限
/mask 打开面具商店 maskui.command
/mask open 打开面具商店 maskui.command
/mask shop 打开面具商店 maskui.command
/mask wiki 查看面具效果 maskui.command
/mask status 显示已装备的面具及其效果 maskui.command
/mask buy <mask> 打开购买确认界面 maskui.command
/mask sell [mask] 打开出售菜单或预览符合条件的面具 maskui.command
/mask help 显示可用命令 maskui.command
/mask github 显示源代码仓库 maskui.command
/mask give <player> <mask> 向在线玩家发放面具 maskui.admin
/mask reload 重载价格和消息 maskui.admin

maskui.command 默认对所有玩家开放。maskui.admin 默认为服务器管理员(OP)保留。

可用的面具 ID:

skeleton
zombie
creeper
piglin
steve
wither
dragon

佩戴面具

在主手或副手持有一个 MaskUI 面具时,右键点击即可装备。头盔槽位必须为空。

佩戴面具会将其中一个面具移入头盔槽位,而不会复制物品(包括在创造模式下)。可以通过正常的盔甲栏移除面具。

带有标签的 MaskUI 面具在右键点击时不会作为方块放置。普通的生物头颅保持原版正常行为。

佩戴面具期间会自动应用面具效果。效果会在过期前刷新以防止生命视觉闪烁,并在面具被卸下或替换后不久移除。

MaskUI 不会移除已有的外部药水效果。

出售面具

通过 MaskUI 商店购买的面具可以使用以下命令出售:

/mask sell
/mask sell <mask>

默认情况下,符合条件的面具将获得原价 50% 的退款。

例如,花费 5,000 购买的 Skeleton 面具即使之后商店价格发生变化,仍会退还 2,500。

出售功能可在 config.yml 中进行配置:

selling:
  enabled: true
  refund-percent: 50

退款百分比必须大于 0 且不超过 100。无效值将禁用退款功能。

只有拥有有效购买记录的面具才符合退款条件。免费获取的面具、通过 /mask give 获得的面具、普通生物头颅以及早期未追踪的面具均无法出售。

任何持有已购买面具的玩家都可以将其出售。卖家无需是原始买家。

每次购买都会生成唯一的收据,因此即使存在相同购买 ID 的复制品,也不会产生额外的退款。

交易安全

MaskUI 追踪购买和销售记录,以降低物品复制或重复退款的风险。

在购买资格、余额、库存空间、价格、物品收据和退款金额等方面,会在确认阶段再次进行检查。

如果经济提供商通常拒绝退款,则面具及其出售权将被恢复。

结果不确定的交易(例如在经济操作过程中中断)不会自动重试。这防止了同一张收据被兑换两次。

项目文档中提供了针对服务器管理员的详细恢复程序。

配置

可以单独配置面具价格:

masks:
  skeleton:
    price: 5000
  dragon:
    price: 35000

消息和其他插件行为也可以通过 config.yml 进行自定义。

消息支持传统的 & 颜色代码。购买消息支持 {mask} 和 {price} 占位符。

Minecraft 兼容性

MaskUI 旨在通过单个 JAR 文件支持 Minecraft 1.16.x–1.21.x。

插件使用了以下技术:

  • api-version: 1.16
  • 以 Spigot 1.16.1 作为基准编译 API
  • Java 8 兼容的插件字节码
  • 跨版本药水效果名称的兼容性处理
  • 在没有原生 Piglin Head 的版本上为 Piglin 面具提供 Player Head 回退方案

请运行你的 Minecraft 服务器所需的 Java 版本。

尚未在支持的范围内完成对每个 Paper 和 Spigot 版本的完整运行时测试矩阵。针对基线 API 进行编译并不能保证与每一个服务器构建版本兼容。

致谢

MaskUI 由 SkulZOnTheYT 开发,并在 LEAP 下维护。

基于 misael38 的原始 MaskShop 概念。

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源