Skip to main content
Mod platform types allow you to automatically install modpacks along with their required mod loaders (Forge, Fabric, Quilt, etc.). The modpack platforms handle downloading declared mods/plugins and applying additional configuration files.

Selecting a Mod Platform

Mod platforms are selected by setting the MODPACK_PLATFORM environment variable. For ease of use and backward compatibility, you can also use TYPE or MOD_PLATFORM.
environment:
  MODPACK_PLATFORM: AUTO_CURSEFORGE
  # or
  TYPE: MODRINTH
  # or
  MOD_PLATFORM: FTBA

Available Platforms

Auto CurseForge

Automated CurseForge modpack installation with upgrade support

Modrinth

Modrinth modpacks with automatic mod loader installation

Feed The Beast

FTB Application modpacks with automatic setup

GregTech New Horizons

Specialized setup for the GTNH modpack

Platform Comparison

PlatformAuto-UpdateAPI Key RequiredVersion PinningRecommended For
Auto CurseForgeYesYesYesMost CurseForge modpacks
ModrinthYesNoYesModrinth-hosted modpacks
FTBAYesNoYesFTB App modpacks
GTNHYesNoYesGT New Horizons specifically
The VERSION environment variable is used to declare the Minecraft version (e.g., 1.19.4). Each platform has specific variables for qualifying their version in addition to the Minecraft version.

Common Features

All mod platforms provide:
  • Automatic mod loader installation (Forge, Fabric, Quilt)
  • Dependency resolution and downloading
  • Configuration file management
  • Upgrade and downgrade support
  • Cleanup of old files
World data is never automatically removed during modpack updates. Your saves are always preserved.

Java Version Compatibility

Different modpacks require different Java versions. Use the appropriate image tag:
  • Java 8: itzg/minecraft-server:java8
  • Java 17: itzg/minecraft-server:java17
  • Java 21: itzg/minecraft-server:java21
  • Java 25: itzg/minecraft-server:java25
Most modern modpacks require at least 4GB of memory. Set MEMORY to at least 4G for optimal performance.

Next Steps

Choose a mod platform from the left navigation to see detailed setup instructions and configuration options.

Build docs developers (and LLMs) love