Modrinth · Forge

MixinBooter on your Minecraft server

MixinBooter runs on Minecraft servers with Forge. Order your server, set the loader in the panel and install the mod with one click in the mod browser.

The Mixin Library for 1.8 - 1.12.2.

Downloads
2.1M
Author
Cleanroom
Loader
Forge
Minecraft
1.10 – 1.9.4
Updated
–

Setup

Install MixinBooter on your server

The server and players need the same loader and Minecraft version. Back up the world before adding or updating mods.

  1. 01

    Configure

    4 GB of RAM is preselected. You choose the term and add-ons and pay by credit card or PayPal.

  2. 02

    Set the loader

    In the panel, set the server software to Forge and choose the matching Minecraft version, for example 1.9.4.

  3. 03

    Install the mod

    Search the mod browser for “MixinBooter” and install the release for your loader. Alternatively, upload the .jar to the mods folder via SFTP. Required dependencies are listed on the project page.

  4. 04

    Connect

    Every player installs the same MixinBooter release locally and connects using the server address from the panel.

On the server
Required
On the client
Required
Loader
Forge
Minecraft
1.9.4, 1.9.3, 1.9.2 +21 more
License
GNU Lesser General Public License v2.1 only

The panel

Install mods, find errors.

Real screenshots from the Mado panel. Both come with every Minecraft server.

Mod browser

Modrinth and CurseForge, right in the panel.

The browser filters by your Minecraft version. Install mods with one click, without uploading .jar files.

Browser in the Mado panel with search, a CurseForge or Modrinth source switch and install buttons.

AI crash analysis

When a mod crashes, the analyzer reads the log.

Mods often fail on a wrong loader version, Java version or missing dependency. The analyzer names a likely cause and suggests a fix.

Optimization page in the Mado panel with the AI Log Analyzer enabled and a “Server Crashed” notice with an “Analyze Now” button.

Releases

Published releases

Pick the file that matches your server’s loader and Minecraft version. The server and players need the same release.

MixinBooter · Modrinth
Original description by the project author

MixinBooter

Allows any mixins that work on mods to work effortlessly on 1.8 - 1.12.2
Pseudo-Changelog:
  • As of 4.2, MixinBooter's API has changed and all mods that uses mixins are encouraged to depend on MixinBooter, even those that mixin into vanilla/forge/library classes. To avoid mixin version mismatches with mods crashing trying to implement modded mixins (looking at you VanillaFix). Thanks to @embeddedt recommending and helping me introduce this change!

  • As of 5.0, MixinExtras by @LlamaLad7 is shaded. Available for developers to use.

  • As of 8.0, MixinBooter will now work from 1.8 - 1.12.2. One single build works with all these versions! (TODO: LiteLoader support?)

  • As of 8.4, MixinBooter actively attempts to be compatible with SpongeForge

  • As of 9.2, MixinBooter reinstates the older MixinLoader annotation for 1.8.x usages.

  • As of 10.0, MixinBooter follows Mixin 0.8.7

  • As of 11.0, MixinBooter is built on CleanMix. As an effort to create an unified backend with Cleanroom.

    • No longer would you need to declare dependencies for the annotation processor yourself.
    • Also adds a config file (config/mixinbooter.cfg) to blacklist mixin configs and toggle debug options
    • Dedicated logs/mixinbooter.log mixin log. With ability to trace class-loading for precise debugging.
    • Allows traditional MixinConfig + MixinConnector manifest attribute entries to be fully involved in the ecosystem
    • Mod discovery for mixin owners, better isModLoaded checks
    • Suppresses Forge's corrupt zip warnings
    • Phased out mixin "phases"
For Developers ~ Getting Started:
  1. Add CleanroomMC's repository and depend on MixinBooter's maven entry:
repositories {
    maven {
        url 'https://maven.cleanroommc.com'
    }
}

dependencies {
    def mixin = 'zone.rong:mixinbooter:11.0'
    
    implementation (mixin) {
        transitive = false
    }
    annotationProcessor mixin

    // RetroFuturaGradle for refmap generation:
    modUtils.enableMixins(mixin)
    // modUtils.enableMixins(mixin, 'mod_id.mixins.refmap.json') << add refmap name as 2nd arg (optional)
}
  1. Pick how to register your mixin configurations. MixinBooter supports lots of approaches:

(As of 11.0, early/late divide is no longer present, therefore IEarly/ILateMixinLoaders are deprecated)

  • MixinConfigs manifest attribute: no loader class needed. Add a space-separated list of your mixin configuration names to your jar's manifest. MixinBooter reads it straight from the jar's manifest and registers them.
  • MixinConnector manifest attribute: register configs programmatically. Point it at a class implementing org.spongepowered.asm.mixin.connect.IMixinConnector, its connect() is called during boot, where you call Mixins.addConfiguration(...) yourself.

Both manifest attributes are set on your jar task:

jar {
    manifest {
        attributes(
                'MixinConfigs': 'mixins.mymod.json',
                'MixinConnector': 'com.example.mymod.MyMixinConnector'
        )
    }
}
public class MyMixinConnector implements IMixinConnector {
    
    @Override
    public void connect() {
        // Check if mod is loaded before registering?
        // Possible with zone.rong.mixinbooter.service.ModDiscoverer.isModPresent(String modId)
        Mixins.addConfiguration("mixins.mymod.json");
    }
    
}

FAQ

MixinBooter questions

Question not listed? Ask our team.

MixinBooter server crashes on startup – what to do?

Common causes: the loader or Minecraft version does not match the mod file, a dependency is missing, or RAM is too low. Check the log (latest.log) for “OutOfMemoryError”, “Mixin” or missing mods. At Mado, the AI crash analysis reads the log and suggests a cause. You can change the loader and version in the panel.

Which loader does MixinBooter run on?

According to Modrinth, MixinBooter supports Forge for Minecraft 1.9.4, 1.9.3, 1.9.2.

How much RAM does a server with MixinBooter need?

As guidance, 3–4 GB for a server with this mod. This is an estimate, not a measured minimum. More mods, many players and long view distances need more. The spark profiler shows whether a mod is costing tick time.

Ready for your server with MixinBooter?

4 GB of RAM from €8.00 per month. 35% off your first month with MADO35.

Order server