Troubleshooting

Troubleshooting

Always check the MelonLoader log first: …/Schedule I/MelonLoader/Logs/ (newest file). Side Hustle logs when it initializes, every gamemode that registers, and any problem with a warning.

The "Side Hustle" entry is missing from the main menu

• Mod not loaded? The log should show Side Hustle 1.0.0 ready - N gamemode(s) registered so far. If not, SideHustle.dll is not in …/Schedule I/Mods/, or MelonLoader/S1API are not installed.
• Hidden by the toggle. Check Enabled in the Mod Manager & Phone App UI, or UserData/MelonPreferences.cfg under [SideHustle_01_Main]. Return to the main menu after changing it.
• Menu not laid out yet. The button is injected when the menu scene loads (with a short retry). Backing out to the main menu again re-injects it.

My gamemode does not appear in the list

• Registered too late or not at all? The log should show Gamemode registered: '<Name>' (<id>). Register in your OnInitializeMelon - see API Reference.
• Side Hustle absent at load. Add [assembly: MelonOptionalDependencies("SideHustle")] so the hub loads first, and make sure SideHustle.dll is installed.
• Duplicate id. Registering reuses the row for an existing Id; give each gamemode a unique Id.

Selecting my gamemode does nothing

• Your OnLaunchSingleplayer (for Singleplayer / Hybrid) is null or throws. Check the log for an exception from your callback.
• For a Multiplayer-only gamemode there is no singleplayer launch; Host / Join are not available yet (see Roadmap).

The menu does not come back after my gamemode

Call ctx.ReturnToHub() from your gamemode when it finishes (e.g. on a Back button). If your overlay covered the menu, make sure you also tear it down. OnExitToHub is invoked when Side Hustle initiates the teardown.

Multiplayer / Host / Join is greyed out

That is expected in 1.0.0 - multiplayer launching and the server browser are planned, not shipped yet. See the Roadmap.

Still stuck? 🛟 support.doodesch.de.