平滑稳定的音乐过渡。防止在进出房屋、走近门口或穿越生物群系边界时音乐不断切换和停止。

稳定音乐

一个轻量级的《英灵神殿》客户端模组（兼容《英灵神殿》1.0+），可创建 平滑稳定的环境音乐过渡 并防止在进出房屋或穿越生物群系边界时音乐不断停止、恢复和来回切换。

---

原版《英灵神殿》的问题

在原版《英灵神殿》中，环境音乐会在瞬间切换，就在 玩家.IsSafeInHome() 开关：

• 踏出舱门去查看外面的窑炉、箱子或花园，会立刻中断你的温馨状态 主页 音乐并开始生物群系音乐（例如 黑森林）。
• 4秒后走回屋内会中断生物群系音乐并继续播放 主页 音乐。
• 在门口、窗户或楼梯附近行走时，你的掩护值可能会短暂下降一帧，导致游戏突然停止并在同一秒重新开始播放歌曲。

结果是音乐不断被切换：你永远只能听到歌曲5到10秒的片段。

---

SteadyMusic如何解决

• 智能迟滞（延迟）:
  • 退出主页延迟 （默认： 20秒): 走到外面的院子或门廊不会打断你的 首页 音乐。当你在户外快速做家务时，音乐继续平静地播放着。
  • 进入家园延迟 （默认： 10秒短暂跑进小屋拿箭或躲雨，不会立刻中断你当前的生物群系冒险进度。
  • 门廊下沉修复穿过门或靠近窗户时出现的1帧遮挡下沉永远不会触发赛道重新开始。
• 最短赛道时长 默认： 45秒：
  • 当环境音乐开始播放时，会给予它足够的播放时间。在其至少播放达到配置的最短时间之前，不会被另一首环境音乐替换。
• 生物群系切换防抖 （默认： 15秒：
  • 沿着两个生物群系（例如草地和黑森林）的边界奔跑，不会让音乐快速来回切换。
• 战斗与团队副本保持即时优先:
  • 紧急音乐（战斗、突袭、首领战、死亡、过场动画）触发 立即 零延迟。
• 可选家园模式:
  • 将家园音乐扩展至基地：如果启用，基地音乐将在整个基地范围内持续播放（工作台/床/火炉附近），而不仅限于有屋顶的区域。
• 可选禁用主页音乐:
  • 献给喜欢在基地休息时也聆听荒野生物群系音乐的玩家。

---

控制

• F9在游戏内开启/关闭稳定音乐（可配置）。

---

配置

设置文件位于 BepInEx/config/Allifreyr.SteadyMusic.cfg:

章节	按键	默认	描述
通用	启用	真	启用或禁用模组的主开关。
延迟	进入家园延迟	10.0	在家中切换生物群系音乐到家园音乐前的秒数。
延迟	退出主页延迟	20.0	离开家园后，切换回家园音乐转为生物群系音乐前的秒数。
延迟	最短曲目时长	45.0	环境音轨在被另一条环境音轨接替前的最短播放秒数。
延迟	生物群系过渡延迟	15.0	在新生物群系中停留的秒数，之后环境音乐过渡到新生物群系主题。
功能	将家园音乐扩展至基地	假	如果启用，主基地结构区域内将全程播放家园音乐。
功能	在切换前完成赛道	假	如果启用，将在当前歌曲播放完毕后进行切换。
功能	禁用主页音乐	假	如果启用，即使在房屋内也始终播放生物群系音乐。
控制	切换快捷键	F9	切换稳定音乐开/关的键盘快捷键。
控制	显示切换消息	真	切换时显示屏幕通知。
诊断	启用调试日志记录	假	将音乐过渡计时器记录到BepInEx控制台。

---

安装

1. 安装 BepInExPack Valheim.
2. 提取 稳定音乐.dll 进入你的 《英灵神殿》/BepInEx/plugins/ 目录（或使用模组管理器）。