SK-404

Doc no. SK-404DatasheetRev 2026.11Sheet 2.9 of 4

A3

mc-server-manager

One command and a terminal dashboard to create, run and back up Minecraft servers on your own machine. It never deletes a world.

Active

01

Block diagram

mcTyper · Textual mcctlinstance.json tmuxmc-<name> ServerJava · RCON backups/never deletes
Fig. 1: From command to running server
02

Characteristics

LoadersCreates Fabric, Quilt, NeoForge, Forge, Paper and vanilla servers in one command, fetching the matching Java runtime
SupervisionRuns each world in a named tmux session or Docker container, backed by launchd (macOS) / systemd (Linux) auto-restart
Mods & packsSearches and installs Modrinth mods with dependency resolution; mc mods doctor catches conflicts and wrong loaders
BackupsWrites verified world archives with retention rules; restores preserve your existing world rather than overwriting blindly
NetworkingSupports LAN, SSH/VPS deployment (mc deploy) and optional isolated ProtonVPN port-forward container
  • Python
  • tmux
  • Modrinth
03

Overview & build notes

mc manages the entire lifecycle of self-hosted Minecraft worlds on macOS or Linux without fragile shell snippets. Running mc opens a full-screen Textual TUI showing TPS, player roster, console logs, mod conflicts and backup state; every action is also available from direct subcommands.

Each server lives cleanly in its own folder with an instance.json descriptor, automated pre-upgrade snapshots (mc upgrade) and RCON hooks for countdown warnings before restarts.

mc doctor inspects JVM args, open ports, server tick health, backup integrity and mod JAR metadata, while mc support redacts tokens, passwords and IP addresses before copying diagnostics.

04

Figures & renders

Terminal screenshot of the mc dashboard showing a running server with three players and 20 TPS
Fig. 2 Dashboard overview: active world state, player list, tick rate (20 TPS) and recent events
Live console tab inside the mc Textual TUI
Fig. 3 Live console tab streaming server output, RCON commands and player join/leave events
Verified world backup management screen inside the TUI
Fig. 4 Backups view showing verified archive history and safe non-destructive restore options
05

Files & artifacts

KindFileDetailsSize
DocsCOMMANDS.mdFull CLI reference for server lifecycle, Modrinth mods, backups and networking13 KB
DocsDOCKER.mdContainerized server runtime and isolated VPN port-forwarding guide18 KB
Sourcemc/Typer CLI and Textual TUI package on GitHubGitHub
Setupinstall.shCreates an isolated Python environment and links mc onto PATHGitHub