Enhanced Sound Control

功能特色

单个声音音量

将任意声音的音量设为 0% 到 200%。终于能听清那些总是错过的微弱声音，也能压低过于响亮的声音。

单个声音播放频率

减少重复声音的播放频率，无需将其完全静音。设为 70% 频率时，该声音只会在 70% 的情况下播放；设为 0% 则会彻底静音。适合那些偶尔听听没问题、频繁播放却很烦人的声音。

最近声音选项卡

实时显示每次播放的声音事件，最新的排在最前，并标注播放次数和距上次播放的时间。听到烦人的声音？按 N 或输入 /soundcontrol 打开菜单，它就会出现在列表顶部，随时可以编辑。

所有声音选项卡

浏览并搜索游戏中所有已注册的声音事件，还可以按类别筛选——方块、实体、物品、音乐、界面、环境和其他。声音会显示原版字幕名称（例如“苦力怕嘶嘶作响”），无需费力辨认原始 ID。

已编辑选项卡

在一个位置查看所有调整过的声音，并附有每项更改的摘要（“音量 70% · 频率 10%”）。可以逐个重置声音，也可以一次性全部清除。

编辑面板

选择任意声音，即可使用音量和频率滑块，以及可试听并应用音量调整的测试按钮和重置按钮。菜单采用现代原版界面风格，所做更改会自动保存。

静音模式

反过来控制模组：不再是静音不想听的声音，而是默认静音所有声音，只调高你想听到的声音。在菜单左上角使用模式按钮，即可在普通和静音模式之间切换。

• 每种模式都保留各自独立的列表。来回切换不会丢失你的设置——你调整的普通模式选项会保持原样，同时你也可以逐步添加允许播放的声音，反过来也一样。
• 被静音的声音仍会显示在“最近”标签页中，方便你找到想要的声音并点击允许来播放。允许和静音都是单击按钮——无需拖动滑块来设置精确数值。
• 标签会随模式变化：已编辑标签会变为已允许，而全部重置会变为清空列表。

非常适合打造简约的声音环境、录音，或屏蔽所有声音，只保留你真正关心的几个提示音。

岛屿独立设置（Hypixel SkyBlock）

在 Hypixel SkyBlock 中，你还可以为任意声音单独设置特定岛屿上的不同数值——例如，在花园中静音方块破坏声，同时在其他地方保持正常。

使用方法：

• 编辑面板中的滑块始终用于更改声音在“所有地方”的常规数值——无论是在 SkyBlock 内还是外，都会应用这些数值。
• 在 SkyBlock 中，编辑面板会新增一个“按岛屿编辑”按钮。点击后，岛屿编辑器会取代声音列表：在左侧选择一个岛屿，再用右侧的音量/频率滑块设置该岛屿的独立数值。岛屿初始状态为使用“所有地方”的数值；移动滑块后，该岛屿便会拥有自己的覆盖设置。点击移除覆盖设置即可恢复。
• 点击“复制到……”按钮，即可一次性将当前查看的数值复制到任意数量的其他岛屿——确认前不会写入任何设置。

在某个岛屿上时，会应用该岛屿的覆盖设置；在其他所有地方（以及 SkyBlock 外）则会应用“所有地方”的数值。在静音模式下也同样有效，此时岛屿编辑器中的按钮会变为在此处允许 / 在此处静音——这样就可以只允许某个岛屿播放某种声音，同时在其他岛屿保持静音。

配置

使用/soundcontrol命令或按N打开声音菜单。你可以点击菜单中的设置按钮，或通过模组菜单 → Enhanced Sound Control → 配置进入设置。Enhanced Sound Control 使用 MidnightLib，因此所有选项都可以在游戏中编辑并实时保存。

| 选项 | 说明 |
|——–|————-|
| 启用模组 | 所有声音调整的总开关。 |
| 静音模式 | 关闭：播放所有声音，只有你修改过的声音例外。开启：静音所有声音，只有你允许的声音例外。每种模式都保留各自的列表。 |
| 实时更新最近列表 | 随着新声音播放，刷新“最近”标签页。 |
| 移除 “minecraft:” 命名空间 | 显示 entity.creeper.hurt，而不是 minecraft:entity.creeper.hurt。 |
| 重新判定循环声音 | 每次循环时重新进行频率判定，而不是每种声音只判定一次。 |
| 需要按住辅助键 | 只有按住额外按键时才打开菜单，让N可以用于其他操作。 |
| 最近列表大小 | 记住多少个最近播放的声音（10–50）。 |

按键绑定

这两个按键都可以在选项 → 控制 → 按键绑定中重新设置。

| 按键绑定 | 默认 | 说明 |
|———|———|————-|
| 打开菜单 | N | 打开声音控制菜单。 |
| 辅助键 | 左 Alt | 启用需要按住辅助键时，需要额外按住的按键。 |

每种声音的调整（包括岛屿覆盖设置）会单独保存在 config/enhancedsoundcontrol.tweaks.json 中。

安装

1. 为 26.1+ 安装 Minecraft 和 Fabric Loader。
2. 从 Modrinth 下载最新的 .jar 文件。
3. 将 Fabric API 和 UI Lib 与 Enhanced Sound Control 的 jar 一起放入 mods 文件夹。MidnightLib 和 HM-API 已打包在 Enhanced Sound Control 的 jar 中，无需单独下载。
4. 启动游戏并运行 /soundcontrol，或按 N 打开编辑菜单。

支持与社区

发现了 Bug、有功能建议，或者只是想打个招呼？

支持项目

如果你想支持项目的持续开发，可以通过 Ko-fi 进行捐助——感谢每一份支持。

通过 Ko-fi 支持 →

致谢

运行时依赖

• UI Lib，由 Daqem 制作——菜单框架
• MidnightLib，由 MidnightDust 制作——配置功能
• HM API，由 AzureAaron 制作——用于检测 SkyBlock 岛屿的 Hypixel Mod API 客户端

功能与设计灵感

• Sound Controller，由 BVengo 制作——单个声音的音量调节流程、独特的 0–200% 音量范围与增强标记、可搜索的声音管理及修改后声音的管理、预览/重置控件，以及针对单个声音调整播放音量的整体设计思路
• SoundsBeGone，由 Meza 制作——最近播放声音的操作流程，以及可配置的重复声音播放频率

这些项目为功能与交互设计提供了灵感。Enhanced Sound Control 拥有独立的实现方式、界面、存储格式，以及针对 SkyBlock 的专属功能。

本项目的创作过程中广泛使用了 AI 工具。