Minecraft-Eggs
GitHub
Server types

Every engine the egg can run,
with real minimums.

All 19 SERVER_TYPE values with supported versions, default ports, runtime requirements and the variables needed for a minimal install.

Engine catalog

Vanilla
SERVER_TYPE=vanilla
Official Mojang server jar straight from the version manifest. Set MINECRAFT_VERSION to latest-snapshot for snapshots.
VersionsAlpha – 26.x + snapshots
Default port:25565
RuntimeAuto Java 8 – 26
Min settingsSERVER_TYPEMINECRAFT_VERSION
Paper
SERVER_TYPE=paper
High-performance server with the rich Paper plugin API. Pin an exact build with BUILD_NUMBER.
Versions1.7 – 26.x · all builds
Default port:25565
RuntimeAuto Java 8 – 26
Min settingsSERVER_TYPEMINECRAFT_VERSIONBUILD_NUMBER
Purpur
SERVER_TYPE=purpur
Feature-packed Paper fork with configurable gameplay mechanics. Build pinning via BUILD_NUMBER.
Versions1.14 – 26.x · all builds
Default port:25565
RuntimeAuto Java 8 – 26
Min settingsSERVER_TYPEMINECRAFT_VERSIONBUILD_NUMBER
Folia
SERVER_TYPE=folia
Regionised multi-threaded tick loop from PaperMC upstream, for very high player counts.
Versions1.19 – 26.x · all builds
Default port:25565
RuntimeAuto Java 17 – 26
Min settingsSERVER_TYPEMINECRAFT_VERSIONBUILD_NUMBER
Spigot
SERVER_TYPE=spigot
Classic Bukkit/Spigot runtime; BuildTools compilation runs inside the container automatically.
Versions1.8 – 26.x
Default port:25565
RuntimeAuto Java 8 – 26
Min settingsSERVER_TYPEMINECRAFT_VERSION
Fabric
SERVER_TYPE=fabric
Ultra-lightweight modular mod loader installed from Fabric meta. Loader version is pinnable.
Versions1.14 – 26.x · all loaders
Default port:25565
RuntimeAuto Java 8 – 26
Min settingsSERVER_TYPEMINECRAFT_VERSIONLOADER_VERSION
Quilt
SERVER_TYPE=quilt
Community-driven open mod loader with backward compatibility for Fabric mods.
Versions1.14 – 26.x · all loaders
Default port:25565
RuntimeAuto Java 8 – 26
Min settingsSERVER_TYPEMINECRAFT_VERSIONLOADER_VERSION
Forge
SERVER_TYPE=forge
Classic mod loader. Java 8 is selected automatically for 1.12.2 / 1.7.10; 1.17+ launches through a generated @unix_args.txt.
Versions1.1 – 26.x · all loaders
Default port:25565
RuntimeAuto Java 8 – 26
Min settingsSERVER_TYPEMINECRAFT_VERSIONLOADER_VERSION
NeoForge
SERVER_TYPE=neoforge
Modern Forge fork. The installer runs the official installer and LOADER_VERSION accepts a full NeoForge build (e.g. 21.1.148).
Versions1.20.1 – 26.x · all loaders
Default port:25565
RuntimeAuto Java 17 – 26
Min settingsSERVER_TYPEMINECRAFT_VERSIONLOADER_VERSION
Mohist
SERVER_TYPE=mohist
Forge + Bukkit hybrid: run Forge mods and Bukkit/Spigot plugins on the same server.
Versions1.7.10 · 1.12.2 · 1.16.5 · 1.20.1
Default port:25565
RuntimeAuto Java 8 – 17
Min settingsSERVER_TYPEMINECRAFT_VERSIONBUILD_NUMBER
Magma
SERVER_TYPE=magma
Open-source Forge & Spigot hybrid server jar.
Versions1.12.2 · 1.16.5 · 1.20.1
Default port:25565
RuntimeAuto Java 8 – 17
Min settingsSERVER_TYPEMINECRAFT_VERSIONBUILD_NUMBER
Velocity
SERVER_TYPE=velocity
Next-generation proxy. velocity.toml is created automatically and its bind address is patched to the panel port; stop is translated to end.
Versions1.x – 4.x · all builds
Default port:25577
RuntimeJava 21
Min settingsSERVER_TYPEMINECRAFT_VERSIONBUILD_NUMBER
BungeeCord
SERVER_TYPE=bungeecord
Classic proxy connecting multiple backends. config.yml listeners are bound to the allocated port; stop is translated to end.
VersionsNewest upstream
Default port:25577
RuntimeJava 21
Min settingsSERVER_TYPE
Waterfall
SERVER_TYPE=waterfall
PaperMC's upgraded BungeeCord fork with improved networking and stability.
Versions1.7 – 1.20 · all builds
Default port:25577
RuntimeJava 21
Min settingsSERVER_TYPEMINECRAFT_VERSIONBUILD_NUMBER
Bedrock (BDS)
SERVER_TYPE=bedrock
Official Mojang Bedrock Dedicated Server: runs the native binary directly, no Java involved.
VersionsEvery official release
Default port:19132
RuntimeNative (no Java)
Min settingsSERVER_TYPEMINECRAFT_VERSION
Nukkit
SERVER_TYPE=nukkit
High-throughput Java implementation of Minecraft: Bedrock Edition.
VersionsNewest upstream
Default port:19132
RuntimeJava 21
Min settingsSERVER_TYPE
PocketMine-MP
SERVER_TYPE=pocketmine
High-performance Bedrock server written in PHP with a rich plugin ecosystem.
VersionsNewest upstream
Default port:19132
RuntimePHP 8.x
Min settingsSERVER_TYPE
GitHub Releases
SERVER_TYPE=github
Install a server jar straight from any GitHub repo. Release assets (.jar/.zip) are preferred; repos without releases are cloned as source.
VersionsAny release or tag
Default port:25565
RuntimeAuto
Min settingsSERVER_TYPEGITHUB_REPOGITHUB_TAGGITHUB_ASSETGITHUB_TOKEN
Custom Engine
SERVER_TYPE=custom
Executes CUSTOM_COMMAND, or run.custom.sh if you provide one alongside your files.
VersionsBring your own jar / script
Default port:Configurable
RuntimeAny
Min settingsSERVER_TYPECUSTOM_COMMAND

Java auto-selection

Leave JAVA_VERSION empty and the launcher picks the right JVM: downloading it on demand into .java/ when the image doesn't ship it. Override with any of: 8172126

Minecraft versionRuntimeNotes
26.x and newerJava 26Future-proofed for the newest releases
1.20.5 – 1.21.xJava 21Standard LTS runtime for modern Minecraft
1.17 – 1.20.4Java 17Caves & Cliffs through Trails & Tales
1.16.5 and olderJava 8First-class legacy modpack support (1.12.2 / 1.7.10)
Proxies / NukkitJava 21Velocity, BungeeCord, Waterfall, Nukkit
Bedrock / PocketMineNative / PHPBDS is a native binary; PocketMine runs on PHP 8.x

Version fallback

MINECRAFT_VERSION accepts latest, latest-snapshot (vanilla snapshots) or an exact version. For Velocity/Waterfall it is the software version (e.g. 4.0.0), for Bedrock the BDS version (e.g. 1.26.44.3). Invalid versions fall back to latest instead of failing the install.

SERVER_TYPE       velocity   # proxy: version = Velocity release
MINECRAFT_VERSION 3.4.0-SNAPSHOT

SERVER_TYPE       bedrock    # engine: version = BDS release
MINECRAFT_VERSION latest
← Previous
Egg Catalog
Next →
Examples