Selecting a Mod Platform
Mod platforms are selected by setting theMODPACK_PLATFORM environment variable. For ease of use and backward compatibility, you can also use TYPE or MOD_PLATFORM.
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
| Platform | Auto-Update | API Key Required | Version Pinning | Recommended For |
|---|---|---|---|---|
| Auto CurseForge | Yes | Yes | Yes | Most CurseForge modpacks |
| Modrinth | Yes | No | Yes | Modrinth-hosted modpacks |
| FTBA | Yes | No | Yes | FTB App modpacks |
| GTNH | Yes | No | Yes | GT 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
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.