环境音乐补充

Ambient Music Additions 允许以可配置的权重将自定义 .ogg 曲目添加到原版音乐轮换中，并额外支持将音乐划分为不同类别。音乐可以在特定的结构和生物群系中播放，包括模组添加的结构和生物群系。

----------------------------------------------

更新：1.1：

新增了 timeRanges 参数。minTime 和 MaxTime 是曲目可以播放的时间值，而 label 仅用于在游戏中使用 info 命令时显示。

label 有几个可选值：

day

night

dawn

dusk

noon

midnight

"timeRanges": [
  {
    "label": "night",
    "minTime": 12000,
    "maxTime": 24000
  }
]

以下是包含 timeRanges 的完整条目示例：

{
  "soundId": "ambient_music_generator:lost_maze",
  "replaceProbability": 1.0,
  "weight": 10,
  "biomes": [
    "minecraft:swamp"
  ],
  "structures": [],
  "category": "overworld",
  "timeRanges": [
    {
      "label": "night",
      "minTime": 12000,
      "maxTime": 24000
    }
  ]
}

----------------------------------------------

该模组默认会创建一个名为 "Ambient Music Generator" 的资源包文件夹。需要启用该资源包，一切才能正常运作。

该资源包的 music 文件夹内是放置你要添加的 .ogg 文件的位置。sounds 文件夹内是 sounds.json。

{
  "example_track": {
    "sounds": [
      {
        "name": "ambient_music_generator:music/example_track",
        "stream": true
      }
    ],
    "subtitle": "subtitles.ambient_music_generator.example_track"
  }
}

music 文件夹中的每个 ogg 文件都应像这样列在 sounds.json 文件夹中。subtitle 字段不是必需的。重要的是将 "example_track" 替换为你的 .ogg 文件的确切名称（不带扩展名）。也就是说，如果我想添加一个名为 forest_creatures.ogg 的曲目，条目将如下所示：

{
  "forest_creatures": {
    "sounds": [
      {
        "name": "ambient_music_generator:music/forest_creatures",
        "stream": true
      }
    ],
    "subtitle": "subtitles.ambient_music_generator.forest_creatures"
  }
}

配置好 sounds.json 后，模组配置文件夹中还有另一个配置文件：ambient-music-generator.json。

该文件中的条目如下所示：

{
  "customTracks": [
    {
      "soundId": "ambient_music_generator:far_fields",
      "replaceProbability": 1.0,
      "weight": 10,
      "biomes": [
        "minecraft:jungle"
      ],
      "structures": [],
      "category": "overworld"
    }
  ]
}

• SOUND ID 与 sounds.json 中使用的 id 相同。

• Replace Probability 决定歌曲代替原版曲目播放的频率，1.0 表示该曲目将始终替换任何原版选项。

• category 选项允许你将曲目放入某个类别。同一类别中的曲目将根据各自的权重播放，权重越高，该类别中的某首曲目被播放的可能性就越大。如果游戏选择播放自定义曲目而不是原版曲目，它将随机选择一个类别来播放音乐。

• 最后，biome 和 structure 列表允许你配置音乐应在哪些生物群系/结构中播放。

注意：由于结构检测是服务端进行的，因此在多人游戏中，此模组必须在客户端和服务端上都安装才能正常运作。

该模组还添加了一些实用命令：

/ambientmusic info：显示当前播放曲目的信息、已加载的自定义曲目数量、当前所在的结构/生物群系，以及在你当前情况下可以播放哪些自定义曲目。

/ambientmusic skip：立即跳到下一首音乐曲目。该命令同样适用于任何原版曲目，并能与游戏设置中的音乐频率选项正确配合。

/ambientmusic reload：重新加载 sounds.json 和 ambient-music-generation.json。

请将游玩过程中出现的任何 bug 告知我。此模组旨在作为一个实用的整合包工具，我欢迎在任何整合包中使用它。