Live demo
Open source · MIT

Run 7 Days to Die servers without ever SSH’ing in.

Mastermind is a full-stack control plane and Go host agent: safe restarts, live map, mod quarantine, backups, schedules, Discord alerts and a Steam-verified player portal — with every action queued, audited and attributed.

MIT License Latest release Last commit GitHub stars TypeScript Go NestJS Next.js PostgreSQL Redis Docker
Demo admin — pre-filled on the login page
Email demo.admin@mastermind.demo · Password DemoAdmin!2026
Static mock data in your browser. No backend, nothing is stored.
Mastermind mascot seated on a golden throne
20k+lines of TypeScript
10k+lines of Go
60+commits across 15 releases
29automated test files

What it does

Built from real operator pain: restarts that lose progress, mod updates that break the world, and staff who need access without shell keys. The demo exercises each of these.

⚡

Safe restart & stability policy

Countdown, save, backup, kick verification and restart — plus a memory watcher that triggers the same flow automatically.

⌖

Live map

Official terrain with players, hostiles, animals, claims and region grid; history from 5 minutes to 72 hours.

◇

Mod quarantine & AI-reviewed config

Quarantine, restore, merge compatible settings, and approve AI-proposed edits only after a mandatory diff review.

♟

Players & moderation

Roster, inventory, kick/ban/promote, chat filters, high-ping and country policies, all attributed to an account.

▣

Backups & schedules

Full-world and region snapshots, retention, cron or simple schedules, overlap prevention and Blood Moon safety.

♡

Player portal & donations

Steam OpenID–gated profiles, public map, and a Stripe-backed supporter shop with signed-webhook fulfilment.

Try each feature in the demo →

Architecture

The public web app never touches telnet, save files or the game process. Work is queued through the control plane and executed locally by a paired agent.

 ┌──────────────────────────── CONTROL PLANE ─────────────────────────────┐
 │  Next.js UI ◄─► NestJS API + WebSocket ◄─► PostgreSQL · Redis/BullMQ   │
 └──────────────┬──────────────────────────────────────┬──────────────────┘
        HTTPS / WS │                                     │ job queue · heartbeat
                   ▼                                     ▼
 ┌──────────────── HOST (Go agent) ───────────────────────────────────────┐
 │ one-time pairing · versioned heartbeat · job runner · game adapters    │
 │                       └────►  7 Days to Die server (telnet / Allocs)   │
 └─────────────────────────────────────────────────────────────────────────┘

1 · Click

Staff triggers an action in the dashboard.

2 · Authorize

Role checked; job enqueued per server.

3 · Execute

Agent runs it locally via an allow-listed adapter.

4 · Audit

Output and initiating account return to the UI.

Engineering highlights

Decisions that matter beyond the feature list.

Security by design

Salted scrypt with legacy migration, persistent hashed-bucket login throttling, JWT agent identity with key rotation, encrypted integration secrets, signed Stripe webhooks, and a documented security audit.

Reliable job pipeline

BullMQ queues with serialized mutations, bounded read concurrency, jittered retries, stale-run recovery, backpressure and overlap prevention for scheduled work.

Privacy boundary

Public endpoints expose only server name and player count. Positions, IPs, telnet output and tokens stay behind Steam-verified or staff auth.

Documented & maintained

Architecture, ERD, release context and design docs per feature, a protected main branch, PR templates and a detailed changelog.

Tech stack

NestJSTypeScriptNext.js 14 / ReactPrismaPostgreSQL 16Redis 7 + BullMQWebSocketsGo 1.22 agentDocker Composepnpm workspacesStripeDiscord APISteam OpenIDsystemd

Run it yourself

Requires Docker, Node 20, pnpm 9 and Go 1.22.

  1. Clone and configure
    git clone https://github.com/248Tech/Mastermind-7DTD-AI-Server-Manager.git
    cd Mastermind-7DTD-AI-Server-Manager
    # set BOOTSTRAP_ADMIN_EMAIL and BOOTSTRAP_ADMIN_PASSWORD in infra/.env
  2. Start everything
    make start
  3. Sign in at http://localhost:3000/login, then pair a host from Hosts → Pair New Host.

Full quickstart · User guide · Changelog