Difference between revisions of "BrawlDJ"

From OpenSA: Smash Engine Documentation Wiki
Jump to: navigation, search
(Downloads)
 
Line 34: Line 34:
 
Pastebin this file and post the link in the smashboards thread. Dantarion will look at it and figure out why it doesnt work
 
Pastebin this file and post the link in the smashboards thread. Dantarion will look at it and figure out why it doesnt work
 
== Downloads ==
 
== Downloads ==
* Check back soon!
+
* [http://opensa.dantarion.com/beta/brawldj_v1_0.zip v1.0 Released April 10th, 2011]

Latest revision as of 22:02, 10 April 2011

What is BrawlDJ?

BrawlDJ is a set of codes, programs, and tools to manage your brstms. While it doesnt create .brstms, it does a lot of amazing things that havent been possibly until recently.

  • With the CSE (Custom Sound Engine), you can add songs WITHOUT replacing ones in the game.
  • You can edit a stage's songlists, including adding song slots to a stage, for up to 10? songs per stage.
  • You can create new songlists for expansion stages, or one for the CSS

CSE

The CSE or Custom Sound Engine, is a standalone code that changes how the game deals with unused SFX and Song IDs.

Usage

If the game attempts to load a SFX or Song ID greater than 0x286C, it will instead load a file from the directory /sound/sfx/ For example, ABCD => /sound/sfx/0000ABCD.brstm
This works with Riivolution and GeckoOS, but requires special rules in the XML for Riivolution, and sometimes plays static or distorted music in GeckoOS

BrawlDJ.py

BrawlDJ.py is a set of python scripts for making custom versions of these files:

  • common2_en.pac (Contains SongID->Title table, and SongID->StageTrackList table)
  • mu_menumain_en.pac (Contains song titles)
  • info_en.pac (Contains song titles)
  • info_training.pac (Contains song titles)

There are three steps to using BrawlDJ.py:

  • Extraction (Extracting the data from your customized or default files)
  • Editng (Editing the produced custom_snd_bgmSysData.txt file)
  • Injection (Putting the data back into the files)

BrawlDJ takes in files from the in/ folder, and outputs files in the out/ folder. It will not override the original files. However, if you want to re-edit your customized files, simply put them in the in folder after running BrawlDJ. Otherwise, re-extracting will override your custom_snd_bgmSysData.txt with the info from the in/ files

Extraction

Either use the default NTSC files provided, or override them with your own files. Then, double click "extract.bat"

Editing

Edit custom_snd_bgmSysData.txt using a text editor that doesnt suck, like Notepad++. Notepad puts something weird in the beginning of the file when you save, idk.

Injection

Double click "inject.bat"

Debugging

If you have trouble with your files, double click "debug_dump.bat". This will produce a "debug_info.txt". Pastebin this file and post the link in the smashboards thread. Dantarion will look at it and figure out why it doesnt work

Downloads