EchoSight
Minecraft 的无障碍与声音感知辅助。客户端模组,适用于 Fabric,兼容任何服务器。
Minecraft 中一半关乎生死的信息来自音频:苦力怕的嘶嘶声、身后的洞穴蜘蛛、拉满的弓弦声、溺水声。对于听障或重听玩家——以及任何关闭声音游玩的玩家——这一信息渠道完全缺失。原版字幕只能告诉你发生了某事。但它们不会告诉你在哪里、有多远,或者有多重要。
EchoSight 对客户端播放的每种声音进行分类,并将其渲染为方向、距离和优先级。
功能
定向威胁环
每种声音都会在你的准星周围形成一个弧形:
| 通道 |
编码内容 |
| 角度 |
方位角 —— 每帧重新计算,因此当你转身时弧会扫过 |
| 轨道(3 个环) |
距离带:≤12 / ≤32 / >32 格 |
| 粗细 |
严重程度 —— 无需颜色即可识别 |
| 颜色 |
声音身份 —— 不同的生物和事件保持可区分 |
优先级分类
- 致命 —— 已点燃的苦力怕、监守者、恶魂火球、TNT
- 危险 —— 洞穴蜘蛛、岩浆、 incoming 箭矢
- 信息性 —— 物品拾取、经验值、村民、门、箱子
四种预设,一键切换
全部 → 除噪音外全部 (默认) → 仅重要 → 仅致命。
针对单个声音的覆盖设置始终优于预设,双向生效。
色盲安全配色方案
基于 Okabe–Ito 调色板,并包含红绿色盲、蓝黄色盲和单色变体。严重程度通过弧形粗细保持可读,且每个字幕行都带有独特的形状符号 —— 颜色绝不会是唯一的信息通道。
重构的字幕面板
分组与去重(重复触发的源显示为一行及重复计数,而非刷屏),实时显示以格为单位的距离、方位指针和优先级排序 —— 致命行永远不会被杂音挤到底部之外。
持续声音真正持续
唱片机在 HUD 上停留的时间与唱片实际播放的时间一样长,而不是在有人按下播放键后仅仅两秒。只要引擎仍在播放这些声音且你仍处于其可听半径内,声源就会持续发布 —— 走近它会显现,走远它会衰减。
可选的屏幕边缘脉冲
针对关键声音的“触觉”提示。默认关闭,按严重程度限制,采用平滑衰减而非频闪 —— 任何闪烁整个屏幕的效果均为可选开启,因为对于光敏性玩家来说,这是危害而非辅助。
游戏内调优
一个基于你实际听到的声音构建的事件屏幕:支持搜索,可按由我修改或无规则进行过滤,每行显示命中次数和上次听到时间。设置界面不会暂停游戏,且环形指示器在这两种界面下均可见 —— 你可以针对实时声音调整半径、不透明度和滞留时间。
15 种语言
英语、俄语、西班牙语、葡萄牙语(巴西)、法语、德语、意大利语、荷兰语、波兰语、乌克兰语、土耳其语、简体中文和繁体中文、日语、韩语。声音名称源自 Minecraft 自身的字幕键,因此它们也跟随你的客户端语言。
公平竞技 —— 这不是透视(ESP)
边界在代码层面得到强制执行,而不仅仅是意图上:
- EchoSight 仅查看客户端实际接收并开始播放的声音 —— 它挂钩了原版字幕使用的同一个
SoundEventListener。
- 在声音处理路径中没有任何实体查找、射线投射或层级查询。 声音事件 ID 是唯一的来源,因此一堵墙后的生物对你而言的可识别程度与对听力正常的玩家完全相同 —— 不多不少。
- 没有明确方向的声音(UI、音乐、相对于监听者的声音)获得无方位指示,而不是被误导性地固定在脚下。
- 不会显示任何原版音频不再携带的内容。
一个刻意的例外,方向相反:EchoSight 不受你的音量滑块限制。即使主音量设为零也能工作 —— 这正是其目标受众的核心需求。
安装
- Minecraft 26.2,搭配 Fabric Loader ≥ 0.19.3 和 Java 25
- 安装 Fabric API
- 将 jar 文件放入
.minecraft/mods/ 目录
仅限客户端 —— 适用于任何服务器,包括原版。Mod Menu 为可选;安装后,也可通过配置按钮访问设置。
| 按键 |
操作 |
K |
打开 EchoSight 设置 |
| 未绑定 |
切换 EchoSight 开/关 |
配置文件位于 .minecraft/config/echosight.json,但所有设置均可从 UI 访问 —— 无需手动编辑。
给资源包作者
规则由数据驱动。在任何资源包的 assets/<namespace>/echosight/rules/<anything>.json 位置放置一个 JSON 文件 —— 无需模组依赖,无需代码。资源包按加载顺序合并,F3+T 可重新加载它们。
{
"category_fallback": { "hostile": "dangerous" },
"rules": [
{ "match": "minecraft:entity.creeper.primed", "severity": "lethal", "glyph": "burst" },
{ "prefix": "minecraft:entity.warden.", "severity": "lethal", "glyph": "eye" },
{ "match": "mymod:entity.thing.growl", "severity": "dangerous", "label": "mymod.echosight.thing" }
]
}
| 字段 |
含义 |
match |
完整的声音 ID;允许使用 * 通配符 |
prefix |
以此开头的任意 ID |
severity |
lethal | dangerous | info | ignored |
glyph |
burst spike fang eye flow block dot dash |
label |
可选的翻译键,用于覆盖原版字幕 |
replace |
顶层字段;丢弃在此文件之前合并的所有内容 |
匹配优先级:精确 ID → 具有最多字面字符的模式 → SoundSource 回退。内置规则集为 26.2 版本的 1873 个声音 ID 中的 618 个编写了显式规则,其余则故意留给其所属类别 —— 规则仅在类别错误的地方存在。无法识别的声音仍会通过回退机制显示,而不是无声消失。
技术说明
- 零混入(mixins)。声音捕获使用官方认可的
SoundManager.addListener 钩子;HUD 使用 Fabric 的 HudElementRegistry。无需担心跨版本更新的 mixin 脆弱性问题。
- 方位信息源自音频引擎自身的监听器变换,而非玩家朝向——因此屏幕上的方向与你实际听到声音时的耳朵位置一致,且在第三人称和旁观者模式下也能保持正确。
- 原版字幕被包裹而非移除——关闭面板时能干净地回退到原版渲染效果。
- 符号与弧线为程序化生成,非纹理贴图——在任何 GUI 缩放比例下均保持清晰锐利。
由 Shinoame 制作。
EchoSight
Accessibility and sound awareness for Minecraft. Client-side, Fabric, works on any server.
Half of Minecraft's life-or-death information is audio: the creeper's hiss, the cave spider behind you, a drawn bowstring, drowning. For deaf and hard-of-hearing players — and for anyone playing with the sound off — that channel simply isn't there. Vanilla subtitles tell you something happened. They don't tell you where, how far, or how much it matters.
EchoSight classifies every sound the client plays and renders it as direction, distance and priority.
Features
Directional threat ring
Every sound becomes an arc around your crosshair:
| Channel |
Encodes |
| Angle |
Bearing — recomputed every frame, so arcs sweep as you turn |
| Track (3 rings) |
Distance band: ≤12 / ≤32 / >32 blocks |
| Thickness |
Severity — readable without colour |
| Colour |
Sound identity — different mobs and events stay distinguishable |
Priority classification
- Lethal — primed creeper, warden, ghast fireball, TNT
- Dangerous — cave spider, lava, incoming arrows
- Informational — item pickup, XP, villagers, doors, chests
Four presets, one button
All → All except noise (default) → Significant only → Lethal only.
Per-sound overrides always beat the preset, in both directions.
Colour-blind-safe palettes
Okabe–Ito base plus deuteranopia, protanopia, tritanopia and monochrome variants. Severity stays readable from arc thickness, and every subtitle row carries a distinct shape glyph — colour is never the only channel.
Reworked subtitle panel
Grouping and dedup (a retriggering source is one row with a repeat count, not a flood), live distance in blocks, a bearing pointer, and priority ordering — a lethal row is never pushed off the bottom by chatter.
Continuous sounds are actually continuous
A jukebox stays on the HUD for as long as the record is really playing, not for two seconds after someone pressed play. Sources are re-published while the engine still has them playing and you're still inside their audible radius — walk up and it appears, walk away and it decays.
Optional screen-edge pulse
A "tactile" cue for critical sounds. Off by default, severity-gated, smooth decay rather than a strobe — anything that flashes the whole screen is opt-in, because for photosensitive players it's a hazard, not an aid.
In-game tuning
A per-event screen built from the sounds you have actually heard: searchable, filterable down to changed by me or no rule, with hit counts and "last heard" per row. Neither settings screen pauses the game, and the ring stays visible over both — you tune radius, opacity and linger against live sound.
15 languages
English, Russian, Spanish, Portuguese (BR), French, German, Italian, Dutch, Polish, Ukrainian, Turkish, Simplified and Traditional Chinese, Japanese, Korean. Sound names come from Minecraft's own subtitle keys, so they follow your client language too.
Fair play — this is not an ESP
The boundary is enforced in code, not just intent:
- EchoSight only sees sounds the client actually received and started playing — it hooks the same
SoundEventListener that vanilla subtitles use.
- No entity lookups, no raycasts, no level queries anywhere in the sound path. The sound event id is the only information source, so a mob behind a wall is exactly as identifiable to you as it is to a hearing player — no more.
- Sounds with no meaningful direction (UI, music, listener-relative) get no bearing instead of being misleadingly pinned to your feet.
- Nothing is shown that vanilla audio would not still be carrying.
One deliberate exception, in the other direction: EchoSight is not gated on your volume sliders. It works with master volume at zero — which is the entire point for its audience.
Installation
- Minecraft 26.2 with Fabric Loader ≥ 0.19.3 and Java 25
- Install Fabric API
- Drop the jar into
.minecraft/mods/
Client-side only — works on any server, including vanilla. Mod Menu is optional; with it installed, settings are also reachable from the Configure button.
| Key |
Action |
K |
Open EchoSight settings |
| unbound |
Toggle EchoSight on/off |
Config lives at .minecraft/config/echosight.json, but every setting is reachable from the UI — hand-editing is never required.
For resource pack authors
Rules are data-driven. Drop a JSON file at assets/<namespace>/echosight/rules/<anything>.json in any resource pack — no mod dependency, no code. Packs merge in load order, and F3+T reloads them.
{
"category_fallback": { "hostile": "dangerous" },
"rules": [
{ "match": "minecraft:entity.creeper.primed", "severity": "lethal", "glyph": "burst" },
{ "prefix": "minecraft:entity.warden.", "severity": "lethal", "glyph": "eye" },
{ "match": "mymod:entity.thing.growl", "severity": "dangerous", "label": "mymod.echosight.thing" }
]
}
| Field |
Meaning |
match |
Full sound id; * wildcards allowed |
prefix |
Any id starting with this |
severity |
lethal | dangerous | info | ignored |
glyph |
burst spike fang eye flow block dot dash |
label |
Optional translation key overriding the vanilla subtitle |
replace |
Top-level; discards everything merged before this file |
Match priority: exact id → pattern with the most literal characters → SoundSource fallback. The shipped ruleset writes explicit rules for 618 of 26.2's 1873 sound ids and leaves the rest to their category on purpose — the rules exist where the category is wrong. Unrecognised sounds still surface via the fallback rather than silently vanishing.
Technical notes
- Zero mixins. Sound capture uses the sanctioned
SoundManager.addListener hook; the HUD uses Fabric's HudElementRegistry. No mixin fragility across updates.
- Bearings come from the audio engine's own listener transform, not player yaw — so on-screen direction matches the ear you'd have heard it in, and stays correct in third person and spectator.
- Vanilla subtitles are wrapped, not removed — turning the panel off falls back cleanly to vanilla rendering.
- Glyphs and arcs are procedural, not textured — crisp at every GUI scale.
By Shinoame.
评论 0
登录后参与评分
还没有评论,来抢沙发吧