为瓦尔海姆提供的按区域动态音乐。通过YAML为生物群系、地点、地下城和Boss定制音轨。

格利特尼尔音效

Glitnir Sounds是Glitnir项目的官方动态音乐系统。每个生物群系、地下城、领地和遭遇战都有专属配乐，将玩家的旅程化为一段沉浸式体验。

---

格利特尼尔音乐区

将 Valheim 的原声音乐替换为本地音乐，按生物群系、领地（按 XZ 坐标划分的区域）、地点（兴趣点/地下城）、Boss 和主菜单分类整理。全部通过 YAML 配置，支持自动重载，无需重启游戏。

客户端模组 — 无需安装在专用服务器上。

---

依赖项

• BepInEx 5
• YamlDotNet

---

安装

1. 安装上述依赖项
2. 放置 格林尼尔音乐区域.dll 嗯 BepInEx/plugins/
3. 启动游戏一次——默认配置将自动创建于：

   BepInEx/config/glitnir.musiczones/music_config.yaml
   

4. 把你的音乐文件放到：

   BepInEx/config/glitnir.musiczones/music/
   

5. 使用文件名编辑 YAML 并保存 — 游戏打开时配置会自动重新加载

---

支持的音频格式

.mp3 .ogg .wav

---

配置

文件 音乐配置.yaml 分为六个部分。所有部分都有一个字段 已启用 全局 — setar 已禁用：否 在根节点上停用整个区段，无需移除各个条目。

领域 音量 接受以下值 0.0 a 1.0 它乘以游戏设置中的音乐滑块值，因此滑块仍然可以正常且实时地工作。

---

性能

性能：预加载所有片段：false 最大缓存片段数：5 在以下秒数后卸载未使用片段：600

营地	描述
预加载所有剪辑	假 仅在进入区域时加载，自动释放（默认）。 真 = 启动时预加载所有内容
最大缓存片段数	同时保留在内存中的最大音乐数量（按需模式）
未使用资源卸载延迟秒数	从记忆中卸载片段前的未使用时长

默认模式（预加载所有片段：否)，玩家从未访问过的音乐不会占用内存。达到上限时，LRU缓存会自动卸载最少使用的片段。

---

主菜单

菜单： 启用： true 音量： 0.6000 音效： "menu.mp3"

如果 已启用：否 哦 片段 如果为空，菜单的原版音乐将正常播放。

---

生物群系

生物群系：
  已启用：是
  音量：0.6000
  音轨：
    草地：
      已启用：是
      模式：自定义
      音频片段："pradaria.mp3"
    黑森林：
      已启用：是
      模式：原版
      音频片段：""

可用生物群落： 草甸, 黑森林, 沼泽, 山, 平原, 迷雾之地, 灰烬之地, 北境深处, 海洋

模式（模式）：

勇气	行为
自定义	点击 片段 已配置，静音原版音乐
原版	让游戏的原始音乐正常播放
静音	完全静音——模组和原版都不播放

---

地点

兴趣点 区域系统 （地下城、神庙等）。检测是通过与地点生成点的距离来进行的。

位置：启用：是 音量：0.6000 半径：90.0 地牢Y最小值：4500.0 地牢Y最大值：5500.0 音轨：- 启用：是 位置：Crypt3 半径：90.0 仅地牢：是 地牢Y最小值：4500 地牢Y最大值：5500 音频片段："dungeon.mp3"

入场字段：

营地	描述
位置	内部位置名称（例如： Crypt3, 开始神殿, 黑森林商人)
半径	探测范围（米）。 0 使用该节的全局值
仅限地下城	如果您的“Se”是西班牙语单词“Se”，常见翻译为“自己”或“得知”。但仅凭这一个词无法确定准确含义，请提供更多上下文。 真，仅在玩家处于配置的 Y 范围内时激活
地牢Y坐标下限 / 地牢_y_上限	定义“地牢内部”的海拔范围。 -1 使用全局值

---

领地

由XZ坐标定义的圆形区域。适用于城市、王国和服务器特殊区域。

领地：
  启用：true
  曲目：
    - 启用：true
      名称：Skjalfhame
      x：-37714.0
      z：9799.0
      半径：100.0
      音量：0.6000
      模式：custom
      片段："vila.mp3"

每项字段：

营地	描述
名称	标识名称（进入区域时显示在日志中）
x / z	区域中心坐标
半径	半径（米）
音量	此条目的特定音量
模式	自定义, 原版 哦 静音

---

首领

当首领在配置范围内存活时触发。优先级高于所有其他区域。

首领：启用：是 音量：0.6000 半径：120.0 曲目：赤血灵鹿：启用：是 音频："boss.mp3" brutoGLIT：启用：是 音频："boss_custom.mp3"

条目名称必须为 预制体名称 打首领 （克隆）. 原版Boss： 鹿角神, 国王, 骨肉团, 龙, 哥布林国王, 寻踪女王, 渐变器其他模组的自定义Boss也支持通过预制体名称来兼容。

---

播放优先级

当多个区域重叠时，优先级顺序为：

首领 > 地点 > 领地 > 生物群系

离开高优先级区域时，音乐会自动返回较低优先级的活动区域。

---

热重载

任何保存的更改将在 音乐配置.yaml 自动检测，配置无需重启游戏即可重新加载。在按需模式下，从 YAML 中移除的片段会立即从内存中卸载。新片段会在进入相应区域时加载。

---

文件夹结构

BepInEx/ ├── plugins/ │ └── GlitnirMusicZones.dll └── config/ └── glitnir.musiczones/ ├── 音乐配置.yaml └── 音乐/ ├── pradaria.mp3 ├── boss.mp3 └── ...

---

笔记

• 游戏设置中的音乐音量滑块会实时影响模组中的所有音乐
• 带以下内容的文件名 .. 或路径分隔符因安全原因被拒绝
• 每首加载的音乐根据时长占用3–15 MB内存
• 纯客户端模组 — 没有任何数据通过网络同步