Add MUDCraft Minecraft server infrastructure

- Purpur 1.21.4 server via itzg/docker-minecraft-server (java21)
- StatefulSet with 3 PVCs: worlds (20Gi), plugins (5Gi), logs (5Gi)
- Aikar G1GC JVM flags, 6GB heap (sized for Legion's 15GB RAM)
- Postgres: mudcraft database + user in existing platform/postgres
- RCON secret + DB password via ExternalSecret → Vault
- Traefik TCP entrypoint on port 25565 for mudcraft.nook.family
- mudcraft namespace via Terraform
- Argo CD app watching k8s/mudcraft/
This commit is contained in:
Will Anderson
2026-03-29 18:17:42 -05:00
parent 9161ab0104
commit 1cf47477d3
9 changed files with 296 additions and 0 deletions
+20
View File
@@ -0,0 +1,20 @@
apiVersion: argoproj.io/v1alpha1
kind: Application
metadata:
name: mudcraft
namespace: argocd
spec:
project: default
source:
repoURL: http://10.43.1.53:3000/will/infrastructure.git
targetRevision: main
path: servers/legion/k8s/mudcraft
destination:
server: https://kubernetes.default.svc
namespace: mudcraft
syncPolicy:
automated:
prune: true
selfHeal: true
syncOptions:
- CreateNamespace=true
@@ -0,0 +1,62 @@
---
apiVersion: v1
kind: ConfigMap
metadata:
name: mudcraft-config
namespace: mudcraft
data:
# itzg/docker-minecraft-server env-based config
# These are injected as env vars — the entrypoint generates server.properties
TYPE: "PURPUR"
VERSION: "1.21.4"
DIFFICULTY: "hard"
MAX_PLAYERS: "40"
VIEW_DISTANCE: "8"
SIMULATION_DISTANCE: "6"
ALLOW_FLIGHT: "true"
ONLINE_MODE: "true"
SPAWN_PROTECTION: "0"
MAX_TICK_TIME: "-1"
RATE_LIMIT: "0"
ENFORCE_WHITELIST: "true"
WHITELIST_ENABLED: "true"
ENABLE_RCON: "true"
RCON_PORT: "25575"
MOTD: "MUDCraft — Private Beta"
MEMORY: "" # Disabled — we set JVM flags directly
JVM_OPTS: >-
-Xms6G -Xmx6G
-XX:+UseG1GC
-XX:+ParallelRefProcEnabled
-XX:MaxGCPauseMillis=200
-XX:+UnlockExperimentalVMOptions
-XX:+DisableExplicitGC
-XX:+AlwaysPreTouch
-XX:G1NewSizePercent=30
-XX:G1MaxNewSizePercent=40
-XX:G1HeapRegionSize=8M
-XX:G1ReservePercent=20
-XX:G1HeapWastePercent=5
-XX:G1MixedGCCountTarget=4
-XX:InitiatingHeapOccupancyPercent=15
-XX:G1MixedGCLiveThresholdPercent=90
-XX:G1RSetUpdatingPauseTimePercent=5
-XX:SurvivorRatio=32
-XX:+PerfDisableSharedMem
-XX:MaxTenuringThreshold=1
-XX:+UseStringDeduplication
-Djava.awt.headless=true
-Dfile.encoding=UTF-8
-Dusing.aikars.flags=https://mcflags.emc.gs
-Daikars.new.flags=true
# Bukkit spawn limits — keep lower than default; MythicMobs adds custom mobs on top
OVERRIDE_BUKKIT_CONFIG: |
spawn-limits:
monsters: 40
animals: 8
water-animals: 3
water-ambient: 8
ambient: 4
ticks-per:
monster-spawns: 2
animal-spawns: 400
@@ -0,0 +1,23 @@
---
apiVersion: external-secrets.io/v1beta1
kind: ExternalSecret
metadata:
name: mudcraft-secrets
namespace: mudcraft
spec:
refreshInterval: 1h
secretStoreRef:
name: vault
kind: ClusterSecretStore
target:
name: mudcraft-secrets
creationPolicy: Owner
data:
- secretKey: db-password
remoteRef:
key: secret/data/legion-db
property: mudcraft_db_password
- secretKey: rcon-password
remoteRef:
key: secret/data/mudcraft
property: rcon_password
@@ -0,0 +1,15 @@
---
# Traefik TCP route — exposes mudcraft.nook.family:25565 → mudcraft service
apiVersion: traefik.io/v1alpha1
kind: IngressRouteTCP
metadata:
name: mudcraft-minecraft
namespace: mudcraft
spec:
entryPoints:
- minecraft
routes:
- match: HostSNI(`*`)
services:
- name: mudcraft
port: 25565
+39
View File
@@ -0,0 +1,39 @@
---
apiVersion: v1
kind: PersistentVolumeClaim
metadata:
name: mudcraft-worlds
namespace: mudcraft
spec:
accessModes:
- ReadWriteOnce
storageClassName: local-path
resources:
requests:
storage: 20Gi
---
apiVersion: v1
kind: PersistentVolumeClaim
metadata:
name: mudcraft-plugins
namespace: mudcraft
spec:
accessModes:
- ReadWriteOnce
storageClassName: local-path
resources:
requests:
storage: 5Gi
---
apiVersion: v1
kind: PersistentVolumeClaim
metadata:
name: mudcraft-logs
namespace: mudcraft
spec:
accessModes:
- ReadWriteOnce
storageClassName: local-path
resources:
requests:
storage: 5Gi
+32
View File
@@ -0,0 +1,32 @@
---
# ClusterIP — Traefik TCP route targets this
apiVersion: v1
kind: Service
metadata:
name: mudcraft
namespace: mudcraft
spec:
selector:
app: mudcraft
ports:
- name: minecraft
port: 25565
targetPort: 25565
protocol: TCP
type: ClusterIP
---
# RCON — internal only, for server management
apiVersion: v1
kind: Service
metadata:
name: mudcraft-rcon
namespace: mudcraft
spec:
selector:
app: mudcraft
ports:
- name: rcon
port: 25575
targetPort: 25575
protocol: TCP
type: ClusterIP
@@ -0,0 +1,89 @@
---
apiVersion: apps/v1
kind: StatefulSet
metadata:
name: mudcraft
namespace: mudcraft
labels:
app: mudcraft
spec:
replicas: 1
serviceName: mudcraft
selector:
matchLabels:
app: mudcraft
template:
metadata:
labels:
app: mudcraft
spec:
terminationGracePeriodSeconds: 120
containers:
- name: mudcraft
image: itzg/minecraft-server:java21
imagePullPolicy: Always
ports:
- name: minecraft
containerPort: 25565
protocol: TCP
- name: rcon
containerPort: 25575
protocol: TCP
envFrom:
- configMapRef:
name: mudcraft-config
env:
- name: RCON_PASSWORD
valueFrom:
secretKeyRef:
name: mudcraft-secrets
key: rcon-password
- name: DB_URL
value: "jdbc:postgresql://postgres-postgresql.platform.svc.cluster.local:5432/mudcraft"
- name: DB_USER
value: "mudcraft"
- name: DB_PASSWORD
valueFrom:
secretKeyRef:
name: mudcraft-secrets
key: db-password
volumeMounts:
- name: worlds
mountPath: /data/worlds
- name: plugins
mountPath: /data/plugins
- name: logs
mountPath: /data/logs
resources:
requests:
memory: 7Gi
cpu: 2000m
limits:
memory: 8Gi
cpu: 6000m
lifecycle:
preStop:
exec:
command: ["/bin/sh", "-c", "rcon-cli stop && sleep 15"]
readinessProbe:
tcpSocket:
port: 25565
initialDelaySeconds: 60
periodSeconds: 15
failureThreshold: 10
livenessProbe:
tcpSocket:
port: 25565
initialDelaySeconds: 120
periodSeconds: 30
failureThreshold: 5
volumes:
- name: worlds
persistentVolumeClaim:
claimName: mudcraft-worlds
- name: plugins
persistentVolumeClaim:
claimName: mudcraft-plugins
- name: logs
persistentVolumeClaim:
claimName: mudcraft-logs
+10
View File
@@ -27,3 +27,13 @@ resource "kubernetes_namespace" "external_secrets" {
}
}
}
resource "kubernetes_namespace" "mudcraft" {
metadata {
name = "mudcraft"
labels = {
managed-by = "terraform"
tier = "game"
}
}
}
+6
View File
@@ -19,6 +19,12 @@ resource "kubernetes_manifest" "traefik_config" {
web:
redirectTo:
port: websecure
minecraft:
port: 25565
expose:
default: true
exposedPort: 25565
protocol: TCP
YAML
}
}