光之调整

光之调整

Hikari Server 的客户端实用工具模组

装备

Hikari-Tweaks

Hikari-Tweaks

License Modrinth

一款面向 Minecraft 1.17.1 - 26.2 的客户端 Fabric 实用模组,由 Hikari Server (光鯖) 开发。提供完全可自定义的计分板 HUD(需配合 HikariScoreBoard),以及一系列体验优化功能。

1.2.5 版本的变化

新增:支持 Minecraft 26.1 和 26.2。 又多了两个 jar,总共十九个。26.x 需要 Java 25,与 Minecraft 本身的要求一致;旧版本的 jar 没有变化。新增:在排名 HUD 中可以区分机器人(Scoreboard 标签页 → Display 设置):Mark bots 会在机器人名字前加一个 *(默认开启),Hide bots 会移除机器人所在的行(默认关闭)。排名编号不会填补空缺,因此与其他人屏幕上显示的保持一致。这需要 HikariScoreBoard v1.0.0 或更新版本的服务端;在旧版服务端上,所有人都会像以前一样显示为真实玩家。

功能

自定义计分板 HUD

将 HikariScoreBoard 的排名渲染为完全可自定义的 HUD。可配置位置(锚点 X/Y 0-100%)、缩放(0.5x-3.0x)、分页(每页 1-50 行),以及标题、主体、文本、分数和自己所在行的独立 ARGB 颜色。默认隐藏原版侧边栏。打开 F3 调试屏幕或用 F1 隐藏 HUD 时不会绘制。配置键 scoreboardCustomHud,默认开启:它位于 config/hikari-tweaks.json 中,配置界面里没有对应的开关。位置、缩放、每页行数和颜色在 Scoreboard 标签页中编辑。

平滑分数动画(始终开启,无设置项)

自定义 HUD 上的数字会平滑过渡到新值,而不是直接跳变。平滑完全在客户端本模组内部运行——不会因此产生任何额外的网络通信,旧的服务端平滑器已被移除——所以只有安装了 Hikari-Tweaks 的玩家才能看到分数动画。它始终开启且没有设置项。实时指数缓动(时间常数约 0.12 秒)保证在任何帧率下速度一致,帧间隔超过 0.5 秒(窗口失焦、世界加载)时会直接跳到真实值,而不是重播动画。只有绘制的数字会被缓动:排序和排名始终基于真实值,因此行在动画过程中不会交换位置,刚出现的行会立即显示真实值而不是从零开始计数。适用于排名行和服务端总计行。需要 v2 排名协议——仍在发送 v1 数据包的服务端会显示精确值且没有动画。

耐久度警告

当可损坏物品的耐久度降至 1% 或更低时,通过聊天通知和声音发出警告。会检查背包的每个槽位,而不仅仅是手中的物品。当物品处于警告状态时,每次使用它——每损失一点耐久度——都会再次警告。耐久度回升时(经验修补)保持静默。每个槽位独立追踪,因此携带两件相同的工具会为两者都发出警告(将工具移动到另一个槽位会额外产生一次警告)。声音每 tick 最多播放一次,因此一整套即将损坏的盔甲不会叠加音效。配置键 durabilityWarningEnabled(Tweaks 标签页,默认开启)。

快捷栏自动补充

当你打开一个真实的容器方块时,自动从该容器中把你清单上的物品补充到快捷栏,然后关闭界面。清单可在 Lists 标签页中配置。检测刻意采用失败关闭策略:只有当你的准星指向一个方块实体且其持有物品栏、该方块实体不是末影箱、并且界面的容器槽位数量与该物品栏大小匹配时才会触发——箱子(且只有箱子)也允许恰好是两倍大小,因此双箱子可以正常工作。因此箱子、陷阱箱、木桶、放置的潜影盒、漏斗、发射器、投掷器、熔炉和酿造台都符合条件。末影箱被明确排除。箱子矿车和漏斗矿车、运输船以及村民交易被排除,因为它们是实体而非方块实体,准星下没有方块实体。通过命令、NPC 或物品打开的插件菜单也因同样的原因被排除。通过右键点击真实容器打开的槽位数量相同的插件菜单在客户端无法区分,因此在有箱子式商店 GUI 的服务器上请保持清单精简。配置键 autoRestockHotbar(Tweaks 标签页,默认关闭)。

不死图腾自动补充

当不死图腾被使用后,从你的背包中再补充一个到触发它的同一只手上。不会在正常的快捷栏槽位切换时触发。配置键 totemRestock(Tweaks 标签页,默认关闭)。

主手自动补充

Tweakeroo 风格的手部补充:当快捷栏上清单中的物品降至 5 个或更少时,自动从背包其余部分拉取替代品。只监视快捷栏;背包仅作为来源使用。补充清单与开容器清单分开,便于精细控制。配置键 handRestock(Tweaks 标签页,默认关闭)。

MiniHUD 信标修复

使用 MiniHUD 的自由视角时,修正信标范围显示,改用玩家的实际位置而非摄像机位置。需要 MiniHUD。配置键 fixBeaconRangeFreeCam(Tweaks 标签页,默认开启)。

村民交易修复

修复一个原版 bug。选中村民的第一项交易时,原版会接受输入物品能够支付的任何交易,并且按住 Shift 点击结果会持续交易,只要结果物品是同一种类——它会忽略附魔。因此一旦剩余的绿宝石不足以支付第一项交易,服务端就会切换到一个更便宜、给出同种类物品的交易(例如第二本附魔书)并继续购买。Item Scroller 的右键“交易全部”每次补充输入槽位时都会触发这个问题。正是在这种情况下,结果会一次只进行一次交易,一旦结果槽位切换到另一项交易就停止交易,剩余的输入物品会回到你的背包。在其他所有情况下,按住 Shift 点击的行为与原版完全一致。配置键 villagerTradeFix(Tweaks 标签页,默认开启)。

