
SoundFX 搜索与更新
此脚本是一个一体化解决方案,适用于希望处理OPUSPAK和WEM文件,和/或获取与音效或音乐相关的ID和音频数据的模组制作者。
查看大图描述
本脚本是一站式解决方案,面向需要处理 OPUSPAK 和 WEM 文件,和/或获取与音效或音乐关联的 ID 及音频数据的模组制作者。
你可以将游戏中的任意音效提取为一组 WAV 文件。然后处理这些 WAV 文件,再次使用脚本将修改后的 WAV 文件连同 OPUSINFO 文件更新一起导入 OPUSPAK。最后将生成的 OPUSPAK 和 OPUSINFO 放入你的模组中。
致谢: 感谢 HitmanHimself 及其 Cyberpunk Opuspak Tool,该工具基于 WolvenKit C# 源代码 从 OPUSPAK 文件中提取和更新源 ID。我将其翻译为 Python,并在其上创建了事件解析层,从而打造出可在所有平台上轻松使用的一站式解决方案。
使用方法


环境要求
- Python: v3.12.0(下载链接)。
- Python 库:
lxml, numpy, jsonpath-ng。使用 "pip" 安装,见下文。 - Opus 编解码器,用于 OPUSPAK 与 WAV 之间的转换。Windows 已内置,其他平台请在此下载。
- vgmstream,用于 WEM 转 WAV 转换。Windows 已内置,其他平台请在此下载并自行构建。
安装
将 "SoundFX Search and Update" 文件夹解压到你的计算机上。
安装 Python 及其附加内容 "pip" 以安装库,如果需要自行生成 XML bank 则还需安装 "tcl/tk and IDLE";否则直接从可选文件区下载 XML bank,无需安装 "tcl/tk and IDLE"。
在
cmd.exe窗口中安装所需的 Python 库:
pip install lxml numpy jsonpath-ng
如何获取所需的 "events_to_lookup" 文件: 这是一个简单的文本文件,每行必须包含一个事件。你可以通过 Zhincore 制作的这个优秀网站搜索事件。你也可以使用优秀的文本编辑器(如 Sublime Text)打开 "eventsmetadata.json" 文件,利用正则表达式搜索、全选结果、排序行以及去重行。
事件文件示例(包含 '==' 的行不存在): == begin_file == mus_ow_valentinos_stealth av_maxtac_start_descent amb_q305_inner_bunker_blackout_siren ui_phone_sms == end_file ==
如何获取所需的 "events_catalog" 文件: 游戏在以下内部路径包含一个名为 "eventsmetadata.json" 的二进制文件:"base\sound\event"。
你需要使用 WolvenKit 将其提取并转换为可读的 JSON 文件。
然后使用参数 --events_catalog 将可读的 JSON 文件传递给脚本。
你也可以从可选文件区下载该文件。
如何获取所需的 "soundbanks" 文件夹: v2.5 版本的游戏在内部路径 "base\sound\soundbanks" 中包含 1621 个 OPUSPAK 文件、1 个 OPUSINFO 文件和 4793 个 WEM 文件。
你需要使用 WolvenKit 将所有这些文件提取到计算机上的一个文件夹中。
然后使用参数 --soundbanks 将该文件夹传递给脚本。
如何获取所需的 "xml" 文件夹: 游戏在内部路径 "base\sound\soundbanks" 中包含声音 bank(*.bnk)文件。我们将使用其中两个:"sfx_container.bnk" 和 "cp_music.bnk"。
我们需要 wwiser 工具将 BNK 文件转换为可读的 XML 文件。 你可以直接从可选文件区下载它们,也可以按照以下说明自行生成。
在某处下载并解压 wwiser。 然后打开 wwiser 文件夹(名为 wwiser-master),在 cmd.exe 窗口中执行命令 'py build.py',Python 将创建一个可执行文件。
可执行文件将生成在 'bin\wwiser.pyz'。你可以双击此文件以图形界面方式打开 wwiser。这就是为什么在安装 Python 时需要包含 "tcl/tk and IDLE" 附加内容。运行图形界面需要这些库。
在 wwiser 窗口中,使用 [Load banks...] 按钮加载 'sfx_container.bnk' 文件,等待处理完成。然后点击 [Dump banks...] 并等待 XML 文件创建完成。接着在上方列表中选择已加载的 bank,点击 [Unload banks]。
对 'cp_music.bnk' 重复此步骤。不要将多个 BNK 文件合并到单个 XML 文件中,因为脚本无法处理。每个 BNK 文件必须对应一个 XML 文件。
将这两个 XML 文件放入一个文件夹,并使用参数 --xml 将该文件夹传递给脚本。
脚本参数
要显示关于脚本参数的更多帮助,请在 cmd.exe 中使用以下命令:
py soundfx_search_and_update.py -h
支持
如果出现任何不符合预期的问题,欢迎联系我,以便我进行调查。 请使用 POSTS 标签页,尽可能详细地描述你的问题。
我的模组
- Mute TV Ads
- Mute TV News
- Quieter TV Ads
- Remove TV Ads
- Quieter TV News
- Mute V's Footsteps
- Mute V's Pain Voice
- Louder V's Footsteps
- Crystal Coat Fix v2.12
- Mute Loading Screens
- Mute Vehicle Gear Shift
- Mute OpenWorld Devices
- Enhanced Vehicle System
- Mute Police Dispatch Radio
- Dex Briefing - Music Theme
- Crystal Coat for Arch Nazare
- Quieter TV News and TV Ads
- Louder V and NPCs Footsteps
- Enhanced Police Lights System
- Crystal Coat for Herrera Outlaw
- Evelyn Stilettos Sound Replacer
- Mute Combat and Camera Alert
- Crystal Coat for Yaiba Kusanagi
- Mute Combat and Stealth Music
- Crystal Coat for Makigai MaiMai
- Always use Stiletto Heels Sound
- Restore v1.63 NCPD Police Siren
- Crystal Coat for Quadra Type-66
- Restore v2.0 Double Jump Sound
- Crystal Coat for Rayfield Caliburn
- Crystal Coat for Villefort Alvarado
- Crystal Coat for Rayfield Aerondight
- Improved Yaiba ARV-Q340 Semimaru
- Remove Crystal Dome Scanning Lines
- Escape from NY Menu Theme and Ringtone
- Mute both TV News and TV Ads (Legacy only)
- Chippin' In (Refused) Song or Instru Mix - Music Theme
我的模组制作工具
正在加载版本记录…
正在加载评论…
评论在新手盒子客户端中发表,这里同步展示。