Sound Culling

Sound Culling

Sound Culling 是一款 Minecraft 客户端模组，可减少
农场、刷怪笼房间和机械设备等繁忙区域中的重复声音。当附近的声音活动超过
设定阈值时，它可以降低声音音量，或阻止声音播放。

该模组会按位置和来源追踪近期的声音事件。每次判断都可以考虑重复播放、区域活动、声音类别、距离、方向以及
当前事件速率。单个嘈杂声源对共享区域计数的贡献有限，但仍能检测到该声源发出的重复声音。

Sound Culling 只会改变客户端音频。它不会影响实体、方块、
游戏玩法或服务端行为，也无需安装在服务器上。

功能

• 在声音创建音频通道之前，拦截过量声音。
• 在无需完全拦截时降低声音音量。
• 随着整体声音事件速率升高，动态调整阈值。
• 追踪附近的区域单元，避免区域边界处出现突变。
• 限制单个声源对区域声音预算的影响。
• 逐步调整循环声音和可逐刻更新声音的音量，并重新评估它们。
• 在常规声音剔除期间，为玩家反馈音效提供额外保护。
• 支持精确声音 ID、通配符模式和完整模组命名空间。
• 在游戏中显示近期声音、事件计数和本次会话统计数据。
• 提供 Balanced、Performance、Aggressive 和 Custom 预设。
• 遇到兼容的运行时错误时，允许声音继续播放。

音乐和相对声音（包括界面音频）不会受到影响。Minecraft 已判定超出
可听范围的声音不会被加入追踪器。

配置

安装 Mod Menu 以打开包含四个页面的设置界面：

• 概览包含主开关、预设和本次会话统计数据。
• 性能包含自适应阈值和类别限制。
• 实时声音列出近期声音 ID，并提供规则操作。
• 高级包含空间追踪、优先级和日志选项。

打开设置界面时，单人世界不会暂停，因此声音统计数据仍会持续
更新。使用保存并关闭以应用更改。取消
会舍弃尚未保存的设置修改。

设置保存在：

config/soundculling.json

在可能的情况下，旧版配置文件会自动迁移。无效的数值会被限制在支持的范围内。如果无法加载配置文件，模组将使用
并保存默认设置。

预设

| 预设 | 用途 |
| — | — |
| Balanced | 日常游玩的起始预设。 |
| Performance | 为繁忙区域设置更低的限制，并更早启用自适应压力控制。 |
| Aggressive | 针对持续的声音刷屏设置更严格的限制。 |
| Custom | 修改单项限制后使用的预设。 |

预设会调整类别限制、区域限制和自适应阈值。
它们不会移除自定义声音规则。

声音规则

规则可以保护某个声音、提高或降低其优先级，或阻止它开始播放。在实时声音页面选择一个声音，即可创建规则，无需编辑 JSON 文件。保护模组会创建一条覆盖整个命名空间的保护规则。

可用的规则操作：

| 操作 | 效果 |
| — | — |
| NEVER_CULL | 在声音剔除决策中排除匹配的声音。 |
| CRITICAL | 应用最高优先级乘数。 |
| HIGH | 在负载较高时提高优先级。 |
| NORMAL | 使用正常的优先级计算方式。 |
| AGGRESSIVE | 降低优先级。 |
| ALWAYS_CULL | 拒绝新的播放，并将已跟踪的循环声音逐渐淡出至零。 |

匹配模式不区分大小写，并支持将 * 用作通配符：

minecraft:block.piston.*
bettercombat:*
presencefootsteps:*

当多条规则匹配时，以最后一条匹配的规则为准。旧版 whitelistedSounds 列表中的精确 ID 优先于规则，包括 ALWAYS_CULL。

命令

Sound Culling 提供客户端命令，无需服务器管理员权限：

/soundculling
/soundculling toggle
/soundculling preset balanced
/soundculling preset performance
/soundculling preset aggressive
/soundculling limit <1-50>
/soundculling total <1-100>
/soundculling reset

基础命令会显示当前预设、事件速率、自适应压力和会话计数。设置命令会立即应用并保存。重置命令会清除会话统计数据和近期声音历史记录，但不会清除当前剔除决策所使用的滚动活动数据。

安装

1. 为你的 Minecraft 版本安装 Fabric Loader 和 Fabric API。
2. 下载适用于该 Minecraft 版本的 Sound Culling 文件。
3. 将 JAR 文件放入实例的 mods 文件夹。
4. 如果想从“模组”菜单访问设置界面，请安装 Mod Menu。

不同 Minecraft 版本组使用各自独立的构建版本，即使它们的 JAR 文件名相似。请查看单个下载文件标注的支持版本。

Sound Culling 2.0 提供 Fabric 版本。较早的 Fabric、Forge 和 NeoForge 文件可能使用旧版引擎，也可能不包含实时声音页面、自适应压力、通配符规则或持久循环声音管理功能。

整合包

Sound Culling 可以加入整合包。它是客户端模组，并采用 MIT License 进行分发。整合包可以使用预设和规则，为其中会产生声音的模组调整设置。如果某个模组采用了特殊的播放方式，请在发布整合包配置前测试其单次播放和循环播放的声音。

问题反馈

请在 GitHub 提交问题，并附上：

• Minecraft、加载器、Fabric API 和 Sound Culling 的版本。
• 下载的文件名。
• 重现问题的步骤。
• 其他会改变声音播放方式的模组。
• logs/latest.log 和崩溃报告（如果有）。

如果是声音缺失问题，也请提供已知的声音 ID、任何匹配的规则，以及该声音是单次播放还是持续循环播放。

Sound Culling 采用 MIT License 许可。