Disassemblies

This pages lists all the public disassemblies made by the Sonic hacking community. Some of these disassemblies are still being worked on on the GitHub account, which are more up-to-date and accurate than those listed on this page, and are already split.

Sonic 1

Revision 00

• The GitHub version is the most up to date version.
  • MainMemory has made a MapMacros branch that converts all sprite mappings to a macro format.
  • MainMemory has also made a branch that targets the AS assembler.
  • Clownacy has made a branch that is based on Project Sonic 1: Two Eight.
• The following are kept for historical purposes only:
  • Sonic 1 SVN Disassembly ^(info) (676 kB) - Snapshot taken 16 July 2010.
  • Old Hivebrain disassemblies:
    • Sonic 1 (Split and Text by Hivebrain) (ASM68K) ^(info) (1,016 kB) - A modified version of Hivebrain's split disassembly targeting ASM68K. As a result, it builds much faster, does not need to use an external program for includes (and hence bypasses s1comb.asm), and can be optimized in various ways. The GitHub version of the Sonic 1 disassembly is based on this version.
    • Sonic 1 (Split and Text by Hivebrain) (AS) ^(info) (2.99 MB) - A modified version of Hivebrain's split disassembly targeting AS. As a result, it does not need to use an external program for includes (and hence bypasses s1comb.asm), and AS-specific features such as functions, nameless temporary labels and improved macro facilities can be used. Tools for building for Linux are available here ^(info) (1.51 MB) and Mac users should click here ^(info) (1.4 MB) for build tools.
    • Sonic 1 (Split and Text by Hivebrain) ^(info) (771 kB) - The June 2005 release of Hivebrain's Sonic 1 split disassembly. SonED2 project files are available here. It targets SNASM68k. Very well labeled, but because of certain problems with SNASM68k it is recommended to use either the ASM68k version or the AS version of this disassembly (also note that this version doesn't work with any 64 bit OS and may not work with Windows 2000/XP/Vista/7!) .
    • Sonic 1 (Shadow05 AS Disassembly) - A vastly improved version of Hivebrain's AS disassembly. It's better labeled than the original version and includes more features, and is SonLVL and SonED2 compatible, with project files bundled.
  • Project Sonic 1: Two-Eight (by MarkeyJester) - Modifies the game's level layout engine to use Sonic 2's 128x128-pixel chunks and path-swapping system.
    • Shadow05 also made a branch based on Project Sonic 1: Two Eight.
  • Old drx disassemblies:
    • Sonic 1 (IDB by drx) ^(info) (1.14 MB) - The very first Sonic 1 disassembly, by drx. This is an IDB file and can only be opened in IDA Pro.
    • Sonic 1 (Text Format by drx) ^(info) (673 kB) - The very first Sonic 1 disassembly, by drx. This is in text format and can be opened in any editor. It targets SNASM68k.
• Sonic 1 Z80 Sound Driver (Text format by Flamewing) ^(info) (1.05 MB) - A vastly improved version of Puto's disassembly of the Z80 sound driver.
• The following is kept for historical purposes only:
  • Sonic 1 Z80 Sound Driver (Split+Text format by Puto) ^(info) (1.2 MB) - A disassembly of the Z80 portion of the Sonic 1 sound driver. It targets the macro assembler AS, and it's cross-platform.

Revision 01

• The GitHub version allows for a complete building of revision 1.

Revision 02/XB (Sonic Mega Collection)

• The latest update of the GitHub version allows for a complete building of revision 2.

Sonic 2

Sonic 2 Master System

• Sonic 2 Master System (Split format by Glitch) - A split disassembly of the Master System version of Sonic the Hedgehog 2 (8-bit), by Glitch. This disassembly has been uploaded to GitHub.

Sonic 2 Nick Arcade prototype