补充清单的物品选择器

无需输入物品 ID,而是通过 Lists 标签页底部的 Edit Hotbar Restock List… / Edit Hand Restock List… 按钮打开物品选择器。点击物品即可添加,再次点击即可移除。可按当前游戏语言中的物品名称或按其 ID 搜索——输入英文名称在其他语言下也可用,因为英文名称几乎总是与 ID 拼写一致(golden carrot 可以找到 minecraft:golden_carrot)。你携带的物品会排在前面,已在清单中的物品会显示绿色背景。点击后立即保存更改。

Scoreboard 标签页:Players(配置界面的一个标签页,不是设置项)

与 HikariScoreBoard 配合使用时,游戏内配置界面的 Scoreboard 标签页会列出服务端已知的玩家,分为 Shown 和 Hidden 两组,并允许你切换每个人是否出现在排名中。服务端标记为机器人的条目会标注 [Bot],便于识别。列表位于 Players 子标签页;旁边的 Display 子标签页包含 HUD 的每页行数、缩放、位置和颜色。它没有开关设置。

需求

  • Minecraft 1.17.1 - 26.2(Fabric)
  • Fabric Loader >= 0.14.0(MC 1.17.1 - 1.20.4)/ >= 0.15.10(MC 1.20.5 - 1.21.11)/ >= 0.19.5(MC 26.1 及更新版本)
  • Java 25(MC 26.1 及更新版本;与 Minecraft 26.x 本身要求的 Java 相同)
  • Fabric API
  • MaLiLib — 每个 jar 声明各自的最低版本,见下表

支持的版本

每个 Minecraft 版本组发布一个 jar。请下载与你的游戏匹配的那个。

Jar 支持的 Minecraft 版本 最低 MaLiLib
hikari-tweaks-<version>+1.17.1.jar 1.17.1 0.10.0-dev.26
hikari-tweaks-<version>+1.18.1.jar 1.18, 1.18.1 0.11.8
hikari-tweaks-<version>+1.18.2.jar 1.18.2 0.12.0
hikari-tweaks-<version>+1.19.2.jar 1.19, 1.19.1, 1.19.2 0.13.0
hikari-tweaks-<version>+1.19.3.jar 1.19.3 0.14.1-pre.1
hikari-tweaks-<version>+1.19.4.jar 1.19.4 0.15.4
hikari-tweaks-<version>+1.20.1.jar 1.20, 1.20.1 0.16.3
hikari-tweaks-<version>+1.20.2.jar 1.20.2 0.17.0
hikari-tweaks-<version>+1.20.4.jar 1.20.3, 1.20.4 0.18.4-alpha.1
hikari-tweaks-<version>+1.20.6.jar 1.20.5, 1.20.6 0.19.2
hikari-tweaks-<version>+1.21.1.jar 1.21, 1.21.1 0.21.10
hikari-tweaks-<version>+1.21.3.jar 1.21.2, 1.21.3 0.22.8
hikari-tweaks-<version>+1.21.4.jar 1.21.4 0.23.5
hikari-tweaks-<version>+1.21.5.jar 1.21.5 0.24.3
hikari-tweaks-<version>+1.21.8.jar 1.21.6, 1.21.7, 1.21.8 0.25.7
hikari-tweaks-<version>+1.21.10.jar 1.21.9, 1.21.10 0.26.8
hikari-tweaks-<version>+1.21.11.jar 1.21.11 0.27.17
hikari-tweaks-<version>+26.1.jar 26.1, 26.1.1, 26.1.2 0.28.12
hikari-tweaks-<version>+26.2.jar 26.2 0.29.6

打开配置界面

在游戏中按下 H + T —— 按住 H,然后按 T。顺序很重要。

该按键可以在配置界面的 Hotkeys 标签页中更改,或者如果你更愿意通过 Mod Menu 访问的话也可以在那里更改。计分板翻页快捷键默认未绑定,也可以在那里设置。

可选

  • MiniHUD — 信标范围修复功能需要
  • Mod Menu — 如果你不想使用快捷键,这是打开配置界面的另一种方式
  • HikariScoreBoard(服务端) — 启用自定义计分板 HUD 的数据源。没有它也能运行,但不会显示排名数据。

致谢

开发于:Hikari Server (光鯖) —— 一个 Minecraft Java 版社区服务器

依赖 / 参考实现

masa(fi.dy.masa)

Sim-hu(ASTRAL-SMP) — AST-Tweaks(Apache-2.0)

pugur — ama-tweaks(MIT)

许可证

GNU 宽通用公共许可证 v3(LGPL-3.0-or-later)

Copyright (C) 2025-2026 HikariServerDev

LGPL-3.0 在 GPL-3.0 之上附加了额外许可并通过引用将其纳入,因此两种文本作为 COPYING.LESSER(LGPL)和 COPYING(GPL)随项目分发;每个 jar 都在 META-INF/ 中携带两者的副本。所引用的第三方项目保留其各自的许可证(见 NOTICE)。

每个 jar 还在 META-INF/jars/ 下嵌入了未修改的 Gson 2.10.1,遵循其自身的 Apache License 2.0。其版权声明和完整许可证文本随同一个 jar 以 META-INF/THIRD-PARTY-NOTICES.txt 和 META-INF/licenses/Apache-2.0.txt 分发。