为瓦尔海姆自定义基于位置的音乐和环境区域，通过实时重载的YAML进行配置。

区域音频

ZoneAudio为Valheim添加了基于位置的自定义音乐和环境音效区域。

在YAML配置文件中创建区域，将音频文件放入模组的音频文件夹，ZoneAudio会在玩家穿过这些区域时淡入淡出音轨。

功能

• 基于 YAML 的区域配置
• 当以下情况时实时重载 区域 已保存
• 区域边界附近平滑边缘淡出
• 当ZoneAudio激活时，抑制原版音乐
• 音量跟随 Valheim 的音乐设置（以及区域和模组音量控制）
• 单轨区域或多轨播放列表
• 可选随机播放
• 可选的昼夜音效
• 可选生物群系与天气条件
• 重叠区域优先支持

安装

使用兼容Thunderstore的模组管理器安装，或手动将DLL放入以下位置：

BepInEx/plugins/ZoneAudio/

首次启动时，ZoneAudio 会创建：

BepInEx/config/ZoneAudio/ zones.yaml audio/

放置你的 .ogg, .wav，或 .mp3 中的文件 音频 文件夹。

基础配置

只需要填写三个字段：

区域：
- 位置：[1250, 34, -820]
  半径：20
  音频：harbor.ogg

那会创建一个音频区域，中心位于 x=1250, y=34, z=-820，半径为20米。

完整示例

区域： - 名称： 港口酒馆 位置： [1250, 34, -820] 半径： 20 音频： harbor.ogg 音量： 0.8 优先级： 100 生物群系： 草甸 天气： - 晴朗 - 小雨 仅白天： false 仅夜晚： false 循环： true 随机播放： false 边缘淡出： 10

播放列表

在下方列表中使用 音频 要排队多首曲目：

区域：
  - 名称：市场
    位置：[100, 30, -200]
    半径：35
    音频：
      - market_1.ogg
      - market_2.ogg
      - market_3.ogg
    随机播放：是
    循环：是

区域音频也接受列表字段下的简单裸条目：

音频：market_1.ogg market_2.ogg

与 随机: 是，区域音频会按随机顺序播放播放列表，在当前随机集合中的曲目全部播放完毕前不会重复。

昼夜音效

使用 日间音频 和 夜晚音效 根据一天中不同的时段播放不同的音乐：

区域：
- 名称：村庄广场
  位置：[300, 40, -500]
  半径：45
  音频：village_default.ogg
  白天音频：
  - village_day.ogg
  夜晚音频：
  - village_night.ogg

如果 每日音频 或 夜晚音效 缺失，ZoneAudio 将回退到 音频.

配置字段

需要：

• 位置：区域中心为 [x, y, z]
• 半径：区域半径（米）
• 音频：一个文件名或文件名列表

可选：

• 名称：日志中使用的标签
• 音量区域音量来自 0.0 至 1.0，默认 1.0
• 优先级区域重叠时优先级更高者生效，默认 0
• 生物群系: 只在此生物群系中游玩
• 天气：仅在列出的天气名称期间播放
• 仅限白天只在白天播放，默认 否
• 仅限夜晚：仅在夜间播放，默认 假
• 循环循环播放，默认 真
• 随机：随机播放播放列表，默认 假
• 边缘渐隐：区域边缘附近的淡出距离（米）
• 日间音频白天专用文件或播放列表
• 夜晚音效：夜间专用文件或播放列表

笔记

YAML 文件在游戏运行时实时重新加载。如果文件存在语法错误，ZoneAudio 会记录该问题，并继续使用上一次正常工作的区域列表。

音频文件加载自：

BepInEx/config/ZoneAudio/audio/

该模组可以迁移旧版 区域.json 归入 区域.yaml 如果尚不存在YAML文件。