@minecraft-docker/mcctl
v1.7.9
Published
CLI tool for managing Docker Minecraft servers with mc-router
Downloads
3,109
Maintainers
Readme
@minecraft-docker/mcctl
CLI tool for managing Docker Minecraft servers with mc-router.
Features
- Multi-server management with hostname-based routing
- Auto-scaling: Servers start on connect, stop when idle
- Interactive mode: Guided prompts for all operations
- World management: Assign and release worlds between servers
- Backup system: GitHub-based world backup and restore
Installation
npm install -g @minecraft-docker/mcctlQuick Start
# Initialize platform in ~/minecraft-servers
mcctl init
# Create a new server (interactive)
mcctl create
# Create with arguments
mcctl create myserver -t PAPER -v 1.21.1
# Check server status
mcctl status
# Start/stop servers
mcctl start myserver
mcctl stop myserver
# View logs
mcctl logs myserverCommands
| Command | Description |
|---------|-------------|
| mcctl init | Initialize the platform |
| mcctl create [name] | Create a new server |
| mcctl delete [name] | Delete a server |
| mcctl status | Show all server status |
| mcctl start <name> | Start a server |
| mcctl stop <name> | Stop a server |
| mcctl logs <name> | View server logs |
| mcctl world list | List all worlds |
| mcctl world assign | Assign world to server |
| mcctl world release | Release world from server |
| mcctl backup push | Backup worlds to GitHub |
| mcctl backup restore | Restore worlds from backup |
Server Types
| Type | Description |
|------|-------------|
| PAPER | Paper server (default, recommended) |
| VANILLA | Official Minecraft server |
| FORGE | Forge mod server |
| FABRIC | Fabric mod server |
Requirements
- Node.js >= 18.0.0
- Docker & Docker Compose
- Linux or macOS
Changelog
v1.7.9 (2026-02-03)
- fix(ci): Fix YAML syntax error in E2E workflow configuration
- Resolve CI pipeline failure due to malformed YAML
v1.7.8 (2026-01-31)
- feat(cli): Add selective console service support - choose api/console/all (#203)
- fix(cli): Correct environment variable names for mcctl-api auth (#203)
v1.7.7 (2026-01-31)
- feat(cli): Auto-install mcctl-api on console init
- Streamlined Admin Service setup process
v1.7.6 (2026-01-31)
- feat(mcctl-api): First npm release of REST API package
- Add @minecraft-docker/mcctl-api to npm registry
v1.7.5 (2026-01-31)
- fix: Resolve Edge runtime error in mcctl-console middleware (#201)
v1.7.4 (2026-01-31)
- docs: Add CHANGELOG.md with v1.7.1-1.7.3 hotfix history
AI Assistant
Get help using mcctl with our AI-powered assistant:
- AI Assistant chatbot - Interactive Q&A about mcctl commands, configuration, and troubleshooting
You can also use the LLM Knowledge Base with ChatGPT, Claude, or other AI assistants:
- Download the knowledge base document
- Upload to your preferred AI assistant
- Ask questions about mcctl usage
Documentation
License
Apache-2.0
