MauriceNino/minecraft-server
A modular Python utility and Docker environment to manage Minecraft server instances. Dynamic plugin resolution, sigil-based config merging, and automated RCON injection.
Up and running in seconds
docker-compose.yml
services: minecraft: image: ghcr.io/mauricenino/minecraft-server:latest environment: TYPE: PAPER VERSION: 1.21.4 MEMORY: 2G ACCEPT_EULA: true PLUGINS: | modrinth:luckperms@latest hangar:viaversion@latest volumes: - ./data:/data/runtime ports: - "25565:25565"
Supported Platforms
Paper
Purpur
Folia
Vanilla
Spigot
Bukkit
Velocity
Waterfall
Everything you need
One image, every platform, fully automated.
Multi-Platform
Paper, Purpur, Folia, Velocity, Waterfall, Vanilla, Spigot, and Bukkit — all centrally managed from one core image.
Plugin Resolution
Modrinth, Hangar, Spiget, Github releases, CurseForge and direct URLs with lockfile-based caching.
Config Merging
Deep-merge YAML, JSON, TOML, and .properties with sigil-based control.
Template Orchestration
Advanced declarative file lifecycles with !replace:, !force:, and !delete: sigils.
Auto-RCON
Automatic RCON bridge injection per platform — zero config needed.
Docker-First
Multi-arch images on GHCR and Docker Hub. PID 1 Java handover via os.execvp.
Supported Plugin Loaders
Modrinth
Hangar
Spiget
Github
CurseForge
URL