音频调整

SoundTweaks

一个客户端 Fabric 模组，用于独立调节单个声音和方块的音量，互不影响且不影响游戏主音量。

---

功能

单声音音量控制

每个声音事件都有独立的音量滑块，范围从 0%（静音）到 100%（默认）。调节一个声音不会影响其他任何声音。

单方块音量控制

有些方块会发出 Minecraft 内置类别无法区分的声音——例如活塞、发射器、音符盒、侦测器等。SoundTweaks 为这些方块添加了独立的音量层。方块音量范围从 0% 到 100%。

类别和对象筛选

主界面有两个下拉筛选器：类别（方块、实体、物品、环境、音乐、唱片、UI、天气、附魔、事件、红石、其他）和对象（该类别中的具体实体、物品或方块）。还提供文本搜索栏。

红石是一个跨类别分组——它将所有与红石相关的方块（活塞、比较器、拉杆、音符盒、发射器、幽匿感测体等）的声音组合在一起，不论其基础声音前缀是什么。

简单视图 / 详细视图

两种浏览列表的方式：

• 简单视图 —— 每个声音事件对应一个条目
• 详细视图 —— 每个事件内包含单独的 .ogg 文件，可精确锁定播放的具体声音

静音按钮

左上角的扬声器图标可静音当前可见的所有声音（基于当前筛选条件）。再次点击恢复。静音状态不会写入已保存的配置——它只是临时生效。

---

预设

一个预设存储了一组声音和方块的音量覆盖值。启用时，其数值优先于基础配置。如果多个预设同时启用且都对同一个声音定义了数值，则取偏离 100% 最大的那个。

创建预设： 进入预设界面并点击"新建预设"。它会从当前基础配置的副本开始——只有不处于 100% 的条目才会被复制过来。

编辑预设： 从列表中选择预设打开详情面板。可用标签页：- 打开配置文件夹（预设界面页脚）：在系统文件管理器中打开 .minecraft/config/ 文件夹。

---

配置文件

所有配置均以纯 JSON 格式存储在 .minecraft/config/ 中：

文件	内容
soundtweaks.json	基础声音音量（键：声音事件 ID，值：浮点数 0–1）
soundtweaks_blocks.json	基础方块音量（键：方块 ID，值：浮点数 0–1）
soundtweaks_presets.json	所有预设、激活状态和收藏列表

配置在最后一次更改后约 300 毫秒自动保存。你也可以在游戏关闭时直接编辑 JSON 文件。

---

音量解析顺序

对于任何给定的声音，有效音量按以下顺序确定：

1. 临时静音层 —— 由静音按钮设置；关闭按钮或游戏重启后清除
2. 激活的预设 —— 如果多个预设定义了同一个声音，取偏离 100% 最大的那个
3. 基础配置 —— soundtweaks.json / soundtweaks_blocks.json
4. 默认值 —— 100%（不变）

---

如何打开界面

按 K（默认按键绑定，可在 Minecraft 控制设置中修改）打开 SoundTweaks 界面。

---

兼容性

• 仅客户端 —— 服务器无需安装此模组
• 仅支持 Fabric 加载器
• 支持 Minecraft 26.1.2
• 不替换或封装声音引擎——通过 Mixin 在播放时拦截音量

---

由 scr0ols 制作 —— MIT 许可证