CombinedAudioTool 3DS

CombinedAudioTool
General
Author	Cracko298, YT-Toaster
Type	Hack Utilities
Version	2.4
License	Apache-2.0
Last Updated	2024/12/04
Links
Download
Website
Source

CombinedAudioTool (CATool) is a tool for manipulating CombinedAudio.bin for Minecraft for New Nintendo 3DS Edition (MC3DS). It allows the original CombinedAudio.bin file to be extracted, modified, and rebuilt with vustom audio for modding and romhacking.

Only support Windows platforms officially, due to being built and made using some Windows API functions.

Note: Requires Python 3.8+ and Python STD (installed alongside Python).

Features

• Extract All FSB Soundbank Files in the Archive.
• Extract a FSB Soundbank File by Name/Sound-ID.
• Get File name(s) from Soundbank Files for easier recognition.
• Rename Extracted files to original filename(s).
• Rebuild CombinedAudio.bin with new Custom Audio Files.
• Extract Header from CombinedAudio.bin.
• Add padding to files automatically (Requires Original Extracted File).
• Collect all Sound Names/ID's.
• Rename all Segments to Original Filenames.
• Grab Segment File Sizes individually, or altogether.
• Updating your Script as new features become avaliable.
• Extract Audio from FSB Files (now including GCADPCM FSB Soundbank Files).
• Convert *.wav back into GCADPCM/DSADPCM.
• Restore CATool File Integrity.
• Encode Minecraft 3DS Music Files from Wave Files.
• Convert any Audio Filetype to Wave (requires FFMPEG).
• Install FFMPEG via Command Line.
• Add your own Custom Audio/Ambience/SFX to Minecraft 3DS.
• Get MetaData from CombinedAudio.bin Archive.
• Change between Interleaved/Flat/Weaved for SegmentFile.

Screenshots

Changelog

v2.4 2024/12/04

• Fixed a bug where FSB, DSP wouldn't convert to Wave Files using the --atw or to-wave flag.
• Added new MetaData Structuring for more info on CombinedAudio.bin SFX Archive.
• Fixed the --gsid flag so it now includes information retaining to which file each sound is tied too.
• Other under the hood bug fixes/changes that make no real difference (e.g. removing blank space lines, etc).

v2.3 2024/10/04

• Added Interweaving Changes/Functions.

v2.2 2024/08/02

• Bug Found in Old Release Causing full Script Lockout.
  • Thank you @SpeakerZ-01 for spotting and correcting the bug that wasn't found durring the development of version 2.1.

v2.1 2024/07/25

• Get MetaData from the CombinedAudio.bin Archive.
• Get alerted when a New Version a CATool is available to Update too!!!
• Updated a Few Descriptions of Flags/Args inside of the --help Flag.

v2.0 2024/07/03

• Can now fully add your Own Custom Audio into Minecraft Nintendo 3DS Edition!
• Updated addPadding Function to update the Length of the File (in the header), reducing the chance for Crashes, among Audio Corruption.
• Fixed a bug that stated --gsmc was the correct way to Launch generate-music Function.

v1.9 2024/07/01

• Download and FFMPEG Usage.
• Convert all Common Audio Formats to Wave (no need for Online Tools).

v1.8 2024/06/30

• Feature Update:
  • Encode Music for Minecraft 3DS Edition using the generate-music flag (--gmsc).
  • Restore now restores your Current Version rather than updating the entire Installation.
  • Fixed requests Module installation package not properly installing.

v1.7 2024/06/27

• Feature Update:
  • Convert *.wav Files into Valid DSADPCM/GCADPCM.
  • Can now play *.wav Files using the Windows API.

v1.6 2024/06/23

• Added Restore Feature:
  • Only use in Emergencies like File integrity is invalid: --rstr.

v1.5 2024/06/23

• Support for GCADPCM Extracting:
  • Extract audio as you normally would, now with an extra feature-set.

v1.4 2024/06/21

• Feature Update:
  • Attempt to Extract Audio from FSB Files.
  • Update Feature has been updated slightly.
  • Make sure to Extract this file when downloading via Script Download Feature.

v1.3 2024/06/19

• Added Update Feature:
  • No need to download from Latest Releases after this version.
  • Update your script using the following Flags: update (--upd).
  • Updated Sound ID and Extraction to be again much more accurate.

v1.2 2024/06/19

• Feature Update:
  • Added 2 new Features and Flags, get-size-seg, and get-size.
  • get-size-seg (--gssg) Gets the size of a specific Segment Soundbank FSB File.
  • get-size (--gs) Gets the size of all Segment Soundbank FSB Files.

v1.1 2024/06/19

• Feature Update:
  • New Flags get-soundid, and rename-all.
  • Updated name-extract to be much more accurate instead of assuming the Sound Name/ID.

v1.0 2024/06/19

• First Release.
• Features and docs are provided apon the homepage.

External links

• GitHub - https://github.com/Minecraft-3DS-Community/CombinedAudioTool