Mazzle的音乐中心

Mazzle 的音乐中心（Music Hub）让您能将新音乐带入《博德之门 3》，并使其可用于兼容的游戏内音乐模组。

通过音乐中心，您可以：

• 从硬盘添加 MP3 或 MP4 文件
• 通过 YouTube URL 下载歌曲
• 从下面列出的一个包含的播放列表中下载大型音乐合集
• 将转换后的音乐导入 BG3
• 将歌曲分配到电台并设置其播放顺序

此系统的游戏内部分是 Mazzle 的 MF Radio 模组。音乐中心是准备和导入音频的外部工具；MF Radio 是让您能在游戏内使用导入歌曲的 BG3 模组。

这两个模组均不包含任何音乐文件。

包含的可下载播放列表

音乐中心包含预配置的播放列表文件，用于下载歌曲合集。可用的播放列表有：

博德之门 1                            博德之门 2                            侠盗猎车手电台
冰风谷                               星际穿越豪华原声带                    指环王：护戒使者
指环王：王者无敌                      指环王：双塔奇兵                       Mazzle 探险者通行证推荐音乐
无冬之夜                             邮差1 原声带                         邮差2 原声带
星球大战前传I：幽灵的威胁             星球大战前传II：克隆人的进攻           星球大战前传III：西斯的复仇
星球大战IV：新希望                    星球大战V：帝国反击战                 星球大战VI：绝地归来
星球大战VII：原力觉醒                 星球大战VIII：最后的绝地武士           星球大战IX：天行者崛起
星球大战外传：侠盗一号                 星球大战外传：游侠索罗                  霍比特人：意外之旅
霍比特人：五军之战                    霍比特人：史矛革之战                   巫师 1
巫师 2：国王刺客                      巫师 3：血与酒                        巫师 3：石之心
巫师 3：狂猎                          王权的陨落：巫师 Tales

它是如何工作的？

BG3 无法直接通过此系统使用常规的 MP3 或 MP4 文件。音乐中心会将您的音乐转换为 WEM 文件，这是 BG3 可以播放的声音文件。当您点击 导入到 BG3 时，音乐中心会将转换后的 WEM 文件和歌曲/播放列表信息复制到它创建的 Mazzle_Music_Hub BG3 模组中。

安装

(1) 下载 Mazzle 的音乐中心和 Mazzle 的 MF Radio

这里有两个部分：

• Mazzle 的音乐中心 - 您在 BG3 之外运行的外部应用程序，用于下载、转换、组织和导入音乐。
• Mazzle 的 MF Radio - 在游戏内播放或使用导入音乐的游戏模组。

(2) 安装音乐中心应用程序

将音乐中心文件夹放在硬盘上任何方便的位置。您可以通过双击脚本或从命令行启动它来运行。

该应用程序会将其下载、转换的 WEM、播放列表、设置和辅助工具放在自己的文件夹结构中。请选择一个有足够空间容纳您想添加的音乐量的驱动器。

(3) 运行一次音乐中心并完成设置

首次运行时，音乐中心将启动安装向导并检查它所需的工具。在您确认设置提示后，缺失的依赖项将自动安装。

音乐中心需要并在未安装时安装以下工具：

• yt-dlp，用于下载 YouTube 音频/视频。
• ffmpeg/ffprobe/ffplay，用于提取、修剪、转换准备和预览播放。
• zSound2wem，用于将音频转换为 WEM 文件。
• vgmstream-cli，用于预览转换后的 WEM 文件。
• WwiseConsole.exe，WEM 转换链所必需。如果音乐中心找不到它，您可能需要将音乐中心指向您的 Wwise Authoring 安装。
• 一些提供更好 GUI 和拖放支持的 Python 库。

请注意，安装程序无法为您安装 wwise，这是一种用于处理 WEM 文件的工具，WEM 是 BG3 用于声音的专有格式。没有开源替代品，并且制作它的公司要求人们在其网站上登录才能下载他们的工具。这是整个过程中最烦人的一步。（请注意，它会启动您可以从中下载 Wwise 的网站。）

(4) 在您的模组管理器中启用 Mazzle_Music_Hub 和 MF Radio

音乐中心在设置期间会创建一个名为 Mazzle_Music_Hub 的模组，这是一个最小的模组，用作您转换音乐的资源库。您必须首先在 BG3MM 加载顺序中启用它，然后才能启动 BG3，以确保一切正常。

• 如果您也安装 MF Radio 模组，现在也是启用它的好时机。像通常安装 BG3 模组一样安装游戏内模组。例如，在 BG3MM 中，将其放入已启用的窗格，导出加载顺序，然后启动游戏。
• 加载顺序对这两个模组都不重要。您可以随时安装或移除这些模组，不会有问题。

使用 Mazzle 的音乐中心

TLDR 说明

1. 运行音乐中心
2. 添加/下载歌曲
3. 如需要，编辑电台/设置
4. 点击“转换”
5. 点击“导入到 BG3”
6. 在游戏中使用 MF Radio。

如果游戏已启动，请点击“重新加载播放列表”按钮。

详细说明

(1) 将音乐添加到源音乐列表

您有几种选择：

• 将 MP3/MP4 文件 拖放到“添加歌曲”放置区域。
• 通过点击 从 Youtube 下载 并输入 URL 来 从 YouTube 下载。
• 通过点击按钮并选择包含的播放列表文件之一来 从播放列表下载。您也可以从磁盘中选择播放列表文件。

下载和拖放的文件会出现在 源音乐 列表中。此列表是您的转换队列。源文件不会仅仅因为您转换它们而被移除，因此您可以更改设置并在不满意结果时重新转换。

(2) 如需要，编辑转换设置

双击源条目或右键单击并选择 编辑。

