RLM - Revision history

Parasyte at 06:28, 28 December 2020

2020-12-28T06:28:11Z

Parasyte: /* Lunar Magic Protection */

2009-12-27T04:06:44Z

‎Lunar Magic Protection

Parasyte: /* Usage */

2009-12-27T04:05:50Z

‎Usage

Parasyte: /* Usage */

2009-12-27T04:05:23Z

‎Usage

Parasyte: /* Lunar Magic Protection */

2009-12-24T19:33:03Z

‎Lunar Magic Protection

Parasyte at 07:21, 21 October 2009

2009-10-21T07:21:10Z

Parasyte: /* Lunar Magic Protection */

2009-10-21T07:19:31Z

‎Lunar Magic Protection

Parasyte: /* Download */

2009-02-09T02:17:25Z

‎Download

Parasyte: New page: RLM is a program designed to "unprotect" Super Mario World ROM hacks that were "protected" with the Lunar Magic level editor. RLM stands for "Recover Lunar Magic". Also seen in the source ...

2009-02-09T02:14:30Z

New page: RLM is a program designed to "unprotect" Super Mario World ROM hacks that were "protected" with the Lunar Magic level editor. RLM stands for "Recover Lunar Magic". Also seen in the source ...

New page

RLM is a program designed to "unprotect" Super Mario World ROM hacks that were "protected" with the Lunar Magic level editor. RLM stands for "Recover Lunar Magic". Also seen in the source code, "Rape Lunar Magic" was once considered.

==Lunar Magic Protection==
The protection scheme used by Lunar Magic is simple albeit effective against inexperienced hackers. When protecting a hack, the editor will write a few bytes into the SMC header as well as the SNES ROM header which it uses to signal to itself that the ROM is protected. Reversing these changes is enough to bypass the "Lunar Magic cannot open this ROM" message, but you will run into trouble when you open the edited stages.

Almost everything that Lunar Magic edits will be encrypted with a simple XOR operation, when a hack is protected; unedited stages and objects will remain in their original, unencrypted state.

The first thing encrypted is the stage pointers. To anyone looking in a head editor, they appear to point to invalid stage data (because they do). Decrypting these pointers shows you were to find the valid "RATS" headers, as well as encrypted stage data. At this point, decrypting the stage data is enough to open the hack in Lunar Magic. However, the ROM will now work on an SNES or an emulator, due to an assembly hack in place which will try to decrypt the already-decrypted stage data. Reverting the assembly hack will make the ROM playable.

Other edited objects in the ROM are also encrypted in a similar manner. The overworld is a particularly big example. I believe the "ExGFX" are also encrypted.

==RLM Specifics==
RLM contains codes which will allow it to handle LoROM and ExHiROM SNES ROMs in the SMC format. The main decryption loop, decryptLunar(), is a very simplified Super Mario World stage data parser. Most data blocks in this stage format are 3 bytes, but some are 4 or 5 bytes. RLM has to understand this concept (at the very least) in order to decrypt the stage data properly; Only the first two bytes of each block are encrypted.

