HamsterSpeak Decompiler (version 1,00)
          2003 The Mad Cacti
                 (with thanks to James Paige for answering queries)

This Decompiler is a utility to to retrieve a hss plotscripts file out of the compiled 
scripts file. Use if you've accidentally deleted or lost your original scripts file, 
but still have your game or HS file.

You can either use the .HS file if you still have it, or if you imported the scripts 
into your .RPG, you can unlump your game and use the .HSD file in it. To unlump a RPG 
file, use unlump.exe (which comes with custom) or custom.exe.


 Calling HSDECMPL:


Call HSDECMPL either with command line options or by opening it, or by drag dropping 
an HS file onto it. All files must be in the same directory as the HS if you drag drop 
the HS file onto HSDECMPL. Calling HSDECMPL by the commndline with paths may be buggy.
If you do so, make sure every file has a path.

Command-line syntax is:   (Available by calling with the /? switch)

HSDECMPL  [hsfile [hssoutputfile] [includefile[+includefile[+...]]] [optionlist] ]

There must be no spaces between include files.
You can leave out a filename, so that a double space is left. Stop passing 
arguments to HSDECMPL at any point along the chain. Watch your spaces.
Ok, I know that this is insanily complicated, so don't use it :P

 Formatting options Usage notes:
 -It is strongly recommended that you turn on the following, or your script will be 
   a mess:  sort globals, flow end on newlines, use operators, newline after flow end.
   Simplifying all flow with 1 arg is beneficial.
 -I don't really recommend using the 'theworks' set, it's just for fun.
 -Please ignore my 'descriptive' builtin formatting options names- I couldn't come 
   up with proper names. Just try them all.

 Including files:
   Be easy on HSDECMPL. The errorchecking for reading in libaries and HSD files is
   almost non existant. Don't feed anything in that HSpeak would reject.
 
 Troubleshooting:

  -If HSDECMPL freezes during decompilation, use the /S:stack switch to increase the 
   amount of stackspace. Default 15 kb. You really shouldn't run into this error,
   15 kb is enough for nearly anything. 
 
  -(unknown symtoms, crash or freeze) Out of memory. Decrease the stack size with the
   /S:stack switch

  -Bad formatting. Stay away from some of the shifty formatting options, like turning
   off end & ) on newline. Use a builtin set.

  -Formatting files or include files can't be read/wrote/no data read from. This might
   happen if you muck around with passing filenames with paths to HSDECMPL. Don't

  -'I can't hear sound on my speakers.' I am so sick of that question. Get VDMSound, 
   a new(old) sound card, an old computer, or read one of the other hundred posts on the
   question to find out what to do.


Feel free to distribute HSDECMPL, provided that none of the files are altered, and this 
txt file is included with it.
I'm not responsible if this software damages your computer. It should not do so, but 
obviously if you rename win.com to yourgame.hss, stick HSDECMPL in your windows folder,
and decompile, you may get windows throwing a hissy fit at you and crashing HSDECMPL to
save its skin. Or maybe you'll overwrite win.com. I don't know, I wouldn't try. :L

Please send comments, question, suggestions and bugs to 
The Mad Cacti      gwp_@hotmail.com
or contact me by PM on the CastleParadox.com or OHRRPGCE.com forums.