thearst3rd/miuu-mod-loader
Code Issues Pull requests Projects Releases 1 Packages Wiki Activity Actions
Basic mod loader for Marble It Up! Ultra
5 commits 1 branch 1 tag 44 KiB
  • C# 100%
Find a file
Exact
Terry Hearst 2f4342497b Add link to releases page
2026-05-10 01:10:11 -04:00
.editorconfig Initial commit 2023-10-05 23:03:32 -04:00
.gitignore Build system/instruction updates for Linux 2026-05-10 00:23:24 -04:00
Entrypoint.cs Initial commit 2023-10-05 23:03:32 -04:00
LICENSE Add License 2023-10-05 23:05:21 -04:00
ModLoader.csproj Build system/instruction updates for Linux 2026-05-10 00:23:24 -04:00
ModLoader.sln Initial commit 2023-10-05 23:03:32 -04:00
README.md Add link to releases page 2026-05-10 01:10:11 -04:00
UserProperties.xml.template Build system/instruction updates for Linux 2026-05-10 00:23:24 -04:00

README.md

Marble It Up! Ultra Mod Loader

A very simple mod loader for Marble It Up! Ultra, utilizing Unity Doorstop. In theory, this will probably work with lots of other Unity games due to its simplicity.

Installation

To install the mod loader:

  1. Download the mod loader for your platform from the Releases page
  2. Navigate to your Marble It Up! Ultra installation directory
    • In Steam, you can find this directory by right clicking on Marble It Up! Ultra in the library and navigating to "Manage" -> "Browse local files"
    • On Windows, this will probably be something along the lines of C:\Program Files (x86)\Steam\steamapps\common\Marble It Up!
  3. Extract the zip file into this directory
  4. Put any mods you want to use in your Mods directory
  5. Linux/MacOS only: In Steam, right click on Marble It Up! Ultra in the library, open Properties..., and in the launch options text field, enter the following:
    • ./run.sh %command%
  6. Start the game and you should be good to go!

Build

If you just want to use the mod loader, refer to the Usage section above. These instructions are if you want to compile the mod loader itself.

  1. Clone the git repository
  2. Download Harmony (v2.4.2 as of writing) and extract 0Harmony.dll for net48 into the directory <miuu install>/Mods/ModLoader.
  3. Copy UserProperties.xml.template into UserProperties.xml and edit it:
    • Edit GameDir to point to the directory of your MIUU installation.
    • Linux only: Edit GameDataDir to $(GameDir)/MarbleItUp_Data
  4. Open the project, e.g. open ModLoader.sln in Visual Studio or open the repository in vscode with the C# extension
  5. Build the project, e.g. click Build -> Build Solution in Visual Studio, or run dotnet build --configuration Release. It will build directly into the Mods/ModLoader directory.
  6. Download Unity Doorstop (v4.5.0 as of writing) for your platform and extract the x64 version (universal for MacOS) into your MIUU install directory.
  7. Edit doorstop_config.ini (Windows) or run.sh (Linux/MacOS):
    • Change target_assembly to Mods/ModLoader/ModLoader.dll
    • Change dll_search_path_override to Mods/ModLoader
    • Optional but recommended (Windows only): Change redirect_output to true
  8. Linux/MacOS only: In Steam, right click on Marble It Up! Ultra in the library, open Properties..., and in the launch options text field, enter the following:
    • ./run.sh %command%
  9. You should now be able to launch Marble It Up! Ultra with the mod loader.