Yueyue Ear Guardian

Yueyue Ear Guardian / 耳朵守护者

A client-side sound control mod for Minecraft 26.3 on Fabric. Current release: 1.3.1+mc26.3. Open your inventory and click the small speaker button to choose which sounds you hear. The Creative inventory has its own unobstructed entry.

• 100 vanilla sound events in 17 collapsible groups.
• Chinese, English, and sound-event ID search.
• Individual sound switches; categories can be expanded and collapsed.
• Preview any listed sound, even when muted. The preview button does not add a UI click sound. Leaving the screen stops the preview.
• Compact item-icon rows with continuous mouse-wheel scrolling and a draggable scrollbar; no page switching.
• Sounds stay enabled by default. Your existing muted choices are preserved when updating. Shared vanilla sound events share one control, with an explanation in the tooltip.

Requires Minecraft 26.3, Java 25, Fabric Loader 0.19.5 or a compatible newer version, and Fabric API for 26.3. Install on the client; it does not require other Yueyue mods. Settings are saved locally in config/ear-guardian.json. Complete corresponding source is supplied as an additional download. License: MIT.

Anvils have eight separate sound controls, including falling-anvil landing and block placement. The ambient.cave control covers all 23 vanilla cave-ambience variants.

How to use

1. Open the survival inventory and click the speaker beside the crafting area. In Creative mode, its speaker sits above the category tabs.
2. Expand a sound group, or search by Chinese/English names or sound-event ID. Search automatically expands matching groups; you can collapse them manually.
3. Click On/Off for an individual event. Collapse/expand only changes the visible rows, not the sound preferences.
4. Preview plays only the chosen sound, without the UI button click, and follows the game's master volume. A muted event can still be previewed. Closing the screen stops the preview.

Mouse-wheel scrolling is continuous; the scrollbar can also be dragged. Search changes return to the top; toggling, folding and resizing keep the current scroll position within the valid range. Keyboard focus is visible. The mute choices are saved immediately and reused on the next launch; any newly added event starts enabled.

中文介绍与使用

耳朵守护者 1.3.1 是 Minecraft 26.3 Fabric 客户端模组。默认全部声音开启，只改变本客户端是否播放选中的声音，不要求服务器安装。

在背包中点击喇叭图标，选择关闭或开启特定声音。支持发射器/投掷器、活塞、钟、僵尸、苦力怕、骷髅、末影人、僵尸猪灵、猪灵、TNT、潜影贝、末影龙、凋零、村民、铁砧和洞穴环境音。分类可展开/收起，可用中文、英文或声音事件 ID 搜索，并可逐项试听。

1. 生存模式打开背包，点击合成区旁的喇叭；创造物品栏入口位于顶部分类标签上方，不占用物品格和搜索框。
2. 点击分类行展开或收起，分别查看普通叫声、死亡、受伤、工作等事件；搜索会自动展开匹配分类，也可以手动收起。展开/收起不会改变开关状态。
3. 每项声音旁有开启/关闭和试听按钮。关闭的声音仍可试听，试听不叠加按钮点击音，音量遵守游戏主音量，退出页面时停止。
4. 页面采用投影材料列表式紧凑图标行，用滚轮连续上下浏览或拖动右侧滚动条，不用翻页。修改搜索内容后回到顶部；切换声音开关、展开/收起和缩放时保留有效滚动位置，支持可见的键盘焦点。

共覆盖 100 个原版声音事件、17 个分类。原版共用的声音事件由同一开关控制，例如部分爆炸声和脚步声；工具提示会说明影响范围。开关即时保存到 config/ear-guardian.json，下次启动继续使用，更新保留已有关闭选项，新增声音默认开启。分类展开状态只保留在当前设置页。

铁砧共有 8 项独立开关，包括铁砧实体落地和方块放置。洞穴恐怖环境音对应 ambient.cave，原版 23 个变体统一控制。

安装需要 Java 25、Minecraft 26.3、Fabric Loader 0.19.5 或兼容版本、26.3 的 Fabric API；不依赖其它月月模组、Litematica 或 Extreme Sound Muffler。下载运行 JAR 放进 mods；附加的完整源码 ZIP 用于开发构建，不是可运行模组。

Design reference / 功能参考

The inventory entry and per-sound control concept reference the similar Extreme Sound Muffler by LeoBeliik (upstream repository). This is a functionality and interaction-design acknowledgement, not an official port or a dependency declaration. The compact list presentation follows the Litematica material-list interaction requested for this project.

功能与交互参考：Extreme Sound Muffler 的背包入口和逐项声音控制思路。此处注明的是功能参考，不表示本项目为其官方移植。实现由本项目维护，相关说明也收录在源码的 CREDITS.md 中。

Development and documentation were assisted by AI.