How lostlmbecile/sparking-zero-audio-modding-tool works
This project is a Windows-only audio modding suite designed to handle game audio files by extracting, converting, processing, packaging, and injecting various audio assets. The system comprises three distinct tools:
• The main tool (SparkingZeroAudioModdingTool) that oversees general modding tasks such as extracting files from various formats (.acb, .awb, .uasset), converting them from HCA to WAV and vice versa, and packaging them back into mod files.
• The BgmModdingTool sub-module which specializes in handling background music (BGM) injection, specifically managing AWB file headers and uasset injections, along with index/cue mapping.
• The AddWavMetadata sub-module that adds metadata to WAV files (covering Title, Album, Artist, Genre, and Track Number).
Main Components
a. User Input / File Interaction:
– Represent the user interface (CLI or drag-and-drop file operations) that accepts various file types and folders from the user.
b. Core Modding Components:
– SparkingZeroAudioModdingTool as the central coordinator handling general modding operations, from file extraction to packaging.
– BgmModdingTool, a sub-module specifically responsible for extracting AWB headers and injecting data into game files.
– AddWavMetadata tool, responsible for enriching WAV files with metadata.
c. Processing Pipelines and File Handling:
– Components for file extraction, conversion between formats (WAV ↔ HCA), packaging into mod-specific containers (utoc, ucas, pak), Dll integration and index mapping.
d. External Dependencies:
e. Supporting Configuration and Resources:
– Config files (config.ini, keys.csv) that guide the modding process.
– Resource files and manifests (app.manifest and resources.rc present in multiple resource directories) that set application metadata and Windows-specific runtime data.
Relationships and Data Flow
– User inputs files (AWB, ACB, uasset, WAV files) into the main tool.
– Main tool feeds extracted files to the conversion pipeline (HCA conversion via vgmstream-cli).
– Once converted, files flow into packaging steps where mod archives are built.
– For BGM-specific operations, AWB headers and uasset components are extracted/injected by the BgmModdingTool module.
– Metadata addition to WAV files is handled by the AddWavMetadata module.
b. That configuration settings (e.g., file paths, key files) drive parts of the process and are read early in the workflow.
Architectural Patterns or Design Principles
a. Modular Design: Each tool/sub-module handles a specific aspect of the overall modding process.
b. Decoupling of core functionalities: The separation between general modding, BGM injection, and metadata addition invites clear boundaries.