Skip to content

Game servers

Status

In progress — Minecraft on Prawn with two Java server variants behind mc-router: Paper (mc.kiefermenard.com) and RLCraft (rlcraft.kiefermenard.com). The public path uses TCPShield (grey-cloud DNS) + router forward to mc-router:25565; see projects/Game-Servers#tcpshield-ddos-protection-for-minecraft.

Host (2026-10-22): Prawn (LAN 10.0.0.21, Tailscale 100.91.255.109, tag:gameserver) came back online after being offline since ~mid-September. The 2026-09-26 note was Tailscale offline for ~13 days; the cause of that outage was not recorded. All CPU threads were pinned at 100% because of memory pressure: three Minecraft servers had 15G of heap on 15 GiB of RAM. Heaps were lowered to Paper 1G/3G, RLCraft 1G/4G, abyssal-ascent 1G/4500M (fixed, 2026-10-22). CPU now runs about 78–86 °C; cleaning the fan is suggested.

Hardware

Machine Hostname Role
Mac Mini (Macmini5,1) Prawn Game server host — Paper + RLCraft active; Satisfactory and Archipelago planned
Synology DS216+II Leviathon Tailscale subnet router (NAS); not used for game servers

Design decisions

Access model: two tiers

Scenario Method Why
Small group (trusted friends) Tailscale node share No exposed ports, no DDoS surface, per-person access revocable instantly
Semi-public (open to more players) TCPShield + port forward Grey-cloud CNAME to TCPShield hides the home WAN from players; UFW on Prawn allows only TCPShield prefixes on 25565; ISP still provides baseline protection

Why not a VPN like Hamachi? Tailscale is the modern equivalent — one app install, log in with Google/GitHub/Microsoft, done. No fiddly network config or NAT traversal issues.

Why not a Cloudflare subdomain reverse proxy? Synology's built-in reverse proxy is HTTP/HTTPS only. Game server traffic is raw TCP/UDP and bypasses it entirely. Public Minecraft names use DNS-only records (grey cloud): CNAME to TCPShield, which terminates player TCP and forwards clean traffic to the home forward.

Why not Cloudflare Spectrum? Spectrum does proxy raw TCP/UDP and provides DDoS mitigation, but requires the Pro plan ($20/month) plus $1/GB overage. Not worth it at this scale.

Host

All game servers run in Docker on Prawn (Macmini5,1, Ubuntu 24.04, 10.0.0.21). Home services (Jellyfin, Home Assistant, Technitium DNS primary) run on Seamoth — projects/Homelab-Mac-Mini-Hosts.

Minecraft architecture (current)

mc-router handles hostname routing so multiple servers can share one public port:

  • mc.kiefermenard.com → paper:25565
  • minecraft.kiefermenard.com → paper:25565
  • rlcraft.kiefermenard.com → rlcraft:25565

Components run as separate containers on a shared Docker network (minecraft-net):

  • mc-router (entrypoint, only public listener on 25565)
  • paper (Paper 1.21.5, lighter/main server)
  • rlcraft (Forge 1.12.2, modded hardcore)

Hardware capability

The Mac Mini (i5-2415M, 2 cores/4 threads, 2.3 GHz, 16GB RAM) is a 2011 machine with limited headroom:

Game Mac Mini capable? Notes
Minecraft Java ✅ Yes Manageable for small vanilla/lightly modded group
Archipelago ✅ Yes Extremely lightweight, no issue
Satisfactory (early game) ⚠️ Borderline Satisfactory's simulation loop is single-threaded; 2011-era single-core performance is below the recommended spec
Satisfactory (mid/late game) ❌ No Factory simulation load will cause unplayable performance

Satisfactory is better suited to a more powerful machine or a cheap VPS if needed long-term.

DDoS / security posture