您可以编辑：

• 歌曲标题
• 电台成员资格
• 自定义电台名称
• 修剪静音
• 修剪开头
• 修剪结尾
• 歌曲开始偏移
• 分块

修剪静音提示： 请务必仔细检查结果。自动静音检测有时可能会修剪掉不仅仅是静音的部分。

歌曲开始偏移： 这允许您在更有趣的时刻开始歌曲。音乐中心首先修剪音频，在请求的时间点分割歌曲，然后将后面的部分移到前面的部分之前。

分块： 这对于非常长的音乐文件非常有用，例如电台上传。如果您输入 5，音乐中心会在转换期间将编辑后的歌曲分割成大约五分钟的 WEM 曲目。

(3) 预览源音频

选择一个源条目并点击 播放所选 来预览源文件。这可以帮助您确定在转换时是否要使用任何编辑设置。

(4) 转换音乐

选择一个或多个源条目并点击 转换。

音乐中心会应用您的编辑设置并将结果转换为一个或多个 WEM 文件。转换后的条目会出现在 已转换 / 已安装歌曲 部分。

(5) 检查转换后的歌曲

在转换部分，您可以：

• 预览转换后的 WEM 文件。
• 编辑歌曲标题或电台成员资格。
• 删除转换后的条目。
• 按电台筛选。
• 查看每首歌曲是否已导入 BG3。

如果转换后的歌曲听起来不对，请编辑源条目的转换设置并再次点击 转换。

(6) 设置电台播放顺序

使用转换部分的电台下拉菜单选择电台。上下拖动歌曲以设置该电台的顺序，然后点击 更新电台歌曲顺序。

全部 视图也可以排序。它控制动态“全部歌曲”类别使用的顺序。

(7) 导入到 BG3

点击 导入到 BG3。

(8) 在游戏中使用音乐

如果您在启用 Mazzle 的 MF Radio 的情况下启动 BG3，音乐将可用。一旦音乐中心资源库对游戏可用，导入的歌曲更改可以实时获取。您可能需要在游戏内使用刷新选项。

卸载

要从 BG3 中移除音乐中心，请删除音乐中心的松散资源库文件夹：

• Baldurs Gate 3\Data\Mods\Mazzle_Music_Hub
• Baldurs Gate 3\Data\Public\Mazzle_Music_Hub

之后请务必再次保存您的加载顺序。如果您不再需要下载器/转换器，您也可以删除外部音乐中心应用程序文件夹。

提示与故障排除

首次设置提示

• Wwise 是最可能需要手动注意的依赖项。如果音乐中心找不到 WwiseConsole.exe，请在“设置”中将其指向您的 Wwise Authoring 安装。
• 在下载大型播放列表之前，先从一两首歌曲开始。长文件可能需要一段时间才能下载和转换。

下载/转换提示

• 如果下载失败，请尝试从“设置”选项卡更新 yt-dlp。该软件包的作者建议至少每 60 天更新一次。
• 如果转换结果听起来不对，请编辑源设置并再次转换。源条目可用于此工作流程，新的转换将自动替换旧的。
• 如果歌曲已转换但在游戏中不可见，请再次点击 导入到 BG3 并在游戏内刷新。另外，请确保在启动 BG3 之前，Music Hub 模组已存在并在 BG3MM 中启用。

鸣谢

• 非常感谢 Focus 向我介绍了 PlayExternalSound 的用法，感谢 wtfbengt 指出了我未注意到且急需的 PES 中的 seek 参数，感谢 Norbyte 提供了 SE 并添加了 PES。
• 感谢帮助测试此模组的人员：wtfbengt、moxi、Rakor 和 For_Kiramay。
• 当然，如果没有 yt-dlp、ffmpeg、zSound2wem、Wwise 和 vgmstream 作者的努力，这个模组也无法运作。

我的其他模组

游戏工具

• EZ-Manipulator（用于移动、缩放、旋转角色、物品和场景的小工具）
• Fricken FreeCam（自由移动摄像机）
• MF Radio（可播放原生和下载音乐的游戏内电台）
• RangeFinder（可视化移动范围和攻击，规划/自动化移动）
• Tav's Journal（创建带有照片的游戏内日记，导出和分享）
• Tav's Clock（一个可以放在任何地方的小时钟和会话计时器）

生活质量

• EZ-Undo（撤销您本回合所做的所有移动）
• Group Climbing Fix（允许多个角色同时攀爬梯子）
• Level Directory（允许您传送至任何关卡或已安装的自定义关卡，而不会扰乱故事进度）
• M&M Group Climbing Fix（Mac 兼容模组，允许多个角色同时攀爬梯子。）
• No More Mod warning（抑制模组冲突警告）

库和外部工具

• MazzleDocs（用于显示精美游戏内文档、教程或完整模组 GUI 的库）
• MazzleLib（我的其他模组的核心库）
• My Assistant Ken（帮助其他模组与 Noesis 交互的库）
• Oops All Characters (with Simple NPC/Enemy Spawner)（允许您在任何关卡生成大多数角色）
• Photo Hub（外部工具和模组，允许模组访问您的截图和图像）
• Music Hub（下载和转换音乐，并使其可用于 BG3）

为模组作者提供的模组

• Court of Intense Judgment Outfit Reviewer（生成角色，让服装模组作者能在所有体型上查看服装）
• Image Importer（用于将图像导入模组的模组制作实用程序）
• KnowEasier Noesis Debugger（用于检查 BG3 原生 GUI 的模组制作实用程序）

支持此模组

如果您觉得这很有用，请考虑进行捐赠。

另外，如果您喜欢此模组，请查看我的另一个模组 RangeFinder。它值得您花费时间学习曲线！