![[BTW 插件] 音乐播放器](https://cdn8.newbeebox.com/nbbnext/2026/11/18/1000ba8c14e68ace7e47620ad6b5d8ab.png)
[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文件中为每首歌曲定义自定义显示标题。
下载
- BTW 音乐播放器模组:点击绿色的下载按钮!
- 示例音乐包(
RadogostMusicPack.zip):下载音乐包 - 源代码:在 GitHub 上浏览
需求
- 已安装 Better Than Wolves 社区版 3.0.0
模组安装
- 从下载部分下载模组的最新
.jar文件。 - 打开你的 Minecraft 目录。
- 在你的
.minecraft目录中,找到mods文件夹。 - 将下载的
btw-music-player-x.y.z.jar文件移动到mods文件夹中。 - 启动游戏。
音乐包安装
成功安装模组后,你可以添加任意数量的音乐包来自定义游戏内音乐。
- 从下载部分下载一个音乐包(例如 RadogostMusicPack.zip)。
- 导航到你的 Minecraft 主游戏目录(
.minecraft)。 - 在
.minecraft目录中,找到名为musicpacks的文件夹。如果它不存在,你必须创建它。 - 解压下载的
.zip压缩包。在里面,你会找到一个以音乐包命名的文件夹(例如RadogostMusicPack)。 - 重要:将整个文件夹(例如
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 文件和文件夹)``````
配置
你可以直接在游戏内配置模组!
- 转到选项。
- 找到音乐滑块。
- 点击滑块旁边的小齿轮图标。
此菜单允许你:
- 浏览并验证已安装的音乐包(绿色 = 有效,红色 = 文件缺失或格式无效)。
- 管理激活条件:打开歌曲条件界面以全局启用或禁用特定规则(例如关闭所有生物群系检查)。
- 在
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(默认)- 标准海平面/地下起始点。
- 描述: 指定游戏认为玩家处于“洞穴”中的 Y 坐标(高度)阈值。这影响
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 文件。
- 下载工具:BTW Music Player CSV to JSON
- 有关如何使用该工具的详细说明,请参见其仓库。
正在加载版本记录…



正在加载评论…
评论在新手盒子客户端中发表,这里同步展示。