Eymistaken’s HUD

Eymistaken’s HUD

一款适用于 Fabric 的模块化 PvP HUD——七个模块、拖放式编辑器和插件 API。

访问官方网站和用户指南

模块展示、Keystrokes Designer 指南以及完整 API 文档都在这里。

Eymistaken’s HUD 为你带来模组客户端的竞技叠加界面，无需使用模组客户端。所有内容都在客户端绘制，可按你的喜好精确摆放，并储存在一个配置文件中，还能以文本字符串的形式分享。

为什么选择这款模组

| | |
|—|—|
| 所有元素都可移动 | 在游戏内使用实时编辑器，将任意模块拖到任何位置。支持吸附、可选网格、对齐和分布工具，以及逐个元素微调位置。 |
| 所有元素都可自定义主题 | 可为每个模块单独设置颜色、缩放、彩虹模式、背景颜色和不透明度、自定义标签文本、文字描边，还附带五种字体。 |
| 轻量不臃肿 | 无运行时 GUI 前置库依赖。仅限客户端使用——无需在服务器安装，也不会混入游戏逻辑。 |
| 布局可移植 | 保存命名预设、为每个服务器自动记住布局，也可以将整个 HUD 导出为分享码，发给朋友粘贴使用。 |
| 支持扩展 | 开放的 API 可供其他模组注册自己的 HUD 模块、添加专属设置选项卡，并订阅战斗事件。 |

模块

CPS

左键和右键点击计数器，可自定义分隔符以及任意文本前后缀，因此你可以显示
12 | 4、CPS: 12或任何其他内容。

击键显示

完全自定义的按键显示，不是固定的 WASD 模块。借助随附的 Keystrokes Designer，你可以绘制自己的布局：添加任意按键或鼠标按钮、调整大小、单独拖动标签、更改单个按键的颜色，并选择按下动画（无、挤压、涟漪或两者兼有）。任何按键都可以显示自己的 CPS 计数。

连击

带热力图的连续命中计数器：连击次数越高，数字颜色会随之变化，达到最高等级时还会抖动。三种难度曲线决定各等级的触发次数。

| 热力图模式 | 等级 1 | 等级 2 | 等级 3（抖动） |
|—|—|—|—|
| 简单 | 命中 3 次 | 命中 5 次 | 命中 7 次 |
| 中等 （默认） | 命中 5 次 | 命中 8 次 | 命中 12 次 |
| 困难 | 命中 10 次 | 命中 40 次 | 命中 60 次 |

它也能适应你的战斗方式。经典模式会统计每次挥击；现代模式则会考虑 1.9+ 的攻击冷却时间，避免快速连点虚增连击数。你可以选择受到任何伤害时是否中断连击、切换目标后是否保留连击，以及计时结束前连击显示保留多久。

攻击距离

显示你上次命中的精确距离，包含小数。可选仅统计玩家，并可设置自定义的“尚未命中”标签，让它在没有命中记录时也继续显示，而不是消失。

护甲

以物品图标和耐久条显示你的护甲、主手和副手装备。可纵向或横向排列，可在类似快捷栏的物品栏背景上绘制，可显示精确耐久数值，并在物品栏位受到伤害时闪红。每个物品栏位都是可独立摆放的元素——你也可以把它们分别散布在屏幕各处。

FPS 和延迟

轻量的性能信息显示，可自定义标签文本、颜色、缩放和背景——无需打开 F3 就能查看这些数值。

布局编辑器

在游戏中按下 Right Shift即可打开编辑器。你看到的就是实时显示的实际 HUD。

• 将任意模块——或任意单个盔甲槽位——拖拽到精确位置。
• 右键点击某个元素，即可直接从 HUD 打开它自己的设置右键菜单。
• 多选两个或更多元素，即可解锁左/中/右对齐、上/中/下对齐，以及水平/垂直分布。
• 吸附到其他模块的边缘，另有可选的像素网格（4/8/16/32）。
• 防止重叠可让两个模块永远不会覆盖相同的像素。
• 右键点击空白处打开全局菜单：设置、预设、服务器配置、分享代码以及完整的布局重置。

设置界面

一个专门打造的设置界面——每个模块一页，分标签页展示，带有可按名称查找任意设置的搜索框、逐行说明和默认值，以及任何已更改项的一键重置。无论 Minecraft GUI 缩放比例如何，它都保持单一可读尺寸，你还可以将该基准在 50% 到 200% 之间微调。

从 ModMenu 或编辑器的全局菜单打开它。

预设、服务器配置与分享代码

| 功能 | 作用 |
|—|—|
| 命名预设 | 以名称保存整个 HUD，并在它们之间即时切换。以纯 JSON 形式存储在 simplecps_presets/ 中。 |
| 按服务器配置 | 开启后，你的 HUD 会按服务器分别记住。加入你配置过的服务器时，其布局会静默加载；在那里所做的编辑会保存回该服务器。单人游戏共用一个配置。 |
| 分享代码 | 将整个 HUD——或仅按键显示布局——导出为 EYMHUD1-… 字符串。复制它、发送它、粘贴它。导入前会进行完整校验，并且会先创建带时间戳的备份。 |

外观

在原版基础上内置五种字体——Inter、Rubik、JetBrains Mono、Bebas Neue 以及附魔台字体——仅应用于 HUD 元素和本模组自己的界面，绝不用于聊天或原版菜单。用细黑描边替代原版阴影，并按模块设置颜色、缩放、背景和不透明度。

_（字体仍在改进中。它们还不完美。抱歉。）_

安装

1. 安装 Fabric Loader（0.18.4 或更新版本）。
2. 安装 Fabric API。
3. 下载 Eymistaken’s HUD 并将 .jar 放入你的 .minecraft/mods 文件夹。

ModMenu 是可选的，仅添加一个打开设置界面的按钮。没有 Cloth Config 要求——设置界面已内置于模组中。

要求： Minecraft 26.1–26.2 · Java 25 · Fabric · 仅客户端。

⚠ 从低于 v1.0.8 的版本更新？

请先删除旧的 simplecps.json 配置文件，以避免布局问题并采用更新的默认值。

面向开发者

第三方模组可以通过 eymistaken_hud 入口点注册自己的 HUD 模块。注册的模块会免费获得一个设置页面、拖放编辑器中的一个槽位，并且其状态会包含在预设、服务器配置和分享代码中。

public class MyPlugin implements EymistakenHudPlugin {
    @Override
    public void registerHudModules(HudModuleManager manager) {
        manager.registerModule(new MyHudModule());
    }

    @Override
    public void registerEvents(EymistakenHudEventBus bus) {
        bus.subscribe(ComboStreakEvent.class, event -> {
            if (event.level() >= 2) playHypeSound();
        });
    }
}

模块可以声明自己的设置标签页，向编辑器的右键菜单暴露滑块/开关/颜色选择器/文本字段，并拆分为可独立放置的子元素。完整文档见官方网站。

通过 API 注册的第三方模块——它拥有自己的设置页面、自己的标签页，以及在编辑器中占有一席之地，列在侧边栏的 PLUGINS 下。

链接

• 官方网站与用户指南
• 源代码
• 报告问题

采用 MIT 许可证。