Skip to content

自定义 HUD

当前,Oraxen 支持添加一个自定义 HUD 元素。这通过 ActionBar 实现,意味着其他使用 ActionBar 的插件可能产生冲突。在未来更新中可能会考虑添加更多插入...[1]

配置

下文为在 hud.yml 中设置的“平衡”HUD 示例。

请记住,这里的 shift 实现与原本 Oraxen 提供的有一些差别。

<shift:-10> 会将 HUD 元素向左移动 10 像素,而 <shift:10> 则会将之向右移 10 像素。

font 在修改文本元素的高度时很有用。

基本上这与字符替换相同,但会允许你使用正常的文本与变量。

下文的示例中,我们将字体的抬升高度设置为了 -12。

下文为字体文件的大致配置内容。

JSON
{
  "providers": [
    {
      "type": "bitmap",
      "file": "minecraft:required/ascii_offset.png",
      "ascent": -13,
      "height": 8,
      "chars": [
        "\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000",
        "\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000",
        "\u0020\u0021\u0022\u0023\u0024\u0025\u0026\u0027\u0028\u0029\u002a\u002b\u002c\u002d\u002e\u002f",
        "\u0030\u0031\u0032\u0033\u0034\u0035\u0036\u0037\u0038\u0039\u003a\u003b\u003c\u003d\u003e\u003f",
        "\u0040\u0041\u0042\u0043\u0044\u0045\u0046\u0047\u0048\u0049\u004a\u004b\u004c\u004d\u004e\u004f",
        "\u0050\u0051\u0052\u0053\u0054\u0055\u0056\u0057\u0058\u0059\u005a\u005b\u005c\u005d\u005e\u005f",
        "\u0060\u0061\u0062\u0063\u0064\u0065\u0066\u0067\u0068\u0069\u006a\u006b\u006c\u006d\u006e\u006f",
        "\u0070\u0071\u0072\u0073\u0074\u0075\u0076\u0077\u0078\u0079\u007a\u007b\u007c\u007d\u007e\u0000",
        "\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000",
        "\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u00a3\u0000\u0000\u0192",
        "\u0000\u0000\u0000\u0000\u0000\u0000\u00aa\u00ba\u0000\u0000\u00ac\u0000\u0000\u0000\u00ab\u00bb",
        "\u2591\u2592\u2593\u2502\u2524\u2561\u2562\u2556\u2555\u2563\u2551\u2557\u255d\u255c\u255b\u2510",
        "\u2514\u2534\u252c\u251c\u2500\u253c\u255e\u255f\u255a\u2554\u2569\u2566\u2560\u2550\u256c\u2567",
        "\u2568\u2564\u2565\u2559\u2558\u2552\u2553\u256b\u256a\u2518\u250c\u2588\u2584\u258c\u2590\u2580",
        "\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u2205\u2208\u0000",
        "\u2261\u00b1\u2265\u2264\u2320\u2321\u00f7\u2248\u00b0\u2219\u0000\u221a\u207f\u00b2\u25a0\u0000"
      ]
    }
  ]
}

与字符替换相同,编辑抬升高度会改变文本的 Y 轴高度。

这会将下文中示例贴图的文本大致偏移。

若要添加字符替换,你可以通过 %oraxen_glyphid%<glyph:glyphid> 使用普通字符。

若你不想使用自定义 HUD,你可以将 update_time_in_ticks 设置为 0 来将其禁用。

如果你的 HUD 在正确配置的情况下不能显示,试着用这个命令切换:

/oraxen hub toggle,后接你的 HUD 名称(如 /oraxen hud toggle balance

示例 hud.yml

YAML
update_time_in_ticks: 40
huds:
  balance:
    permission: "oraxen.hud.balance"
    display_text: "<shift:100><font:balance_hud>%vault_eco_balance%<font:default><glyph:coin>"
    disabled_whilst_in_water: true # 如果是在饥饿条上显示,该设置可隐藏氧气条。
    enabled_by_default: true
    enable_for_spectator_mode: true # 默认情况下,此为 false

  1. 原文此处缺损。 ↩︎