Mod Setup

This page will explain how to use the Reloaded II Mod Loader to create a custom stage mod for Sonic Heroes. Note that we must use Reloaded II, not Heroes Mod Loader and not the first Reloaded Mod Loader.

Steps

1. First of all, you should be able to open Reloaded II and play other Sonic Heroes mods with it. If you don't know how to do that, see this page.
2. Follow this guide to understand how to create a new blank Heroes mod in Reloaded II.
3. Alternatively, you can also copy the folder for another stage mod (I recommend Shadowth's Radical Highway as it contains the proper file structure and no additional code files),

If you have trouble understanding how to set up your folders and files, please examine the files of another stage mod yourself to see how it's done.

Mod Folder Structure

Your mod folder must have the same name of your mod ID (for example: sonicheroes.stages.testcustomstage). This will go in Reloaded II's Mods folder. This folder contains a Stages folder, a ModConfig.json file and a Preview.png file. You must edit the ModConfig.json file in a text editor to match your mod's info.

One single Reloaded II mod can contain only one, or multiple different stages. Each stage much be in a separate folder, each of these folders must be in the Stages folder. You can give these folders any name you want.

In each stage folder, you will find a folder named Files and two files named Stage.json and Splines.json. You must create the Files folder, but you do not need to create these files manually. Heroes Power Plant is able to generate them.

Note the folder path on top of the image. Inside the Files folder, there must be a dvdroot folder, which then will mimic the structure of the actual game's dvdroot folder. The files for a stage will all be located in the dvdroot folder, or in one of its sub-folders.

Use the Mod Loader Config Editor to create the Stage.json file and save it in the proper place. Splines.json will be created and updated automatically by the Spline Editor.

The individual files for each aspect of the stage (ONE files, BIN files, TXD files, CL files...) are all managed by their respective editors. Some of them must be copied from the original game and then edited, while others must be created in HPP.