• Sonic 2 Early Prototype (IDB by drx) - A disassembly of the Sonic the Hedgehog 2 Nick Arcade Prototype, by drx. This is an IDB file and can only be opened in IDA Pro.
• Sonic 2 Early Prototype (Text Format by drx) - A disassembly of the Sonic the Hedgehog 2 Nick Arcade Prototype, by drx. This is in text format and can be opened in any editor. It targets SNASM68k (also note that this version doesn't work with any 64 bit OS and may not work with Windows 2000/XP/Vista/7!).

Sonic 2 Wai prototype

• Sonic 2 Beta (Split Format by Esrael) - A disassembly of the Sonic 2 Simon Wai Prototype, by Esrael.
• Sonic 2 Beta (Split Format by Super Egg) - An updated version of Esrael's disassembly by Super Egg and Nayr T'nargh. [1]

Sonic 2 Beta 4

• Sonic 2 Beta 4 (Split format by Esrael) - A split disassembly of Sonic the Hedgehog 2 Beta 4, by Esrael.
• Sonic 2 Beta 4 (Split format by Puto) - A revised version of Esrael's Sonic 2 Beta 4 disassembly by Puto. Edits include IDA-like formatting and support for ASM68K.

Sonic 2 final

Revision 00

• The GitHub version of Revision 01 allows for a complete building of revision 00.
• Sonic 2 Rev 00 (Text Format by drx) - A disassembly of Sonic the Hedgehog 2 revision 00, by drx. It targets SNASM68k.

Revision 01

• The GitHub version is the most up to date version.
  • MainMemory has made a MapMacros branch that converts all sprite mappings to a macro format.
• The following are kept for historical purposes only:
  • Sonic 2 (Split and Text by Xenowhirl) - The 2007 release of the disassembly of Sonic the Hedgehog 2, by Xenowhirl. It is far better labeled than its predecessors and the assembly times are very fast (1-5 seconds). The disassembly itself is fully SonED2 compatible, and project files are bundled. It targets the Macro Assembler AS, and is cross-platform. The GitHub version of the Sonic 2 disassembly is based on this version. Tools for building for Linux are available here and Mac users should click here for build tools. Very highly recommended.
  • Old Nemesis disassemblies:
    • Sonic 2 (IDB by Nemesis) - A disassembly of Sonic the Hedgehog 2, by Nemesis. This is an IDB file and can only be opened in IDA Pro.
    • Sonic 2 (Text Format by Nemesis) - A disassembly of Sonic the Hedgehog 2, by Nemesis. This is in text format and can be opened in any editor. It targets SNASM68k.
    • Sonic 2 (Split Format by Nemesis) - Nemesis's Sonic 2 split disassembly, targeting SNASM68k. This disassembly is rather slow to rebuild due to the use of an external program (combine.exe) to insert binary files into the ROM - the following two disassemblies work around this by using incbins instead of combine.exe:
      • Sonic 2 (Text Format with Incbin by shobiz) - A drop-in replacement for the s2.asm file in Nemesis' Sonic 2 split disassembly, by shobiz. This disassembly uses incbins to greatly speed up compile times. It is also fully SonED2 compatible without requiring any modifications. This disassembly targets SNASM68k and works on Windows 2000/XP.
      • Sonic 2 (Text Format with Incbin by Xenowhirl) - Identical to shobiz's modified disassembly, but works on Windows 95/98/ME/NT as well as DOSBox. It does not work on Windows 2000 or XP due to a difference in the way these operating systems handle 8.3 short filenames.
  • Sonic 2 (Split and Text by Aurochs) - The 2006 release of the disassembly of Sonic the Hedgehog 2, by Aurochs. It is better labeled than Nemesis' disassembly and the compile times are much faster. The disassembly itself is fully SonED2 compatible, and project files are bundled. It targets the Macro Assembler AS, and is cross-platform.

Revision 02

• The GitHub version of Revision 01 allows for a complete building of revision 02.

On 2012-06-17, well-known hacker Esrael

released his disassembly of the version of Sonic 2 from Sonic Classics a.k.a. Sonic Compilation, which has come to be thought of as ‘revision 2’/‘REV02’ and includes several bug-fixes and other changes when compared to earlier versions. The release followed a lengthy discussion on how to enhance Sonic 2 with bug-fixes and other changes, several of which were noted by Esrael as having already been fixed in this relatively little-known revision, which he had become experienced with via using it as the code-base for recent versions of his hack Sonic 2 Delta. Esrael had already released the unaltered ROM of this version earlier in the thread.

• Disassembly of Sonic 2 revision 2 by Esrael

Knuckles in Sonic 2

• Knuckles in Sonic 2 (Text & IDA Format by Puto) - A disassembly of the Knuckles in Sonic 2 UPMEM by Puto. This disassembly has been uploaded to GitHub and is available here.

Sonic & Knuckles

• The GitHub version is the most up to date version.
• The following are kept for historical purposes only:
  • Sonic & Knuckles (Split Format by jman2050) A split disassembly of Sonic & Knuckles created by jman2050 and a variety of other contributors, using Stealth's disassembly. The GitHub version is based on this disassembly.
  • Sonic & Knuckles (IDB by Stealth) - The first complete Sonic & Knuckles disassembly, by Stealth. Includes support for Sonic 3 lock-on. This is an IDB file and can only be opened in IDA Pro.
  • Sonic & Knuckles (Text Format by Puto) - A text file exported by Puto from Stealth's Sonic & Knuckles disassembly for those who do not have IDA Pro. Tools for assembling (provided by snkenjoi) are available here.

Sonic 3 & Knuckles

• The GitHub version of the Sonic & Knuckles disassembly allows building a complete version of Sonic 3 & Knuckles, and is the most up to date version.
• The following are kept for historical purposes only:
  • Sonic 3 & Knuckles (Split Format by Hayate) - An IDA export of Puto's Sonic 3 & Knuckles disassembly ran through a couple of Python scripts by Hayate.

Sonic Crackers

• Sonic Crackers (Split Format by MarkeyJester) - A split disassembly of Sonic Crackers by MarkeyJester.
• Sonic Crackers (IDB by Stealth) - A Sonic Crackers disassembly by Stealth. This is an IDB file and can only be opened in IDA Pro.
• Sonic Crackers (Text Format by Shobiz) - A text file exported by shobiz from Stealth's Sonic Crackers disassembly for those who do not have IDA Pro.

Sonic 3D: Flickies' Island

• Sonic 3D: Flickies' Island disassembly (IDB/Text by Sik) - Hybrid IDB and text split of the Mega Drive version of Sonic 3D: Flickies' Island by Sik. Can only be opened in IDA Pro.
• Sonic 3D Blast proto 73 disassembly (Split by DelayHacks) - Split disassembly of the Sonic 3D Blast proto 73 made by DelayHacks. It targets ASM68k and also uses Natsumi's ASM68k Z80 extension so Z80 code was also disassembled.

Sonic Spinball

• Sonic Spinball disassembly (IDB by andlabs) - A Sonic Spinball disassembly by Andlabs. This is an IDB file and can only be opened by IDA Pro.