扩展洞穴音效

🔊 洞穴音效扩展

50种全新的大气、有时令人毛骨悚然的洞穴环境音效——与原版音效池混合播放，亦支持完全替换。

   

---

概述

Minecraft 自带的 ambient.cave 音效仅有13种。在地下待久了，你就能把每种嘎吱声和低吼声背下来。洞穴音效扩展直接接入游戏现有的洞穴氛围系统，将音效轮换池从13种提升至63种——且不改变环境音效的触发时机、淡入方式或3D空间定位。

音效不会变响，频率不会更高。你只是在下一次播放时听到新内容。

特性

• 50首全新的单声道 Ogg Vorbis 音轨——以44.1kHz、质量5制作，通过OpenAL实现清晰的定位音频
• 默认与原版混播——两个音效池同时轮换；原版氛围不被丢失
• 一键纯扩展模式——切换一个配置项即可变为仅扩展音效
• 零 gameplay 改动——相同的触发节奏、相同的黑暗/生物群系规则、相同的 soundPositionOffset
• 仅客户端——放入即可；服务器无需安装
• 体积小巧——总计约3.6 MB，单个 Mixin，无运行时反射，无每 tick 轮询
• 与沉浸式模组友好共存——Sound Physics Remastered 混响和 Presence Footsteps 不受影响
• 无强制依赖——无需 Fabric API

工作原理

本模组并未重新实现洞穴环境音效。它让原版继续做自己该做的事——每 tick 在玩家周围17×17×17的方块空间中采样一个随机方块，在足够暗时增加一个氛围计数器，并在随机抖动的偏移位置触发 minecraft:ambient.cave。

在 Minecraft 调用 SoundManager#play 播放该洞穴音效的瞬间，一个 Mixin 拦截了该调度并决定后续动作：

情况	动作
非洞穴音效	放行。游戏中其他所有音效不受影响。
洞穴音效，硬币翻转选中原版	放行。原版的13种变体按原样播放。
洞穴音效，硬币翻转选中扩展	取消原音效，在相同位置/音量/音高下调度50种新音效之一。

由于钩子位于调度点而非上游氛围处理管线，所有原版的可调旋钮——生物群系 tickDelay、blockSearchExtent、soundPositionOffset、字幕分类、下游模组的混响——都保持正常工作。

配置

首次启动时，一个纯 JSON 配置文件会被写入 .minecraft/config/expandedcavesounds.json：

{
  "playVanillaCaveSounds": true
}

设置	值	效果
playVanillaCaveSounds	true	默认。 原版13种音效与50种扩展音效按50/50比例公平混播。
	false	仅扩展音效。原版的 ambient.cave 在每次触发时被替换。

编辑文件后重启 Minecraft。

兼容性

加载器	Minecraft	安装文件	备注
Forge 47.x	1.20.1	...-forge-1.20.1-*.jar	主要 Forge 目标
NeoForge 47.1.x	1.20.1	...-forge-1.20.1-*.jar	1.20.1 上的 NeoForge 与 Forge 兼容
Fabric 0.15+	1.20.1	...-fabric-1.20.1-*.jar	主要 Fabric 目标
Quilt 0.22+	1.20.1	...-fabric-1.20.1-*.jar	通过 Quilt 的 Fabric 兼容层加载

• Java： JDK 17（随每个标准 Minecraft 启动器捆绑）
• 端侧： 仅客户端——服务器无需安装任何东西
• 所需模组： 无。不需要 Fabric API。

安装

1. 从 Files 标签页中选择与你加载器匹配的 jar 文件。
2. 将其放入你的 .minecraft/mods/ 文件夹。
3. 启动游戏并加载任意世界。
4. 前往地下——当原版氛围计数器首次触发时（黑暗条件加上约五分钟游戏时间），扩展轮换池立即生效。

整合包许可

可在任何整合包中免费使用，公开或私人、商业化或非商业化均可。署名值得赞赏但非必须。链接回此 CurseForge 页面有助于反馈问题。

常见问题

它在多人服务器上能用吗？

能。模组完全在客户端运行——每位玩家听到自己的音景。只需在希望获得扩展环境音效的客户端上安装即可。服务器无需任何改动。

它会替换原版洞穴音效吗？

默认情况下不会。在默认配置中，原版的13种音效仍然会播放——模组只是额外添加了50种到轮换池中。如果你希望仅使用扩展音效，可将 playVanillaCaveSounds 设为 false。

它会与 AmbientSounds、Dynamic Surroundings 或 Sound Physics Remastered 冲突吗？

不会。Mixin 仅拦截 minecraft:ambient.cave 的调度。其他环境音效层——生物群系环境音效、混响/DSP、天气——完全不受影响。特别地，Sound Physics 的混响工作不变，因为本模组替换的是源样本，而非调度管线。

它会改变我听到洞穴音效的频率吗？

不会。原版氛围采样器仍然决定何时播放音效。本模组仅决定该次调度使用哪个音效。

开发路线图

• v0.2——Y 区间与生物群系感知的音效池（深暗之域、滴水石洞、繁茂洞穴）
• v0.3——Cloth Config 配置界面、游戏内音量滑块、原版/扩展权重滑块
• v0.4——几何结构感知的选择（狭窄隧道 vs 开阔洞穴 vs 峡谷）
• v1.0——原生 NeoForge neoforge.mods.toml jar；支持 1.21.x

鸣谢与许可

保留所有权利。 音效设计与编程由 dylanjkl 完成。