影之刃零 - 自定义背景音乐

影之刃零 - 自定义背景音乐

Mute unwanted BGM with an editable blacklist, replace it with your own music, or replace all BGM. Chinese/English in-game settings. Requires PBZModLoader. 通过可编辑黑名单静音不喜欢的BGM,用自己的音乐替换黑名单或全部BGM;游戏内中英双语设置。需要 PBZModLoader。

下载审核状态 / Download review status 主安装包目前被 Nexus 自动隔离,下载正在等待人工审核。源码会作为单独的可选文件提供,供审核与自行构建;它不包含可运行的辅助程序。 The main package is currently quarantined by Nexus and unavailable for download pending manual review. A separate optional source archive is provided for review and building; it does not contain the runnable helpers.

Phantom Blade Zero - Custom Background Music

中文说明在前 / English below · 0.1.11 alpha

中文说明

不喜欢某些一直循环的背景音乐?在游戏“设置 → 声音”中查看当前音乐,一键加入黑名单,选择静音或使用自己的音乐替换。也可以开启“替换所有BGM”。界面支持简体中文和英文。

主要功能

  • 显示当前活动音乐的内部事件名称,一键拉黑,并在黑名单页删除条目。
  • 静音黑名单BGM;使用自定义音乐替换静音黑名单BGM。
  • 替换所有BGM:替换已识别到的活动音乐;开启后另外两个黑名单开关禁用,关闭后恢复之前的值。
  • 单曲循环、顺序循环、每轮不重复的随机播放,以及上一首、下一首和独立音量。
  • 游戏内打开音乐文件夹、重新扫描,显示操作反馈与曲目数量。

安装(必需 PBZModLoader)

推荐使用 Phantom Blade Zero - Mod Manager 安装与管理模组。关闭游戏后,先通过管理器安装 PBZModLoader,再把本模组 ZIP 拖入管理器,核对文件并启用。

本模组实测基于 PBZModLoader Kintaro 分支 2.1.0(game-api 0.3.3)。PBZModLoader 原始项目见 Nexus 页面;其他加载器版本尚未验证。没有加载器,仅复制本模组文件不会加载。无需 UE4SS 或 Mods Menu。

手动安装:退出游戏,将 ZIP 内的 ProjectPBZ 文件夹合并到游戏根目录。不要只复制 JS,包内两个辅助程序也需要保留。

使用

  1. 进入“设置 → 声音 → 自定义BGM mod”,打开“音乐黑名单与自定义音乐”右侧的“编辑”。
  2. 用“设置页面”切换当前音乐、黑名单、播放器;在目标音乐播放时一键拉黑。
  3. 在播放器页打开自定义音乐文件夹,放入自己的 MP3/WAV,点击重新扫描,再选择曲目、模式和音量。若文件夹留在后台,该行会提示按 Alt+Tab。

音乐目录:ProjectPBZ/Content/Mods/PBZBGM/Music。只扫描第一层,最多 2000 首;WMA/M4A/AAC/FLAC 是否可播取决于音频后端和 Windows 解码器。没有附带任何音乐。

音乐匹配与兼容性

黑名单按音乐事件匹配,不依赖地图或探索、Boss、剧情等场景标签。未拉黑的音乐保留;主动拉黑 Boss/剧情事件或启用“替换所有BGM”时,这些音乐也会被处理。同一个事件内部的动态片段不能分别拉黑,内部事件名也不保证是 OST 曲名。

黑名单替换模式中,切到未列入名单的音乐或音乐停止时,自定义播放停止;命中黑名单的音乐回来后从头开始。

兼容音频由模组自动启动,随实际游戏进程退出;关闭替换或卸载模组时也会退出,不需要手动打开播放器。兼容输出使用 Windows .NET Framework 4.x / WPF。

当前为 alpha,实测基于 Steam CL-302256_JKS-17280;其他游戏构建未验证。44 项离线回归通过,实际播放、文件夹及扫描已验证;离线检查不代表所有音乐格式和场景都已覆盖。

更新、卸载与问题反馈

更新前退出游戏,保留自己的 Music 和配置。配置通常位于 %LOCALAPPDATA%/ProjectPBZ/Saved/PBZBGM-settings.json。

卸载时关闭游戏,备份音乐,再用管理器移除本模组,或手动移走 ProjectPBZ/PBZModLoader/mods/PBZBGM 与 ProjectPBZ/Content/Mods/PBZBGM。不要删除共享加载器或其他模组。

