SoundFX search and updates
This is an all-in-one solution for modders who want to process OPUSPAK and WEM files, as well as obtain sound effect or music related ID and audio data.
About this mod Machine translation
This is an all-in-one solution for modders who want to process OPUSPAK and WEM files, as well as obtain sound effect or music related ID and audio data.
SoundFX Search and Updates
🎯 **All-in-one Audio Processing Tool** - A powerful audio processing script specially designed for "Cyberpunk 2077" modders
✨ Core Functions
🎵 **Audio Extraction and Modification**
- Extract any sound effect from the game to WAV file
- Make custom modifications to WAV files
- Re-import modified audio into OPUSPAK files
- Automatically update OPUSINFO files
🛠️ **Technical Features**
- Supports OPUSPAK and WEM file formats
- Get the ID and audio data of sound effects and music
- Cross-platform compatible Python scripts
- Integrated opus codec and vgmstream tools
📋 System Requirements
**Required components:**
- Python v3.12.0
- Python libraries: lxml, numpy, jsonpath-ng
- Opus codec (built-in in Windows version)
- vgmstream tool (Windows version has built-in)
🚀 Installation Guide
- Unzip the "SoundFX Search and Update" folder to your computer
- Install Python and make sure to include the pip package manager
- Install the necessary Python libraries:
```bash
pip install lxml numpy jsonpath-ng
```
📁 Description of necessary documents
**events_to_lookup file**
- Simple text file containing one event per line
- Can be searched and obtained from eventsmetadata.json file
**events_catalog file**
- eventsmetadata.json file in the game
- Requires WolvenKit extraction and conversion
**soundbanks folder**
- Contains 1878 OPUSPAK files and 4796 WEM files
- Extract from in-game using WolvenKit
**XML folder**
- Contains XML files converted by sfx_container.bnk and cp_music.bnk
- Use wwiser tool to convert and generate from BNK files
💡 Usage Tips
To see the complete script parameter description, run in cmd.exe:
```bash
py soundfx_search_and_update.py -h
```
🔧 Technical Support
If you encounter any problems, please contact the author through the POSTS tag and describe the problem in detail.
---
*Developed based on HitmanHimself's Cyberpunk Opuspak Tool and WolvenKit C# source code, converted to Python and added an event parsing layer*
Install & use Install: follow the bundled instructions
- Unzip the archive from playbuff and read the bundled readme / instructions first.
- There is no universal mod manager for this game: some mods replace game files directly, some go into a game-specific Mods folder, and some need a game-specific community loader or tool first — follow the bundled readme.
- Place the files exactly as the readme says; mods with listed dependencies need those installed too.
- Launch the game to confirm it loaded; some games require enabling mods in settings or an in-game mod menu.
Install locations vary a lot between games and mods — the bundled readme is the most reliable guide.