mauricenino/minecraft-server repository overview

⁠Overview

MauriceNino/minecraft-server is a powerful Python utility and Docker-first environment designed to streamline the deployment and management of stateless Minecraft server instances. Say goodbye to manual plugin updates and messy configuration files.

📖 Check out the Full Documentation Site!⁠

⁠Key Features

• Multi-Platform Support: Native support for Paper, Velocity, and Folia.
• Dynamic Plugin Resolution: Seamlessly download and cache plugins from Modrinth, Hangar, Spiget, or direct URLs.
• Sigil-Based Config Merging: Intelligently merge YAML, JSON, TOML, and .properties files using !replace:, !force:, and !delete: lifecycle sigils.
• Auto-RCON: Integrated mc-rcon module for secure, automated remote console access inside the container.
• Docker-First Architecture: Built for stateless deployments via Docker Compose with deterministic startup routines.

⁠Getting Started

The quickest way to get started is using Docker Compose. Here is a minimal example:

services:
  minecraft:
    image: ghcr.io/MauriceNino/minecraft-server:latest
    environment:
      TYPE: PAPER
      VERSION: latest
      MEMORY: 2G
      PLUGINS: |
        modrinth:luckperms@latest
    ports:
      - "25565:25565"

For more in-depth setup guides, including orchestration scripts runbooks, environment variable dictionaries, and sigil usage, please visit the Documentation⁠.