SoundFX 搜索与更新

SoundFX 搜索与更新

此脚本是一个一体化解决方案,适用于希望处理OPUSPAK和WEM文件,和/或获取与音效或音乐相关的ID和音频数据的模组制作者。

描述

本脚本是一站式解决方案,面向需要处理 OPUSPAK 和 WEM 文件,和/或获取与音效或音乐关联的 ID 及音频数据的模组制作者。

你可以将游戏中的任意音效提取为一组 WAV 文件。然后处理这些 WAV 文件,再次使用脚本将修改后的 WAV 文件连同 OPUSINFO 文件更新一起导入 OPUSPAK。最后将生成的 OPUSPAK 和 OPUSINFO 放入你的模组中。

致谢: 感谢 HitmanHimself 及其 Cyberpunk Opuspak Tool,该工具基于 WolvenKit C# 源代码 从 OPUSPAK 文件中提取和更新源 ID。我将其翻译为 Python,并在其上创建了事件解析层,从而打造出可在所有平台上轻松使用的一站式解决方案。

使用方法

https://image.noelshack.com/fichiers/2023/47/3/1700675589-diapositive4.png https://image.noelshack.com/fichiers/2023/47/3/1700679248-proxyimage.pnghttps://image.noelshack.com/fichiers/2023/47/3/1700675663-diapositive6.png

环境要求

  • Python: v3.12.0(下载链接)。
  • Python 库: lxml, numpy, jsonpath-ng。使用 "pip" 安装,见下文。
  • Opus 编解码器,用于 OPUSPAK 与 WAV 之间的转换。Windows 已内置,其他平台请在此下载。
  • vgmstream,用于 WEM 转 WAV 转换。Windows 已内置,其他平台请在此下载并自行构建。

安装

  1. 将 "SoundFX Search and Update" 文件夹解压到你的计算机上。

  2. 安装 Python 及其附加内容 "pip" 以安装库,如果需要自行生成 XML bank 则还需安装 "tcl/tk and IDLE";否则直接从可选文件区下载 XML bank,无需安装 "tcl/tk and IDLE"。

  3. 在 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 标签页,尽可能详细地描述你的问题。

我的模组

我的模组制作工具