The Multi Minecraft egg,
end to end.

Egg facts

Docker images

One universal, multi-arch image (linux/amd64 + linux/arm64) serves every server type, and the launcher provisions the required JVM on demand, so no per-engine images exist.

Startup & stop

The startup command never changes; the launcher dispatches per SERVER_TYPE on boot. The panel stop command is stop and startup completion markers include “Done (…)!”, “Listening on” and “Server started.”.

bash run.sh

Config auto-patching on boot: server.propertiesconfig.ymlvelocity.toml (ports and bind addresses are rewritten to the panel allocation).

Panel features

• eula: the panel prompts to accept the Minecraft EULA on first start
• java_version: the panel exposes a Java version selector wired to the egg's auto-detection
• pid_limit: the panel raises the process limit for multi-process servers

Egg self-update

EGG_UPDATE_URL (default: the upstream egg JSON in this repository) is checked on every startup when AUTO_UPDATE_EGG=1; when it changes, the launcher scripts refresh automatically, with no re-import needed. It can also point at a raw .sh URL to update the launcher directly.

Variables

All 34 variables, grouped. User variables are editable by server owners in the panel; Admin ones are reserved for node administrators.

Raw egg JSON

A real excerpt from egg-minecraft-multi.json. Get the full file here or see it rendered on the Examples page.

{
  "name": "Multi Minecraft",
  "docker_images": {
    "Universal (Auto Java)": "ghcr.io/potenfyr-studios/minecraft-eggs:latest"
  },
  "startup": "bash run.sh",
  "features": [
    "eula",
    "java_version",
    "pid_limit"
  ],
  "sample_variable": {
    "env_variable": "SERVER_TYPE",
    "default_value": "vanilla",
    "rules": "required|string|in:vanilla,paper,spigot,purpur,folia,forge,neoforge,fabric,quilt,mohist,magma,bungeecord,velocity,waterfall,bedrock,nukkit,pocketmine,github,custom"
  }
}