# Sparking Zero Audio Importer

Welcome to the Sparking Zero Audio Importer! This tool makes it easy to add your own music to Dragon Ball Sparking! ZERO.


# Features

Easy Conversion: 
Turn your .wav music files into the game's .hca format.

Song Replacement: 
Choose which in-game songs you want to replace.

Automatic Mod Creation: 
The tool sets up everything you need for the mod to work.

Interface for people who don't like Command Line: 
Drag and drop your files and let the tool handle the rest.


# Requirements

Before you start, you'll need:

Reloaded II: A mod loader for the game.
Download it here: 
https://gamebanana.com/tools/6693

Ryo Framework: Allows custom audio in the game.
Download it here: 
https://drive.google.com/file/d/1vV0cy2KvvajQ-RPiK38f8xhVnW10Sfd7/view


# Installation and Setup

1. Install Reloaded II
Download and install Reloaded II on your computer.
Open Reloaded II.
Click Add an Application.
Navigate to your game folder:
DRAGON BALL Sparking! ZERO\SparkingZERO\Binaries\Win64
Select SparkingZERO-Win64-Shipping.exe.

2. Install Ryo Framework
Download Ryo Framework.
Place the Ryo Framework folder into the Mods folder of Reloaded II.
Usually located at Desktop\Reloaded-II\Mods.
In Reloaded II:
Click Manage Mods.
Find Ryo Framework in the list.
Enable it for Sparking Zero.


# Using the Tool

1. Prepare Your Music Files
Make sure your music files are in .wav format, Audacity is the tool I used for this.
In Audacity the best settings for equalizing the music was:
30-35 LUFs seems best for BGM
15-20 LUFs seems best for Sparking

2. Run the Tool
Open Sparking Zero Audio Importer.exe.

3. Add Your Music Files
Drag and drop your .wav files into the tool's table.
The file names will appear in the list.

4. Select Songs to Replace
For each file, choose which in-game song you want to replace from the dropdown menu.
Decide if you want the song to loop by checking or unchecking the Loop? box.

5. Choose Mod Name
In the Mod Name box, type a name for your mod.
This will create a folder with this name in the Mods directory.

6. Process the Files
Click Create Ryo Mod Folder.
The tool will convert your files and set up the mod automatically.


# Activating Your Mod

1. Enable Your Mod in Reloaded II
Open Reloaded II.
Click Configure Mods.
Find your mod by the name you chose in the Sparking Zero Audio Importer
Enable it for Sparking Zero.

2. Launch the Game
Start the game through Reloaded II.
Your custom music should now play in the game!


# Exporting HCA Files Only (Optional)

If you want to just convert .wav files to .hca without creating a mod:

Check the Export HCA Only box in the tool.
Click Export HCA Audio Files.
The converted files will be saved in a folder named Sparking Zero Formatted Songs.
You can manually use these .hca files as needed.


# What the Tool Automates

Audio Conversion: Converts your .wav files to .hca format.
Mod Setup: Creates the necessary folders and files for the mod.
Configuration: Generates configuration files required by Reloaded II.


# Credits

Saitsu: Provided the original guide I based the automating process on.
https://docs.google.com/document/d/1vpbans9a7kV07LiSKn4xjYswoKTunsRFZQbIW2hQRvE/edit?tab=t.0

Reloaded II Team: Providing the modding manager platform.
https://github.com/Reloaded-Project/Reloaded-II

Ryo Framework Developers: Enabling custom audio in the game.
https://github.com/RyoTune/Ryo

VGAudio Team: Allowing conversion of .wav -> .hca
https://github.com/Thealexbarney/VGAudio

ANTIBigBoss (Me): Creator of the Sparking Zero Audio Importer.