This article will go into some basic tasks when it comes to using the tools included in the baserom since it is a little different from a typical setup.

Contents

• Adding or Removing Asar Patches
• Adding Sprites with PIXI
• Adding Blocks with GPS
• Adding UberASM with UberASMTool
• Adding Music with AddMusicK

Adding or Removing Asar Patches

In the baserom, Asar patches are managed by the Callisto build tool and are all applied at build time. The files for all included patches are kept in subfolders the resources/patches folder.

To add a new patch:

1. Copy the your patch file into to the resources/patches folder. You can quickly get there using the button in Lunar Magic.
2. Add its path to the list in "resources.toml". Pressing the button in Lunar Magic will open this list in a text editor.

To remove a patch:

1. Delete (or comment out) the reference to that patch from that same list in "resources.toml".
2. You are free to delete the patch file from resources/patches, but this isn't necessary.

Any changes made to the patches list will be applied the next time you run the "Rebuild" or "Update" action.

Adding Sprites with PIXI

To add downloaded sprites to your project:

1. Open the tools/pixi folder (you can do this right from Lunar Magic with the button) and add your sprite files to the relevant folders in this directory.
2. Update PIXI's "list.txt" with the new sprite. Pressing the button in Lunar Magic will open this list in a text editor.
3. Do not run pixi.exe manually. Instead run the "Update" action in an open Callisto window or press the button in Lunar Magic to insert the new sprites.

For a more in-depth explanation of how to use PIXI, check out this tutorial on SMW Central.

Adding Blocks with GPS

To add downloaded blocks to your project:

1. Open the tools/gps folder (you can do this right from Lunar Magic with the button) and add your block files to the relevant folders in this directory.
2. Update GPS's "list.txt" with the new blocks, take care to not overwrite blocks that are already present in the baserom or use a Block ID that is already used. Pressing the button in Lunar Magic will open this list in a text editor.
3. Do not run gps.exe manually. Instead run the "Update" action in an open Callisto window or press the button in Lunar Magic to insert the new blocks.

When inserting. it is recommended to start with Page 4 addresses to avoid conflicts with the baserom's blocks.

For a more in-depth explanation of how to use GPS, check out this tutorial on SMW Central.

Adding UberASM with UberASMTool

To add new UberASM to your project:

1. Open the tools/uberasmtool folder (you can do this right from Lunar Magic with the button) and add your UberASM files to the relevant folders in this directory.
2. Update UberASMTool's "list.txt" with your changes, take care to not remove UberASM that is already present in the baserom. Pressing the button in Lunar Magic will open this list in a text editor.
3. Do not run UberASMTool.exe manually. Instead run the "Update" action in an open Callisto window or press the button in Lunar Magic to insert the new UberASM.

For a more in-depth explanation of how to use UberASMTool, check out UberASMTool's included README in the docs/tools folder..

Adding Music with AddMusicK

To add new music to your project:

1. Open the tools/addmusick folder (you can do this right from Lunar Magic with the button) and add your music files to the relevant folders in this directory.
2. Update the "Addmusic_list.txt" with your changes. Pressing the button in Lunar Magic will open this list in a text editor.
3. Do not run any AddMusicK.exe manually. Instead run the "Update" action in an open Callisto window or press the button in Lunar Magic to insert the new music or sound effects.

For a more in-depth explanation of how to use AddMusicK, check out AddMusicK's included README in the docs/tools folder.