武器自定义HUD

武器自定义HUD

可配置的武器输入HUD系统，适用于Hytale物品资产。

实用

WeaponCustomHUD

WeaponCustomHUD 是一款可配置的武器输入 HUD 系统，专为 Hytale 物品资源设计。

它允许资源创建者和插件开发人员构建自定义武器 HUD，而无需替换整个默认界面。每种武器都可以通过 JSON 直接定义其可见动作、图标、冷却时间、状态、缩放、放置位置和屏幕位置。

image

对资源创建者的内置支持

如果你创建武器资源或资源包，可以直接在物品 JSON 中包含一个预配置的 WeaponCustomHUD 区块。

当安装了 WeaponCustomHUD 时，该武器将自动使用配置好的 HUD。

当 未 安装 WeaponCustomHUD 时，额外的 JSON 区块会被直接忽略。它不会阻止物品加载，也不会影响其正常行为。

这使得资源创建者可以发布带有可选 WeaponCustomHUD 支持的武器，而无需将该插件作为硬性依赖项。

⚠️ Hytale UI 重要说明

不要添加标准武器类别： "Categories": ["Weapons"]

Hytale 使用此类别来显示其内置的武器能力 UI。当存在该类别时，默认的 Hytale UI 会渲染在 WeaponCustomHUD 之上。

目前没有其他方法可以禁用内置武器 UI。要在不使用重叠界面的情况下使用 WeaponCustomHUD，物品必须不包含标准 Weapons 类别。

功能特性

  • 为单个武器物品提供可配置的 HUD
  • 支持主攻击、副攻击、能力 1–3、使用和闪避栏位
  • 每项能力可设置自定义图标
  • 基于武器状态的动态图标
  • 激活与非激活栏位状态
  • 内置冷却进度显示
  • 可自定义的 HUD 缩放和屏幕位置
  • 可复用的 JSON 预设
  • 交互失败时的错误闪烁提示
  • 通过 JSON 交互进行运行时状态和冷却控制
  • 提供公共 API 以供其他插件集成

image

image

image

为资源创建者打造

大多数 HUD 行为可以直接在物品 JSON 文件中配置。

WeaponCustomHUD 还提供了以下自定义交互：

  • 设置 HUD 状态；
  • 开始和重置冷却时间；
  • 检查激活的冷却时间；
  • 显示错误反馈。

这意味着许多自定义武器界面无需编写额外的插件即可创建。

image image

插件集成

其他插件可以通过公共的 WeaponCustomHUD API 注册它们自己的动态 HUD 状态和冷却提供程序。

这可用于显示诸如以下信息：

  • 装弹中；
  • 可用弹药；
  • 瞄准或开镜；
  • 过热中；
  • 配件是否可用；
  • 自定义能力进度。

文档

完整的配置参考、JSON 示例、交互文档、预设和 API 用法：

WeaponCustomHUD 文档

基本配置

{
  "WeaponCustomHUD": {
    "Enabled": true,
    "Preset": "MyWeaponHUD",
    "Scale": 1.0,
    "Placement": "BottomRight",
    "Position": [50, 40]
  }
}

WeaponCustomHUD 被设计为一个独立的 HUD 系统，也可以与更大的武器插件和自定义资源包集成。