Halo Sound Tools

by MonoxideC

v0.1b - Original Release

---------------------------------------------------------------------------------------



UPDATE: Due to a recent comment by an important Bungie employee concerning sound

	extraction, I have decided to leave that part out of this release until

	I can make a final decision.  True, extraction is already publicly available

	in KornKobs app, but with Halo Sound Tools it would be super easy to

	extract every single sound in the entire game and post it on the net - which

	neither I nor anyone else involved with these hacking projects wants to see

	happen.  So out of respect for Bungie, everything related to extraction has

	been disabled in this release.  I dunno about future releases - we'll see

	how it turns out.



Q: What is it?

A: A tool that allow you to extract as well as inject over any existing sound data

   in a Halo Xbox map file.



Q: Cool!  I can extract all the sounds out of the game and-

A: STOP FUCKER!  The whole point of this app is to INJECT sounds - extracting sounds

   only exists in this app because it can be helpful when creating new sounds to

   inject.  All of the sounds in Halo are BUNGIE'S property - NOT yours.  You are

   strictly forbidden from posting or sharing them PERIOD!  If you do, then you do

   so against Bungie and Microsoft's approval and are leaving yourself wide open

   for legal action, aside from the fact that you'll be acting like an inconsiderate

   asshole.  YOU'VE BEEN WARNED!



Q: I get an error when I launch the program! WHY?

A: You probably don't have the .NET framework installed.  Yes it's required.



Q: When I try to play an extracted sound it gives me an error!

A: You need the Xbox ADPCM Codec to play extracted sounds, and you'll have to find

   it yourself.  Try one of "the usual places"



Q: When I goto the XBADPCM Encode GUI, it says that the encoder was not found.

A: xbadpcmencode.exe is an app thats compiled from code that's included with the XDK,

   thus it can't be legally distributed.  This means that if you want to encode your

   own sounds and you don't have the XDK, then you're out of luck unless

   xpadpcmencode.exe happens to show up on your PC for some reason.  If it does though,

   be sure to put it in the 'encoder' folder in the directory that HaloSoundTools

   resides in.

   * Note to other developers: If anyone has experience with adpcm and could write

     an encoder that produces files that conform to the xbadpcm specifications,

     that would be awesome!  Or if anyone knows of an alternative legal method of

     encoding, please let me know.



Q: I don't understand how to use this shit!

A: Figure it out, dumbass :P



Q: What's all this track and chunk bullshit?

A: A given sound structure in a map is split into tracks, and each track is

   composed of one or more chunks.



Q: Why?

A: Because.



Q: Are there any Easter Eggs in this app?

A: Yeah there's one and it's pretty easy to find.



Q: What do I get if I find the Easter Egg??!

Q: A laugh (maybe).



Q: Where can I report bugs?

A: Find me in #halohacker on freenode - bug reports will be appreciated!



---------------------------------------------------------------------------------------

Credit goes out to everyone involved in the Halo hacking scene!

Especially Slayer for giving everyone something to work off of.



Special thanks to Boll for some extremely fine Beta testing.

---------------------------------------------------------------------------------------

:: 09-06-2003 ::