TCPShield fronts Minecraft TCP: players resolve mc / minecraft / rlcraft (under kiefermenard.com) to a TCPShield CNAME, not directly to the home WAN. UFW on Prawn restricts 25565/tcp to TCPShield’s published IPv4 ranges (see projects/Game-Servers#tcpshield-ddos-protection-for-minecraft), so random internet hosts cannot hammer mc-router on the forwarded port. Paper runs the TCPShield plugin (with ProtocolLib) so real player IPs are restored; RLCraft (Forge) has no plugin — connections still work, but player IPs appear as TCPShield’s. Whitelist and normal server hygiene cover application-layer abuse.


TCPShield (DDoS protection for Minecraft)

TCPShield proxies Minecraft connections and keeps the residential WAN out of the public game path.

  1. Account at TCPShield: network with backend <home_WAN_IP>:25565 (the port the router forwards to Prawn).
  2. Cloudflare DNS: set mc, minecraft, and rlcraft (FQDNs under your zone) to CNAME targets at TCPShield’s provided hostname — DNS-only (grey cloud).
  3. UFW on Prawn — allow TCPShield ranges only, then deny the port to everyone else (ranges change; maintain from TCPShield IPv4 list):
sudo ufw allow from <tcpshield-cidr> to any port 25565 proto tcp
# repeat per published CIDR
sudo ufw deny 25565/tcp
sudo ufw enable
  1. Paper: install TCPShield (plugins/TCPShield.jar) and ProtocolLib (5.4.0+ for Paper 1.21.5 / MC 26.1.2). Plugin forwards real client IPs to Paper.
  2. RLCraft: no TCPShield plugin on Forge 1.12.2 — acceptable for a whitelisted server; moderators see proxy IPs for connections that come through TCPShield.

Tailscale access (small group)

How it works

Tailscale on Prawn provides a tailnet address for the game host (tag:gameserver). Seamoth is the exit node for full members but does not host game ports for shared users — see projects/Self-Hosted-Services#tailscale-remote-access-to-the-home-lan. Friends are invited as shared users to Prawn via the Tailscale admin console, install the app, accept the share, and connect to Prawn’s 100.x.x.x Tailscale IP (or MagicDNS name) in the game client. No ports are exposed to the public internet for that path.

Leviathon (NAS) is the subnet router for 10.0.0.0/24 so members can reach static LAN services remotely. Home LAN layout: projects/Home-Network.

Tailscale ACL / grants config

The tailnet uses a grants-only policy. The full policy:

{
    "tagOwners": {
        "tag:gameserver": ["autogroup:owner"],
    },

    "grants": [
        // Full members (you) get unrestricted access to all owned machines.
        {"src": ["autogroup:member"], "dst": ["autogroup:member"], "ip": ["*"]},

        // Allow members to route through the home subnet via NAS subnet router.
        {"src": ["autogroup:member"], "dst": ["10.0.0.0/24"], "ip": ["*"]},

        // Allow exit node usage for members.
        {"src": ["autogroup:member"], "dst": ["autogroup:internet"], "ip": ["*"]},

        // Shared users (friends) can only reach game server ports on tagged machines.
        {"src": ["autogroup:shared"], "dst": ["tag:gameserver"], "ip": ["25565", "7777", "15777"]},
    ],

    "ssh": [
        {
            "action": "check",
            "src":    ["autogroup:member"],
            "dst":    ["autogroup:self"],
            "users":  ["autogroup:nonroot", "root"],
        },
    ],
}

Prawn is tagged tag:gameserver in the Tailscale admin console (Machines tab → ... → Edit tags). Seamoth is not shared with game friends.

Why the grants matter: without the restriction, a shared user could reach all open ports on a shared node — including Home Assistant (8123), Jellyfin (8096), and Pi-hole admin (80) if those lived on the same machine. Splitting games to Prawn and limiting grants to tag:gameserver keeps shared users on game ports only.

Why the subnet grant matters: the 10.0.0.0/24 grant allows member devices (you) to reach home LAN IPs via Leviathon's subnet router. Without it, only Tailscale IPs (100.x.x.x) are reachable remotely — LAN IPs (10.0.0.x) time out. The live tailnet ACL has been updated from 192.168.0.0/24 to 10.0.0.0/24 to match the LAN move; keep the wiki JSON and admin policy aligned with projects/Home-Network and the route advertised on Leviathon.

Ports covered

Port Protocol Game
25565 TCP Minecraft Java
7777 UDP Satisfactory
15777 UDP Satisfactory (query)

Add Archipelago or other servers to the ip list in the grants config as needed.

Inviting a friend (runbook)

  1. Admin console → Machines → find Prawn → ... → Share → enter friend's email.
  2. Friend receives invite email → installs Tailscale app → logs in → accepts share.
  3. Give friend Prawn’s MagicDNS name (e.g. prawn.tail1234.ts.net) or its 100.x.x.x IP — find it under Machines in the admin console.
  4. Friend connects in-game to that address on the relevant port.

Revoking access

Machines → Prawn → ... → Sharing → remove the user. Access is cut instantly.


Minecraft (active)

Setup

Minecraft stack is split across three compose projects:

~/docker/minecraft/
├── mc-router/docker-compose.yml
├── paper/docker-compose.yml
└── rlcraft/docker-compose.yml

Create shared network once:

docker network create minecraft-net

mc-router compose (~/docker/minecraft/mc-router/docker-compose.yml):

services:
  mc-router:
    image: itzg/mc-router:latest
    container_name: mc-router
    restart: unless-stopped
    ports:
      - "25565:25565"
    environment:
      MAPPING: |
        mc.kiefermenard.com=paper:25565
        minecraft.kiefermenard.com=paper:25565
        rlcraft.kiefermenard.com=rlcraft:25565
      DEFAULT: paper:25565
      CONNECTION_RATE_LIMIT: "5"
    networks:
      - minecraft-net

networks:
  minecraft-net:
    external: true

Compose gotchas

  • DEFAULT must be a sibling key under environment, not a line inside the MAPPING block.
  • Changing env vars requires docker compose up -d (or down / up) — docker compose restart does not re-read environment.

paper compose (~/docker/minecraft/paper/docker-compose.yml):

services:
  paper:
    image: itzg/minecraft-server
    container_name: paper-server
    restart: unless-stopped
    environment:
      EULA: "TRUE"
      TYPE: "PAPER"        # or VANILLA, FABRIC, FORGE
      VERSION: "LATEST"
      MEMORY: "4G"
      DIFFICULTY: "normal"
      SERVER_PORT: 25565
      WHITELIST: "KmanKten"
      ENABLE_WHITELIST: "TRUE"
      ENFORCE_WHITELIST: "TRUE"
    volumes:
      - ./data:/data
    networks:
      - minecraft-net
    # No external ports — router handles it

networks:
  minecraft-net:
    external: true

Installed plugins on Paper: LuckPerms, WorldEdit, WorldGuard, CoreProtect, Spark, ProtocolLib (5.4.0+ for Paper 1.21.5), TCPShield (2.8.1+), Chunky (pregen; resume survives restarts).

RLCraft: mod configs live under ~/docker/minecraft/rlcraft/data/config/ (mod pack configs, not Paper).

rlcraft compose (~/docker/minecraft/rlcraft/docker-compose.yml):

services:
  rlcraft:
    image: itzg/minecraft-server:java8-multiarch   # Important: RLCraft is 1.12.2 → needs Java 8
    container_name: rlcraft-server
    restart: unless-stopped
    environment:
      EULA: "TRUE"
      TYPE: "FORGE"
      VERSION: "1.12.2"
      MEMORY: "6G"
      WHITELIST: "KmanKten"
      ENABLE_WHITELIST: "TRUE"
      ENFORCE_WHITELIST: "TRUE"

      # Modpack settings
      MODPACK_PLATFORM: "AUTO_CURSEFORGE"
      CF_SLUG: "rlcraft"
      CF_FILENAME_MATCHER: "2.9."          # Matches common recent versions (e.g. 2.9.3). Adjust if needed
      CF_FORCE_SYNCHRONIZE: "true"         # Forces re-download/check on startup (good for first run)
      CF_API_KEY: ${CF_API_KEY}

      # Highly recommended
      SERVER_PORT: 25565
    volumes:
      - ./data:/data
    networks:
      - minecraft-net

networks:
  minecraft-net:
    external: true

Installed mods on RLCraft: Spark, VanillaFix.

Management commands

Start stack:

cd ~/docker/minecraft/mc-router && docker compose up -d
cd ~/docker/minecraft/paper && docker compose up -d
cd ~/docker/minecraft/rlcraft && docker compose up -d

View logs:

docker logs -f paper-server
docker logs -f rlcraft-server

Open server console (RCON):

# Paper
cd ~/docker/minecraft/paper && docker compose exec paper rcon-cli

# RLCraft
cd ~/docker/minecraft/rlcraft && docker compose exec rlcraft-server rcon-cli

Op yourself (Paper example):

cd ~/docker/minecraft/paper && docker compose exec paper rcon-cli "op YOUR_MINECRAFT_USERNAME"

Resource allocation rationale

Prawn has 16GB RAM. Current target allocation:

Container Memory
Paper server 3G
RLCraft server 6G (can increase to 7-8G if needed)
Other host services + OS Keep total system usage under ~13-14G

Monitor with htop and docker stats.

Access

  • Tailscale (trusted friends): connect to Prawn’s Tailscale IP or MagicDNS name on port 25565
  • Public entrypoint (TCPShield): mc.kiefermenard.com / minecraft.kiefermenard.com (Paper) and rlcraft.kiefermenard.com (RLCraft) — DNS-only CNAME to TCPShield; router forwards 25565 to Prawn 10.0.0.21.
  • DDNS / zone: proxied web names and general zone maintenance — projects/Self-Hosted-Services#ddns-cloudflare-seamoth; game hostnames are CNAMEs to TCPShield (not orange-cloud A records).

Whitelist

Enable in server.properties (white-list=true) for invite-only access. Keep online-mode=true. Manage via /whitelist add <username> in the server console.


Port forward

How it works (Minecraft, current)

  1. Cloudflare (grey cloud): mc, minecraft, and rlcraft CNAME to TCPShield. Players connect to TCPShield; clean traffic is forwarded to your WAN IP:25565.
  2. Router: WAN 25565/tcp → 10.0.0.21:25565 (mc-router on Prawn).
  3. Prawn: UFW allows only TCPShield source prefixes on 25565 — see projects/Game-Servers#tcpshield-ddos-protection-for-minecraft.

Full router table (HTTP/S + Minecraft): projects/Home-Network#router-port-forwards-wan-lan.

Game External port Internal IP Internal port Protocol
Minecraft Java 25565 10.0.0.21 25565 TCP
Satisfactory 7777 10.0.0.21 7777 UDP
Satisfactory (query) 15777 10.0.0.21 15777 UDP

Only open ports for servers that are actively running.

Public subdomains (Minecraft)

Server Subdomain(s)
Paper mc.kiefermenard.com, minecraft.kiefermenard.com
RLCraft rlcraft.kiefermenard.com
Satisfactory (planned) sf.kiefermenard.com
Archipelago (planned) ap.kiefermenard.com

Minecraft names stay DNS-only (grey cloud) and point at TCPShield, not the orange-cloud HTTP proxy.

Operational gotchas

  • docker compose restart does not reload changed environment variables — use docker compose up -d (or recreate) after editing mc-router env.
  • ProtocolLib must match the Paper / Minecraft version (5.4.0+ for 1.21.5).
  • mc-router DEFAULT must not be pasted inside the MAPPING multiline string.
  • Leviathon DSM 7.1.x has no Compose projects UI — use docker run on the NAS when you need non-trivial container flags (Watchtower, iGotify, etc.) — projects/Self-Hosted-Services.

Limitations of home hosting

A residential upload connection (typically 20–50 Mbps) caps practical player count regardless of hardware. At ~1–5 Mbps per Minecraft player, expect a max of roughly 10–20 concurrent players before degradation. For larger counts, a cheap VPS (e.g. Hetzner from ~$5/month) is the community standard.


Planned servers

Game Status Notes
Minecraft Paper (1.21.5) ✅ Active Routed by mc-router; public DNS via TCPShield (mc / minecraft)
Minecraft RLCraft (Forge 1.12.2) ✅ Active Routed by mc-router; public DNS via TCPShield (rlcraft); no TCPShield plugin (Forge)
Satisfactory 📋 Planned Mac Mini may struggle mid/late game; consider desktop or VPS
Archipelago 📋 Planned Lightweight, Mac Mini suitable

Next steps / TODO

  • Tune RLCraft configs (mob caps, Lycanites spawn settings)
  • Add automated backups for both worlds and configs
  • Add WorldGuard region protection examples/runbook
  • Run multiplayer performance testing and adjust RAM split as needed
  • Prawn CPU (2026-10-22): back online after ~mid-September offline (100.91.255.109, tag:gameserver). All CPU threads were pinned at 100% because of memory pressure: three Minecraft servers had 15G of heap on 15 GiB of RAM. Heaps were lowered to Paper 1G/3G, RLCraft 1G/4G, abyssal-ascent 1G/4500M (fixed, 2026-10-22). CPU now runs about 78–86 °C; cleaning the fan is suggested.