Level Editor for Sonic: Project Mettrix

Sonic the Hedgehog: Project Mettrix is built such that it can be edtied in several ways.
A group of additions can be combined into a user-created "game set", a package resembling
the basic Mettrix game data set, which can hold new art, sounds, levels, and more.

Editing of this game is made up of two parts:

The Level Editor utilities
 Level Editor
 Tile Editor
 Tile Ripper
 "Debug Mode"
 Object Editor

The scripting files
 Game Def File (*.gdf)
 Character Def File (*.chr)

 Zone Intro Def File (*.tdf)
 Zone Def File (*.zdf)
 Object Def File (*.odf)
 
These files, used in the proper way, can allow for many nice changes or additions. To create a new "game set",
the proper file/folder layout must be used. An example listing is as follows:

sonic.exe
sonicwin.exe
launch.exe
etc....              
Mettrix		(Game Folder, can have any name, but no spaces)
-Mettrix.gdf	(Game Def File, MUST be same name as game folder)
-Master.odf	(Object Def file to replace default Global Objects)			 [Optional]
-Art			(Art Folder, any new global art should go here)			 [Optional]
  -*.spr		(320x200x256 PCX image)
  -*.scr		(320x200x256 PCX image)
-Chars		(Character Def folder, new character defs and art MUST go here)	         [Optional]
  -1.chr		(Character 1 Def file)
  -Char1-1.spr	(Character 1 art file 1, 320x200x256 PCX image)
-Demos		(Game Demo Folder, any demos MUST go here)	              		 [Optional]
  -Demo0.dem	(First demo file [0, 1, 2, 3....])
-Music		(Replacements for default music MUST go here)			         [Optional]
  -*.wav		(11Khz 8 bit mono wav file)
-SFX		(Replacements for default sound effects MUST go here)		         [Optional]
  -sfx0.wav	(First sound effect [0, 1, 2, 3....])
-Saves		(GameSaves for this addon will end up here)
  -gam.001	(First save file [000, 001, 002....])
-Stats		(Status art and script folder, replacements MUST go here)		 [Optional]
  -card.tdf	(Titlecard Script File)
  -Zlabel.spr	(Titlecard Art File, 320x200x256 PCX image)
  -levfont.fnt	(Titlecard Font Script File)
  -Levfont.spr	(Titlecard Font Art File)
-Zone00		(Options Zone, DO NOT use if one is not desired)			 [Optional]
-Zone01		(First Regular Zone folder [01, 02, 03....])
  -Zone.ZDF	(Zone Def File for this zone)
  -1.lev		(First level's layout file [1, 2, 3....])
  -1.obj		(First level's object layout file [1, 2, 3....])
  -1.til		(First tile set [1, 2, 3....], Not necesarily per level)
  -1-1.wav	(Part 1 of the first level music [1-1, 1-2, 2-1, 2-2....], Not necesarily per level)
  -Object.odf	(Object def file for zone-specific objects)				 [Optional]
  -*.spr		(Art for zone-specific objects)					 [Optional]

For instructions on using each of the editing tools and scripting files for creating addon games,
please view the other portions of the documentation.

For playtesting, you may use the "warp" command, either in the launcher or at the command prompt to
start gameplay at any level, in either mode, and with any character. The command line usage is as
follows (replace "sonic" with "mettrix" or "sonicwin" as necesary):

sonic game_name warp zone act player1 player2 playmode joystick

game_name - name of your addon game (cannot contain spaces)
zone - The ID number of the zone you want to play
act - The ID number of the act you want to play
player1 - ID number for player 1 (1 or above)
player2 - ID number for player 2 (0 if no player 2)
playmode - 0 for normal play, 1 for time attack (not implemented), 2 for split screen.
joystick - 0 for no joystick, 1 to turn the joystick on.

game_name may also be omitted if the desired level is contained in the default Mettrix game set.

To play a custom game from the beginning, omit everything after game_name:

sonic game_name

At the end of your game, currently, the program will exit, unless the zone order listing
is set to repeat the gameplay levels.