The Romhack Races baserom is a Callisto-based project so the directory structure is best set-up for using that tool.
All the readme files for the baserom (like the one you're currently reading) and those for other included resources and tools are stored here for your convenience.
| Item | Description |
|---|---|
| baserom_readme | The folder containing all the baserom's readme files. |
| retry-system | The readme files for the retry system. |
This folder contains all modified resources exported by Callisto from Lunar Magic. Things in this folder are your
| Item | Description |
|---|---|
| global | Folder for all global resources in a rom that are exported by callisto. |
| levels | Pretty self-evident, all the exported level files. |
| all_map16.map16 | A full export of your project's Map16. |
| shared_palettes.pal | A full export of your project's shared palette. |
All the build resources for you project are in here. Patches, initial setup files, map16, palettes, etc.
| Item | Description |
|---|---|
| initial_patches | Contains a clean BPS patch for each FastROM and SA-1 that are used by Callisto when building the rom. |
| map16 | Import-able Map16 template files for a bunch of things in the baserom. |
| original_graphics | A back-up of the original, unmodified vanilla graphics in case they are needed. |
| palettes | Import-able palette files for things in the baserom, namely the Poison Mushroom and Pink berry. |
| patches | All of the Asar patches that Callisto applies at build time. |
A folder with files used by the scripts used to setup the baserom.
| Item | Description |
|---|---|
| functions | Contains some Powershell files that are functions used by the main script. |
| lists | The baserom's list files that are copied into each tool directory during set-up. |
| pixi | Contains a file to fix PIXI ASM during setup to resolve a conflict with UberASM Tool. |
| usertoolbar | The files for the baserom's custom user toolbar that is used with Lunar Magic. |
| baserom_setup.ps1 | The main setup Powershell script. |
| tool_defines.ps1 | A Powershell file that defines tool versions, download links and files. |
This folder contains files that are shared between tools and resources, typically variable definitions and configuration files.
| Item | Description |
|---|---|
| callisto | Files used by Callisto across all resources. |
| defines | A folder of common definitions for resources. |
| freeram.asm | A file containing all used FreeRAM as shared defines. |
This folder is where all the baserom tools are kept as well as any files and resources they use. If you are adding things to your project, you are adding them to the folders in this folder.
Do not run the tools from these folder directly. Callisto takes care of running all tools when using it.
| Item | Description |
|---|---|
| AddMusicK | The folder for AddMusicK and related files. . |
| Callisto | Contains the Callisto build tool. |
| Flips | Contains Floating IPS tool for creating BPS patches. |
| GPS | Contains the GPS block insertion tool and related files. |
| LunarMagic | Folder for Lunar Magic. |
| PIXI | Contains the PIXI sprite insertion tool and related files. |
| UberASMTool | Contains UberASMTool and all related files. |
This folder is where your project lives and is the output directory for the build process. It will contain your project's rom, its Graphcs and ExGraphics, as well as any auxillary files used by the tools.
| Item | Description |
|---|---|
| ExGraphics | Folder containing all the baserom ExGraphics. |
| Graphics | Folder containing all the exported vanilla graphics. |
| sysLMRestore | Not included in the baserom, but will appear when starting work in Lunar Magic as part of its restore feature. |
| *.dsc | File that has all the block descriptions that show up in Lunar Magic. Generated by GPS. |
| *.extmod | This is a bit of metadata generated by UberASMTool stating its version number. |
| *.m16 | Internal Map16 data for how vanilla sprites display in Lunar Magic. |
| *.msc | File generated by AddMusicK that Lunar Magic uses to display custom music in its menus. |
| *.mw2 | Contains metadata for displaying sprites with their graphics in Lunar Magic. |
| *.mwt | Metadata file that Lunar Magic uses to display sprites in the list of "Collections of Custom Sprites". Generated by PIXI. |
| *.s16 | Internal Map16 data for how custom sprites display in Lunar Magic. Updated by PIXI. |
| *.smc | This is your hack. |
| *.ssc | File that has all the sprites descriptions that appear in Lunar Magic. Generated by PIXI. |