[BTW 插件] 音乐播放器

[BTW 插件] 音乐播放器

为Better Than Wolves CE打造的动态音乐引擎。创建自定义音乐包,根据维度、生物群系、一天中的时间、战斗、Boss战等情境播放音乐。

游戏机制

BTW 音乐播放器

BTW 音乐播放器是一个动态音乐引擎,作为 Minecraft 1.6.4 的 Better Than Wolves 社区版 3.0.0 模组的外挂附加组件而创建。它替换了标准且重复的游戏内音乐,允许根据游戏情境播放自定义曲目。

玩家可以创建并安装自己的“音乐包”,其中包含音乐文件和定义每首曲目播放时机的 songs.json 文件。该模组具有歌曲间的平滑过渡,并能智能管理战斗音乐,对玩家和怪物的动作做出反应。

功能特性

  • 完全音乐自定义:用你自己的 .ogg 文件替换整个游戏的配乐。
  • 智能播放列表逻辑:曲目在启动时全局打乱(如同一副牌)。模组确保特定情境下的每首歌曲在循环前至少播放一次。即使你离开并返回某个区域,播放状态也会被记住,从而防止音乐重复,并确保你听到整个曲库。
  • 平滑过渡:情境变化时音乐轻柔地淡入淡出,消除突兀的切断。
  • 智能战斗系统:战斗音乐不仅在玩家被攻击时触发,在玩家发起战斗时也会触发。只要附近存在威胁,系统就会持续播放战斗主题。
  • 情境感知播放:基于广泛的条件定义音乐播放规则:
    • 维度:主世界、下界、末地。
    • 一天中的时间:白天或夜晚。
    • 生物群系:游戏中的任何生物群系(例如森林、沙漠、针叶林)。
    • 天气:晴朗或暴风雨。
    • 位置:在地面和洞穴中播放不同的音乐。
    • 战斗:与怪物、狼或鱿鱼遭遇时的专用音乐。
    • Boss 战:与末影龙和凋灵战斗时的独特曲目。
    • 胜利:击败 Boss 后播放特殊主题。
    • 菜单音乐:定义在主菜单、世界选择界面以及游戏世界之外的选项界面中播放的曲目。
    • 低生命值叠加:当玩家生命值降至 5 颗心或以下时,心跳音效(或任何其他声音)与背景音乐同时播放。
  • 智能生物群系逻辑:生物群系变种(例如森林丘陵、沙漠丘陵)会自动视作其主要生物群系,简化配置。
  • 无缝旅行:河流和沙滩被认为是“透明的”。穿越河流时,之前生物群系(例如森林)的音乐会继续播放,防止音乐频繁切换。
  • 高级验证器:模组会检查你的 .ogg 文件是否存在且有效,并在音乐包选择菜单中直接报告错误。
  • 多音乐包支持:从单个特定音乐包或同时从所有已安装的音乐包中加载曲目。
  • 游戏内配置:通过新的齿轮图标,可直接从游戏选项菜单管理设置、选择音乐包并打开音乐文件夹。
  • 全局条件开关:直接从游戏内配置菜单启用或禁用特定条件(例如禁用所有生物群系音乐或战斗音乐)。
  • 诊断命令:使用 /bmp debug 实时查看当前音乐状态(生物群系、战斗、歌曲优先级),使用 /bmp reload 在不重启游戏的情况下重新加载配置和音乐包。
  • 正在播放通知:新歌曲开始时,屏幕右侧会出现一个时尚的弹窗,显示曲目标题和音乐包名称。
  • 自定义歌曲标题:你现在可以在 songs.json 文件中为每首歌曲定义自定义显示标题。

下载

需求

  • 已安装 Better Than Wolves 社区版 3.0.0

模组安装

  1. 从下载部分下载模组的最新 .jar 文件。
  2. 打开你的 Minecraft 目录。
  3. 在你的 .minecraft 目录中,找到 mods 文件夹。
  4. 将下载的 btw-music-player-x.y.z.jar 文件移动到 mods 文件夹中。
  5. 启动游戏。

音乐包安装

成功安装模组后,你可以添加任意数量的音乐包来自定义游戏内音乐。

  1. 从下载部分下载一个音乐包(例如 RadogostMusicPack.zip)。
  2. 导航到你的 Minecraft 主游戏目录(.minecraft)。
  3. 在 .minecraft 目录中,找到名为 musicpacks 的文件夹。如果它不存在,你必须创建它。
  4. 解压下载的 .zip 压缩包。在里面,你会找到一个以音乐包命名的文件夹(例如 RadogostMusicPack)。
  5. 重要:将整个文件夹(例如 RadogostMusicPack)移动到 musicpacks 目录中。不要直接复制单个 .ogg 文件或 songs.json 文件。