反馈时请说明游戏/加载器版本、复现步骤及相关 [PBZBGM] 日志。日志:ProjectPBZ/PBZModLoader/loader.log;上传日志前请检查个人路径等信息。


English

Mute unwanted looping background music or replace it with your own playlist, directly from Settings → Audio. See the active music event, add it to an editable blacklist, or enable Replace all BGM. Includes English and Simplified Chinese UI.

Features

  • Now-playing event display, one-click blacklisting and editable blacklist.
  • Mute listed BGM, replace muted blacklist BGM with custom music, or replace every identified active BGM layer.
  • Replace all BGM disables the two blacklist-only switches while preserving their saved values.
  • Selected-track repeat, sequential repeat, shuffle without repeats per cycle, previous/next and independent volume.
  • Open the music folder and rescan in-game, with progress and result feedback.

Requirements and installation

PBZModLoader is REQUIRED. Tested with Kintaro's PBZModLoader 2.1.0, game-api 0.3.3. The original loader's Nexus page is linked for reference; other loader builds have not been verified. UE4SS and Mods Menu are not required.

Recommended: use Phantom Blade Zero - Mod Manager. Close the game, install PBZModLoader through the manager first, then drop this mod's ZIP onto the manager, review its files and enable it.

Manual installation: close the game and merge ProjectPBZ from the ZIP into the game root. Keep both bundled helpers as well as the JS files. Copying this mod alone does not install PBZModLoader.

Getting started

Open Settings → Audio → Custom BGM mod → Edit. Settings page cycles through Now playing, Blacklist and Player. Add an unwanted event while it is playing. Open the music folder, add your own MP3/WAV files, rescan and choose your track, order and volume.

Music folder: ProjectPBZ/Content/Mods/PBZBGM/Music. Only the top level is scanned, up to 2,000 tracks. WMA/M4A/AAC/FLAC support depends on the backend and Windows codecs. No music is included. If Explorer opens behind the game, the row tells you to press Alt+Tab.

Playback rules and compatibility

Matching follows music events across maps and scenes. Unlisted music is preserved; boss or story music will also be affected if you blacklist its event or enable Replace all BGM. Dynamic segments within one event cannot be blacklisted separately, and event identifiers are not guaranteed OST titles.

In blacklist replacement mode, custom playback stops for unlisted music or silence and restarts from the beginning when listed music returns.

Compatibility audio starts automatically and exits with the actual game process, or when replacement is disabled/the mod is unloaded. It uses Windows .NET Framework 4.x / WPF; no manual player launch is needed.

Alpha release, tested on Steam CL-302256_JKS-17280. Other game builds are unverified. 44 offline regression checks pass; playback, folder opening and scanning have also been verified in use. This does not establish support for every codec or scene.

Updates and removal

Close the game before updating. Preserve your Music folder and settings, normally at %LOCALAPPDATA%/ProjectPBZ/Saved/PBZBGM-settings.json. Uninstall through the manager, or back up your music and remove only ProjectPBZ/PBZModLoader/mods/PBZBGM and ProjectPBZ/Content/Mods/PBZBGM. Keep the shared loader and other mods.

For bug reports, include your game/loader versions, reproduction steps and relevant [PBZBGM] lines from ProjectPBZ/PBZModLoader/loader.log. Review logs for private paths before sharing.

Credits / 致谢

PBZModLoader: LKF and KintaroModding. S-GAME: Phantom Blade Zero. The game's own setting widgets are loaded at runtime. Mods Menu was consulted for UI API usage; its scripts and assets are not bundled. Code and page text were developed with AI assistance under user direction.

源码与构建 / Source and build

Files 中的 Source code 0.1.11 alpha 包含本模组 JS、player/Player.cs、player/Tools.cs、构建脚本与安装文档,不含二进制、游戏资源或音乐。 The optional Source code 0.1.11 alpha archive contains the mod JS, C# helper sources, build scripts and installation documents; no binaries, game assets or music.

Windows + .NET Framework 4.x + Python 3。解压源码后,在根目录运行 / Extract the source, then run from its root:

powershell -NoProfile -ExecutionPolicy Bypass -File scripts/build.ps1

输出 / Output: dist/PBZBGM-0.1.11-alpha.zip。构建使用系统 .NET Framework64 v4.0.30319 csc.exe;编译器和 ZIP 时间戳可能不同,不保证逐字节相同。Build uses the system .NET Framework64 v4.0.30319 csc.exe; compiler and ZIP timestamps may differ, so byte-identical rebuilds are not claimed.