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:25565minecraft.kiefermenard.com→paper:25565rlcraft.kiefermenard.com→rlcraft:25565
Components run as separate containers on a shared Docker network (minecraft-net):
mc-router(entrypoint, only public listener on25565)paper(Paper1.21.5, lighter/main server)rlcraft(Forge1.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.
- Account at TCPShield: network with backend
<home_WAN_IP>:25565(the port the router forwards to Prawn). - Cloudflare DNS: set
mc,minecraft, andrlcraft(FQDNs under your zone) to CNAME targets at TCPShield’s provided hostname — DNS-only (grey cloud). - 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
- 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. - 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)¶
- Admin console → Machines → find Prawn →
...→ Share → enter friend's email. - Friend receives invite email → installs Tailscale app → logs in → accepts share.
- Give friend Prawn’s MagicDNS name (e.g.
prawn.tail1234.ts.net) or its100.x.x.xIP — find it under Machines in the admin console. - 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:
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
DEFAULTmust be a sibling key underenvironment, not a line inside theMAPPINGblock.- Changing env vars requires
docker compose up -d(ordown/up) —docker compose restartdoes 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:
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):
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) andrlcraft.kiefermenard.com(RLCraft) — DNS-only CNAME to TCPShield; router forwards25565to Prawn10.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)¶
- Cloudflare (grey cloud):
mc,minecraft, andrlcraftCNAME to TCPShield. Players connect to TCPShield; clean traffic is forwarded to your WAN IP:25565. - Router: WAN 25565/tcp →
10.0.0.21:25565(mc-routeron Prawn). - 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.
Router port forwards (game-related)¶
| 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 restartdoes not reload changed environment variables — usedocker compose up -d(or recreate) after editingmc-routerenv.- ProtocolLib must match the Paper / Minecraft version (5.4.0+ for 1.21.5).
mc-routerDEFAULTmust not be pasted inside theMAPPINGmultiline string.- Leviathon DSM 7.1.x has no Compose projects UI — use
docker runon 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.
Related work¶
- projects/Homelab-Mac-Mini-Hosts — Seamoth / Prawn split
- projects/Self-Hosted-Services — homelab overview; Tailscale roles, Leviathon
- projects/Home-Network —
10.0.0.0/24addressing; Seamoth10.0.0.20, Prawn10.0.0.21, Leviathon10.0.0.10