ALL TUTORIALS IN THIS .TXT FILE ARE WRITTEN WITH THIS BASEROM'S TOOL LOCATIONS IN MIND!

---Asar---
Note: Asar's tutorial is here for completeness sake. For the group project, the need for Asar outside of my own (Jamie's) needs is not advised as it can heavily mess things up. Thank you <3

1. Open the patch .zip file you got from SMWCentral

2. Place the patch from the .zip file into the Asar Folder (or elsewhere, its just for cleanliness)

3. Open Asar.exe. Click and drag the custom patch file onto the Asar window, then hit enter.

4. Repeat the above step with your rom file.

5. Reload your rom in Lunar Magic

   Congratulations! You've officially inserted a custom patch! :D

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

---AddMusicK---

Inserting unsampled Music Tutorial:

1. Open up the custom music .zip file you got from SMWCentral

2. Click and drag the custom song's .txt file from the .zip file into the music folder within the AddMusicK folder.

3. Open "Addmusic_list.txt"

4. Scroll to the bottom and create a new line. Type in the number you wish to insert the song into,
   then type the EXACT name of the custom music .txt file, then save the file. (Example | 29  Super Jinsei Game - Goodbye.txt)

5. Open AMKGUI.exe, if all steps were followed correctly, your custom song should appear in the Local Songs list in the GUI.

6. Press the "Run" button in the application, this will prompt you to select your rom. 
   Rom should be located within the main Passion folder provided you have not moved it elsewhere.
   Select the rom, AddMusicK will run automatically, inserting your song.

7. Reload your rom in Lunar Magic, and click the note block icon near the middle of the top toolbar.
   Check the "Bypass the music header setting." box
   Click the box right below that, and scroll to your custom song. Click it, and then click okay.

   Congratulations! You've officially inserted an unsampled song! :)

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

Inserting Sampled Music Tutorial:

1. Open up the custom music .zip file you got from SMWCentral

2. Click and drag the custom song's .txt file from the .zip file into the music folder within the AddMusicK folder.

3. There should be a folder in the custom music .zip file, drag that folder into the "samples" folder in the AddMusicK folder.

4. If your song came with a file named "Sample Groups.txt" or very very similar (not the samples folder!), open that and copy its contents with Ctrl + C.
   Open the file of the same name in the AddMusicK folder, scroll to the bottom and create two new lines (Shift + Enter twice)
   Paste in what you copied earlier.

5. Open "Addmusic_list.txt"

6. Scroll to the bottom and create a new line. Type in the number you wish to insert the song into,
   then type the EXACT name of the custom music .txt file, then save the file. (Example | 2A  109 Corneria.txt)

7. Open AMKGUI.exe, if all steps were followed correctly, your custom song should appear in the Local Songs list in the GUI.

8. Press the "Run" button in the application, this will prompt you to select your rom. 
   Rom should be located within the main Passion folder provided you have not moved it elsewhere.
   Select the rom, AddMusicK will run automatically, inserting your song.

9. Reload your rom in Lunar Magic, and click the note block icon near the middle of the top toolbar.
   Check the "Bypass the music header setting." box
   Click the box right below that, and scroll to your custom song. Click it, and then click okay.

   Congratulations! You've officially inserted a sampled song! :)

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

---GPS---

Inserting Custom Blocks Tutorial:

1. Open the custom block zip file you got from SMWCentral. 

2. Click and drag the .asm file within to the "blocks" folder within the GPS folder.

3. Open "list.txt" within the GPS folder.
   In Lunar Magic, locate the ID of the tile you wish to insert your custom block to from the Map16 Tile Map Editor Menu. (? Block Icon in the tool bar)
   for this example, we'll use tile 206.

4. Type the ID of the tile you want to insert the block into, add a space, then type the EXACT name of your block's .asm file.
   (Example: 206 ledgevine.asm) Then save the txt file.

5. Open GPS.exe, then click and drag your rom file into the GPS window, then hit Enter.

6. Refresh Lunar Magic for the custom block's descriptions to load properly.

   Congratulations! You've officially inserted a custom block! :D

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

---Pixi---
Note: A number of sprites will come with extra things. Such as files you need to put in Pixi's Routine's folder, extended folder, cluster folder, and so on.
This tutorial only teaches you how to do basic sprites. However, most sprites come with the files already in labled folders. You should be able to logic it out!

1. Open the custom sprite .zip file you got from SMWCentral.

2. Click and Drag the .asm and .cfg (or .json) into the sprites folder in the Pixi folder. 
   (Note: .cfg and .json are interchangeable. Only difference is that .json gives Lunar Magic the information to visually display your sprite in editor instead of a Pink X)

3. Open the "list.txt" file within the main baserom folder, where the rom is.

4. Make a new line under the SPRITES: Category and type the number you want to insert your sprite into, and a space, then the EXACT name of the .cfg or .json your sprite came with,
   including the file extension. Then save the file.

5. Open Pixi.exe, click and drag your rom file into the Pixi window, then hit enter.

6. Reload your rom in Lunar Magic for the custom sprite to appear in the sprites list.

   Congratulations! You've officially inserted a custom sprite! :D

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

---UberASM---
Note: Just like Pixi above, UberASM files can have a number of variables in the insertion process. This tutorial teaches the basics.

1. Open the custom UberASM .zip file you got from SMWCentral.

2. Click and drag the UberASM file inside the .zip file into the "level" folder in the UberASM Folder.

3. Open "list.txt" within the UberASM Folder. Under the "level:" label, make a new line and type the ID of the level you are inserting your UberASM Code into,
   add a space, then the EXACT name of your UberASM file (file extension included). Save the txt file.

4. Open "UberASMTool.exe" and let it do its thing. Hit enter once its done.

5. Reload your rom in Lunar Magic to avoid any errors.

   Congratulations! You've officially inserted UberASM Code! :D


In case you want to add another UberASM file to the same level...

In your list.txt file, add a , and a space after the UberASM file you added above. Now you can add another UberASM File to the same level!
Just make sure to get the file name exact with the extension.









