皮甲命令

皮甲命令

一个Hytale插件,允许玩家切换其护甲部件的可见性,同时保持完整的防护效果。

实用

HideArmor - 高级盔甲可见性控制

一款 Hytale 插件,允许玩家在保持完整防护效果的同时切换各自盔甲部件的可见性。现在新增了以隐私为核心的多人互动双向选择系统、LuckPerms 集成以及全面的管理员控制功能。

也请看看我的其他模组:

⚠️ 重要提示:0.7.2 版本权限系统变更

所有命令现在都需要正确的权限! 默认情况下,权限节点可能处于“允许”状态,除非被明确拒绝。出于安全考虑,我们建议使用 LuckPerms 并为普通玩家明确拒绝管理员命令。请参阅下方的权限设置。

更新日志

v0.8.0-alpha - 国际化与界面改进

  • 新增多语言支持(英语、西班牙语、葡萄牙语、法语、德语、俄语)
  • 用户和管理员界面均采用新的三列布局
  • /hidearmor/hidearmoradmin 的图形界面中添加了语言选择器
  • 服务器范围的默认语言设置,并可持久化保存

0.7.2-alpha - LuckPerms 集成与权限强制执行

  • LuckPerms 自动检测 - 安装后,权限通过 /lp 命令管理
  • 对所有命令强制执行权限检查
  • 更好的 Modlist 图标支持
  • 更新了文档

0.7.1-alpha - 稳定性修复

  • 修复了在 Ancient Gateways 世界中切换时出现的卡顿峰值问题
  • 修复了权限按钮 ID 不匹配的问题

0.7.0-alpha - 管理员功能

  • 管理员配置菜单 (/hidearmoradmin)
  • 默认及强制覆盖设置

特性

隐藏单个盔甲部件 - 独立切换头盔、胸甲、护手和护腿的可见性 多人游戏支持 - 使用 双向选择 系统隐藏其他玩家的盔甲(需要双方同意) 隐私控制 - 精细的“允许他人”权限,确保你对自己外观的控制权 状态持久化 - 所有偏好设置自动保存和恢复 原生图形界面 - 现代、交互式的 Hytale 界面,包含三个不同的配置区域 LuckPerms 集成 - 安装 LuckPerms 后可实现无缝的权限管理 更好的 Modlist 支持 - 安装 Better Modlist 后将显示模组图标

多语言支持

内置英语、西班牙语、葡萄牙语、法语、德语和俄语翻译。可直接从界面或通过 /hidearmor language <code> 命令更改语言。


⚡ 已知行为:盔甲闪烁

当在物品栏操作(装备/卸下装备)期间更新盔甲可见性时,可能会出现短暂的闪烁。这是由于 Hytale 的数据包系统在我们应用过滤规则之前处理了原始物品。

缓解选项:

  • 调整 players.json 文件中的 refreshDelayMs 值(默认:50ms,范围:10-1000ms)
  • 较高的值会减少闪烁频率,但会引入轻微延迟
  • 这仅是视觉效果,不影响游戏性

命令

玩家命令

命令 权限 描述
/hidearmor dev.nxtime.hidearmor.command.hidearmor 打开盔甲可见性菜单
/hidearmor {piece} dev.nxtime.hidearmor.command.hidearmor 切换特定盔甲部件
/hidehelmet dev.nxtime.hidearmor.command.hidehelmet 快速切换头盔

管理员命令

命令 权限 描述
/hidearmoradmin dev.nxtime.hidearmor.command.hidearmoradmin 管理员配置菜单
/hidearmoradmin reload dev.nxtime.hidearmor.command.hidearmoradmin 从磁盘重新加载配置

权限设置

⚠️ 安全警告

默认情况下,如果权限未明确设置,Hytale 可能会允许执行命令(包括管理员命令)!请务必正确配置权限。


选项 1:LuckPerms(推荐)✅

安装 LuckPerms 以进行高级权限管理。HideArmor 会自动检测 LuckPerms,并使用它来检查所有权限。

默认拒绝管理员访问:

/lp group default permission set dev.nxtime.hidearmor.command.hidearmoradmin false

为某个组授予玩家命令权限:

/lp group member permission set dev.nxtime.hidearmor.command.hidearmor true
/lp group member permission set dev.nxtime.hidearmor.command.hidehelmet true

仅为管理员授予管理员命令权限:

/lp group admin permission set dev.nxtime.hidearmor.command.hidearmoradmin true

选项 2:原生权限 (permissions.json)

快速设置

使用 /hidearmoradmin 中的 “设置权限 (Setup Permissions)” 按钮,可自动配置玩家权限!

手动设置

修改你的 permissions.json 文件:

{
  "users": { ... },
  "groups": {
    "Default": [],
    "OP": ["*"],
    "Adventure": [
      "dev.nxtime.hidearmor.command.hidearmor",
      "dev.nxtime.hidearmor.command.hidehelmet"
    ]
  }
}

注意: 请勿将 dev.nxtime.hidearmor.command.hidearmoradmin 加入玩家组——此权限仅供管理员使用!


配置

设置存储在 plugins/HideArmor/players.json 文件中:

设置项 默认值 描述
defaultMask 0 新玩家的默认可见性设置
forcedMask 0 强制隐藏(覆盖玩家偏好)
refreshDelayMs 50 盔甲刷新前的延迟(10-1000ms)

兼容性

  • Hytale 版本: 抢先体验 SDK
  • LuckPerms: 自动检测,可选但推荐安装
  • Better Modlist: 包含图标支持