Skip to main content

Poly Mod Loader

Fabric, Forge, NeoForge and Quilt in one mod loader

A mod loader for Minecraft: Java Edition.Before the game starts, Poly Mod Loader checks your mods.Mods that cannot run are left out of the launch, with the reason in the log.

DownloadInstall guide

Poly Mod Loader 0.1.0-alpha.19 · Minecraft 26.1, 26.1.1, 26.1.2, 26.2 · Windows, macOS, Linux

Install in three steps

  1. Download the installerWindows: the .exe. macOS and Linux: the .jar (Java 17 or newer).
  2. Run itStart vanilla Minecraft once first, and close the launcher while the installer runs.
  3. Pick the profile and playChoose the Poly Mod Loader profile in the Minecraft Launcher. Mods go in the mods folder.

What runs today

Status in Poly Mod Loader 0.1.0-alpha.19. Details and error codes are in Compatibility.

  • Poly Mods

    Supported

    Mods written for Poly Mod Loader’s own API.They run on the client and on servers.

  • Forge

    Supported

    Runs Forge and FML themselves, also next to Fabric mods.On 26.1 and 26.2, popular Forge mods (40 on 26.2) play a world together, save it and quit. The only mods left out are ones Forge refuses too.

  • Fabric

    Supported

    Runs Fabric mods the way Fabric Loader does, Mixin included.On 26.1 and 26.2, popular Fabric mods (138 on 26.2, Sodium and Iris among them) play a world together, save it and quit.

  • NeoForge

    Not supported

    Support is on the way.Until then, NeoForge mods are left out of the launch, and the log lists the NeoForge features each one needs.

  • Quilt

    Not supported

    Support is on the way.quilt.mod.json is not read yet.A Quilt mod that also has fabric.mod.json runs as a Fabric mod.

For mod developers: Poly Mods

Poly Mods use Poly Mod Loader’s Native API instead of Minecraft’s internal classes.The API is in preview and can still change.

Start a Poly Mod

  • One build for several versions

    A mod that only uses the API can declare a range such as 26.* instead of one exact Minecraft version.

  • Works next to Fabric mods

    Poly Mods and Fabric mods can depend on each other.

  • Errors that say what to fix

    A wrong declaration stops the game at startup with a POLY error code, instead of crashing later in a world.

  • Tests in the real game

    Game tests run on a test server without a window, with mock players.

Buy me a coffee