diff --git a/10-systems/hosts/minecraft-server.md b/10-systems/hosts/minecraft-server.md new file mode 100644 index 0000000..f359347 --- /dev/null +++ b/10-systems/hosts/minecraft-server.md @@ -0,0 +1,29 @@ +--- +owner: gmikcon +status: active +last_reviewed: 2026-10-07 +review_interval: 90d +confidence: high +source_of_truth: ssh-host-verified +--- + +# Minecraft Server (mine) + +Vanilla Minecraft server on host `mine` (192.168.1.160), port 25565. + +## Service + +- systemd unit: `minecraft-server-vanilla.service` (user `minecraft`, WorkingDirectory `/home/minecraft/server-vanilla`). +- ExecStart: screen session `mc-server` running `java -Xms4G -Xmx14G -jar server.jar nogui` (Java 25). +- `Restart=on-failure`. GOTCHA: a plain `stop` typed into the screen session exits java with non-zero status, systemd counts it as failure and RESPAWNS the server. To stop for real: `systemctl stop minecraft-server-vanilla.service`, then `systemctl reset-failed` to clear the failed state. +- RCON disabled (`enable-rcon=false`); console access only via the screen session. +- World data: `/home/minecraft/server-vanilla/world`. MOTD: `GNexus Space`. +- Server auto-pauses when empty for 60s (vanilla pause feature). + +## History / observations + +- 2026-10-07: stopped by navi rei on owner request (no players online; last player l3iniv4kur4 left 14:59 UTC). Unit left inactive, world saved via graceful stop. +- Old Forge modded server directory `/home/minecraft/server` exists with stale logs (Jul 2025) — not the running instance. +- Proxy mapping `minecraft.gnexus.space` -> `tcp://192.168.1.218:25565` (internal-proxy-vps) is DEAD: 192.168.1.218 unreachable. The live server is on 192.168.1.160 and has no public proxy mapping. + +No raw credentials are documented here. diff --git a/90-maintenance/pending-changes/20261007151146-26215457.json b/90-maintenance/pending-changes/20261007151146-26215457.json new file mode 100644 index 0000000..108cdf1 --- /dev/null +++ b/90-maintenance/pending-changes/20261007151146-26215457.json @@ -0,0 +1,19 @@ +{ + "id": "20261007151146-26215457", + "kind": "doc", + "target": "10-systems/hosts/minecraft-server.md", + "summary": "Document vanilla Minecraft server on mine: systemd unit, screen/RCON access, Restart gotcha, 2026-10-07 stop, dead .218 proxy mapping.", + "reason": "", + "payload": { + "content": "---\nowner: gmikcon\nstatus: active\nlast_reviewed: 2026-10-07\nreview_interval: 90d\nconfidence: high\nsource_of_truth: ssh-host-verified\n---\n\n# Minecraft Server (mine)\n\nVanilla Minecraft server on host `mine` (192.168.1.160), port 25565.\n\n## Service\n\n- systemd unit: `minecraft-server-vanilla.service` (user `minecraft`, WorkingDirectory `/home/minecraft/server-vanilla`).\n- ExecStart: screen session `mc-server` running `java -Xms4G -Xmx14G -jar server.jar nogui` (Java 25).\n- `Restart=on-failure`. GOTCHA: a plain `stop` typed into the screen session exits java with non-zero status, systemd counts it as failure and RESPAWNS the server. To stop for real: `systemctl stop minecraft-server-vanilla.service`, then `systemctl reset-failed` to clear the failed state.\n- RCON disabled (`enable-rcon=false`); console access only via the screen session.\n- World data: `/home/minecraft/server-vanilla/world`. MOTD: `GNexus Space`.\n- Server auto-pauses when empty for 60s (vanilla pause feature).\n\n## History / observations\n\n- 2026-10-07: stopped by navi rei on owner request (no players online; last player l3iniv4kur4 left 14:59 UTC). Unit left inactive, world saved via graceful stop.\n- Old Forge modded server directory `/home/minecraft/server` exists with stale logs (Jul 2025) — not the running instance.\n- Proxy mapping `minecraft.gnexus.space` -> `tcp://192.168.1.218:25565` (internal-proxy-vps) is DEAD: 192.168.1.218 unreachable. The live server is on 192.168.1.160 and has no public proxy mapping.\n\nNo raw credentials are documented here." + }, + "status": "applied", + "created_at": "2026-10-07T15:11:46Z", + "updated_at": "2026-10-07T15:11:48Z", + "applied_at": "2026-10-07T15:11:48Z", + "validation": { + "status": "ok", + "issue_count": 0, + "issues": [] + } +}