重启游戏后,音乐包将根据配置文件中的设置自动加载。

文件夹结构示例

这是安装模组和两个示例音乐包(RadogostMusicPack 和 AnotherCoolMusicPack)后,你的文件结构应该看起来的样子:

.minecraft/
├── mods/
│   ├── btwce-3.0.x.jar
│   └── btw-music-player-x.y.z.jar
│
├── musicpacks/
│   ├── RadogostMusicPack/
│   │   ├── songs.json
│   │   ├── day/
│   │   │   └── kam_01_spirit.ogg
│   │   └── combat/
│   │       └── witcher_52_monster_battle.ogg
│   │
│   └── AnotherCoolMusicPack/
│       ├── songs.json
│       └── ... (音乐文件)
│
└── ... (其他 minecraft 文件和文件夹)``````

配置

你可以直接在游戏内配置模组!

  1. 转到选项。
  2. 找到音乐滑块。
  3. 点击滑块旁边的小齿轮图标。

此菜单允许你:

  • 浏览并验证已安装的音乐包(绿色 = 有效,红色 = 文件缺失或格式无效)。
  • 管理激活条件:打开歌曲条件界面以全局启用或禁用特定规则(例如关闭所有生物群系检查)。
  • 在 ALL(加载所有包)和 SINGLE(加载一个特定包)模式之间切换。
  • 调整情境延迟、交叉淡化(淡化持续时间)和洞穴深度滑块。
  • 切换调试日志记录。
  • 使用打开文件夹按钮快速在电脑上打开 musicpacks 文件夹。

或者,你可以手动编辑位于 .minecraft/config/btw-music-player.cfg 的配置文件。

可用选项

  • musicpack_loading_mode
    • 描述: 决定模组应如何加载音乐包。
    • 值:
      • ALL(默认)- 模组从 musicpacks 文件夹中找到的所有音乐包加载音乐。
      • SINGLE - 模组仅从一个特定的音乐包加载音乐。
    • 示例: 要仅使用一个音乐包,请将此值更改为 SINGLE。
  • single_musicpack_name
    • 描述: 当 musicpack_loading_mode 设置为 SINGLE 时要激活的音乐包名称。
    • 值: 音乐包文件夹的准确名称(例如 RadogostMusicPack)。区分大小写。
    • 示例: single_musicpack_name=RadogostMusicPack
  • enable_debug_logging
    • 描述: 启用或禁用游戏控制台中的详细模组消息。这对于诊断问题或创建自己的音乐包时很有用。
    • 值:
      • false(默认)- 日志记录已禁用。
      • true - 日志记录已启用。
  • context_change_delay_seconds
    • 描述: 设置游戏情境(例如生物群系、进入洞穴)改变后,音乐更改之前必须经过的延迟(以秒为单位)。这可以防止在区域之间移动时出现烦人的快速音乐切换。高优先级音乐(战斗、Boss 战)将始终立即播放,忽略此延迟。
    • 值:
      • 7(默认)- 新情境稳定 7 秒后音乐将更改。
      • 0 - 音乐更改立即生效。
  • fade_duration_ms
    • 描述: 设置音乐更改时交叉淡化效果的持续时间(以毫秒为单位)。
    • 值:
      • 1000(默认)- 1 秒淡化。
      • 0 - 立即切断,无淡化。
  • cave_y_level
    • 描述: 指定游戏认为玩家处于“洞穴”中的 Y 坐标(高度)阈值。这影响 is_in_cave 条件。
    • 值:
      • 60(默认)- 标准海平面/地下起始点。
  • show_notifications
    • 描述: 决定音乐更改时是否应显示“正在播放”弹窗。
    • 值: true(默认)、false。

创建你自己的音乐包

任何人都可以创建自己的音乐包!该过程包括以 .ogg 格式准备音乐文件,并在名为 songs.json 的特殊文件中定义播放规则。

0. 重要提示:音量标准化

在开始之前,我们强烈建议对所有曲目进行音量标准化。这将防止出现一首曲目太安静而下一首太响亮的情况,迫使你不断调整游戏内的音乐滑块。

