CraftOps

Modern CLI for Minecraft server operations and Modrinth mod management — built with Go.

Features

• Lifecycle — Start, stop, and restart your server via GNU screen sessions
• Mods — Automated updates from Modrinth with concurrent downloads, retries, and dry-run support
• Backups — Compressed .tar.gz archives with configurable retention and glob-based exclusion patterns
• Alerts — Discord webhook notifications for restarts and warnings
• Health — Integrated diagnostic suite for paths, dependencies, and API connectivity

Requirements

• Linux or macOS (amd64 or arm64)
• GNU screen
• Java 17+ (host installs; not required inside Docker)

Install

One-liner (recommended)

curl -fsSL https://raw.githubusercontent.com/dacrab/craftops/main/install.sh | bash

Pin a specific version:

VERSION=v2.3.0 bash <(curl -fsSL https://raw.githubusercontent.com/dacrab/craftops/main/install.sh)

From source

Requires Go 1.25+:

make install

Docker

docker pull ghcr.io/dacrab/craftops:latest

Quick Start

# 1. Generate a default config
craftops init-config

# 2. Edit the config
$EDITOR ~/.config/craftops/config.toml

# 3. Verify everything looks good
craftops health-check

# 4. Start your server
craftops server start

See craftops --help for all commands and flags.

Documentation

• Configuration reference
• Contributing & development

License

MIT