==Download==
RLM is available under the terms of the [www.gnu.org/licenses/gpl.html GNU General Public License]. You can download the zip/gz/bz2 compressed source code from [http://hg.kodewerx.org/rlm kwhg] or if you have Mercurial, clone the source code repository with the following command:

hg clone http://hg.kodewerx.org/rlm

==Usage==
$ ./rlm
RLM (Recover Lunar Magic) - v1.2
Copyright 2003-2005 Parasyte

Usage: ./rlm <infile> <outfile>

Where <infile> is the name of the protected Super Mario World ROM, and <outfile> is the filename that you want RLM to create with the unprotected data.

[[Category:Developer Documentation]]

@@ Line 35: / Line 35: @@
 ==Download==
-RLM is available under the terms of the [http://www.gnu.org/licenses/gpl.html GNU General Public License]. You can download the zip/gz/bz2 compressed source code from [http://hg.kodewerx.org/rlm kwhg] or if you have Mercurial, clone the source code repository with the following command:
+RLM is available under the terms of the [https://www.gnu.org/licenses/old-licenses/gpl-2.0.html GNU General Public License]. You can download the zip/gz/bz2 compressed source code from [https://github.com/parasyte/rlm github] or if you have git, clone the source code repository with the following command:
-  hg clone http://hg.kodewerx.org/rlm
+  git clone https://github.com/parasyte/rlm.git
 ==Usage==

← Older revision		Revision as of 04:06, 27 December 2009
Line 1:		Line 1:
	RLM is a program designed to "unprotect" Super Mario World ROM hacks that were "protected" with the Lunar Magic level editor. RLM stands for "Recover Lunar Magic". Also seen in the source code, "Rape Lunar Magic" was once considered.		RLM is a program designed to "unprotect" Super Mario World ROM hacks that were "protected" with the Lunar Magic level editor. RLM stands for "Recover Lunar Magic". Also seen in the source code, "Rape Lunar Magic" was once considered.
		+
		+	==Version History==
		+
		+	v1.3 (12-26-09):
		+	* Fixed yet another last-known-problem with (what I believe is) "Super ExGFX".
		+	* Support for drag-n-drop (see "Using RLM").
		+	* Readme cleanup.
		+
		+	v1.2 (04-18-05):
		+	* Fixed the last known problem with OverWorld decryption.
		+
		+	v1.1 (01-16-05):
		+	* Fixed a problem with OverWorld decryption.
		+	* Changed copyright years from 2003-2004 to 2003-2005.
		+	* Added a version number define to make version changes easier.
		+
		+	v1.0 (01-13-05):
		+	* Initial release!

	==Lunar Magic Protection==		==Lunar Magic Protection==

@@ Line 25: / Line 25: @@
   $ ./rlm
   RLM (Recover Lunar Magic) - v1.3
-  Copyright 2003-2005 Parasyte
+  Copyright 2003-2009 Parasyte (parasyte@kodewerx.org)
   Usage: ./rlm <in-file.smc> [out-file.smc]

@@ Line 7: / Line 7: @@
 Almost everything that Lunar Magic edits will be encrypted with a simple XOR operation, when a hack is protected; unedited stages and objects will remain in their original, unencrypted state.
-The first thing encrypted is the stage pointers. To anyone looking in a hex editor, they appear to point to invalid stage data (because they do). Decrypting these pointers shows you were to find the valid "RATS" headers, as well as encrypted stage data. At this point, decrypting the stage data is enough to open the hack in Lunar Magic. However, the ROM will now work on an SNES or an emulator, due to an assembly hack in place which will try to decrypt the already-decrypted stage data. Reverting the assembly hack will make the ROM playable.
+The first thing encrypted is the stage pointers. To anyone looking in a hex editor, they appear to point to invalid stage data (because they do). Decrypting these pointers shows you were to find the valid "RATS" headers, as well as encrypted stage data. At this point, decrypting the stage data is enough to open the hack in Lunar Magic. However, the ROM will not work on an SNES or an emulator, due to an assembly hack in place which will try to decrypt the already-decrypted stage data. Reverting the assembly hack will make the ROM playable.
 Other edited objects in the ROM are also encrypted in a similar manner. The overworld is a particularly big example. I believe the "ExGFX" are also encrypted.

@@ Line 24: / Line 24: @@
   $ ./rlm
-  RLM (Recover Lunar Magic) - v1.2
+  RLM (Recover Lunar Magic) - v1.3
   Copyright 2003-2005 Parasyte
-  Usage: ./rlm <infile> <outfile>
+  Usage: ./rlm <in-file.smc> [out-file.smc]
-Where <infile> is the name of the protected Super Mario World ROM, and <outfile> is the filename that you want RLM to create with the unprotected data.
+Where <in-file.smc> is the name of the protected Super Mario World ROM, and [out-file.smc] is the file name that you want RLM to create with the unprotected data. Note that [out-file.smc] is optional; if not specified, it will create a new file with the extension of the input file name changed to ".unlocked.smc". For example, "in-file.smc" becomes "in-file.unlocked.smc".
 [[Category:Developer Documentation]]