你可以使用像 Audacity 这样的免费程序来完成此操作。对于我的音乐包,我使用了“标准化”效果,将感知响度设置为 -22 LUFS。此步骤可确保专业且一致的聆听体验。

1. 文件夹结构

首先,为你的音乐包创建一个主文件夹,例如 MyFirstMusicPack。在其中,你必须放置 songs.json 文件。你可以将音乐文件放在其旁边,或者为了更好地组织,将它们分组到子文件夹中(例如 music、combat、boss)。

musicpacks/
  └── MyFirstMusicPack/
      ├── songs.json
      ├── ambient/
      │   ├── day_forest.ogg
      │   └── night_plains.ogg
      └── combat/
          └── regular_fight.ogg

2. songs.json 文件

这是你音乐包的核心。它是一个文本文件,包含一系列“规则”,告诉模组何时播放特定曲目。每条规则由四部分组成:

  • file:音乐文件的路径。
  • title(可选):通知中显示的歌曲显示名称。
  • priority:一个决定曲目重要程度的数字。
  • conditions:必须满足的一组条件,曲目才会被播放。

以下是一个包含两条规则的示例 songs.json 文件:

[
  {
    "file": "ambient/day_forest.ogg",
    "title": "Spirit of the Woods",
    "priority": 10,
    "conditions": {
      "dimension": "overworld",
      "time_of_day": "day",
      "biome": "forest"
    }
  },
  {
    "file": "combat/regular_fight.ogg",
    "priority": 100,
    "conditions": {
      "is_in_combat": true
    }
  }
]

3. 优先级

如果同时满足多条规则的条件,优先级决定哪个播放列表优先。优先级数字最高的规则获胜。

示例: 你在白天的森林中(匹配 priority: 10 的规则),但一只僵尸突然攻击你(同时匹配 priority: 100 的战斗规则)。由于 100 大于 10,音乐将立即切换到战斗曲目。 提示: 对一般背景音乐(生物群系、一天中的时间)使用低优先级(例如 1-20),对战斗、Boss 战或胜利主题等特殊事件使用高优先级(例如 100+)。

4. 可用条件

下表列出了你可以在 conditions 部分中用于定义规则的所有条件。

条件键 接受的值 描述
dimension overworld, the_nether, the_end 指定玩家必须所处的维度。
biome ocean, plains, desert, extreme_hills, forest, taiga, swampland, hell, sky, frozenocean, ice_plains, ice_mountains, mushroomisland, jungle 指定生物群系。注意:丘陵(例如 forest_hills)、边缘和海岸会自动映射到其父生物群系(使用 forest、desert 等)。河流和沙滩会被忽略以保持之前的曲目,无法直接作为目标。
time_of_day day, night 指定游戏中的当前时间。
weather clear, storm 检查天气是平静还是暴风雨。
is_in_cave true, false 检查玩家是否低于配置的 Y 水平(默认:60)。
is_in_combat true, false 检查玩家当前是否在战斗中。
boss_type wither, ender_dragon 检查附近是否有特定的 Boss
victory_after_boss true 一个特殊条件,在击败 Boss 后的短时间内为真。
is_menu true 检查玩家是否在主菜单或活动世界之外的任何界面(例如世界选择)。
is_low_health true, false 检查玩家是否拥有 5 颗心(10 点生命值)或更少。此轨作为当前音乐之上的叠加播放。

5. 提示与工具

  • 文件格式:确保所有音乐文件均为 .ogg 格式。
  • 使用诊断:你可以使用游戏内命令 /bmp debug 查看特定歌曲播放(或不播放)的确切原因。它会显示当前生物群系、战斗状态和活动歌曲优先级。
  • 使用日志:如需更深入的分析,请在配置中启用 enable_debug_logging=true。游戏控制台将显示模组尝试执行的操作的详细跟踪信息。
  • JSON 验证器:如果游戏无法加载你的音乐包,请确保你的 songs.json 文件没有语法错误。你可以将其内容粘贴到在线 JSON 验证器中进行检查。
  • 管理大型音乐包(CSV 转 JSON): 如果你计划添加数十或数百首曲目,手动编辑 songs.json 文件会变得繁琐。在这种情况下,你可以准备一个简单的电子表格,列顺序如下: file,priority,dimension,biome,time_of_day,is_in_combat,weather,is_in_cave,boss_type,victory_after_boss,is_menu,is_low_health

将电子表格保存为 .csv 文件,然后使用我的辅助工具,它会自动将其转换为可直接使用的 songs.json 文件。