ProjectZomboiD

Privater Project Zomboid Dedicated Server (Build 42) - hochwertiges, selbstwartendes Setup fuer bis zu 8 Coop-Spieler. Linux als Haupt-Host, Windows-Paritaet fuer Admin/Clients, Google-Cloud-Failover fuer Notfaelle.

Features

• Config-as-Code: .env + Templates -> Server-Configs, nie von Hand editieren
• mods.yaml: deklarative Modliste (Workshop-verifizierte B42-IDs), Generator baut Load-Order + B42-Backslashes + Map=-Zeile automatisch
• Sichere Updates: Pre-Backup -> Update -> Healthcheck -> Auto-Rollback
• Selbstwartung: Watchdog (minuetlich), Backups (taeglich), Updates (woechentlich)
• Spawn-System: eigene Coop-Startpunkte inkl. Raven-Creek-Regionen
• Performance-getunt: B42-Presets (Heap, Zombie-Simulation, Welt-Hygiene)
• Discord-Alerts: Start/Stop/Update/Crash/Backup (optional, per Webhook)
• CI: shellcheck + Modlisten-Validierung bei jedem Push
• GCP-Failover: gestoppte e2-standard-4, 3 Slots, Kosten nahe null im Leerlauf

Quickstart (Linux)

git clone <repo-url> ProjectZomboiD && cd ProjectZomboiD
cp .env.example .env && $EDITOR .env     # Secrets + Pfade setzen
sudo make install                        # SteamCMD + Server + Configs
make mods                                # Modliste validieren + generieren
# systemd aktivieren: siehe systemd/README.md

Alle Befehle

make help - zeigt das komplette CLI (install, update, backup, restore, status, logs, mods, validate, failover-sync ...)

Struktur

Pfad	Inhalt
mods.yaml	Die Modliste (Single Source of Truth)
config/templates/	Server-Config-Templates
config/presets/sandbox/	Coop-Sandbox-Preset
config/spawns/	Spawn-Regionen + eigene Startpunkte
scripts/	Alle Automatisierungs-Skripte (+ windows/)
systemd/	Service + Update-/Backup-Timer
docker/	Optionaler Container-Pfad
gcp/	Failover-Instanz & Backup-Sync
docs/	Ausfuehrliche Anleitungen (DE)
servermods/	Eigene Mods entwickeln

Wiki

Die vollstaendige Referenz (DE) lebt im GitHub-Wiki. Quickstart, Makefile-/ENV-/Server-/Mods-/Spawn-/Skripte-/systemd-Referenz, Betrieb (Backups, Updates, Monitoring, Docker, GCP-Failover), Performance, Admin-Befehle, Sicherheit, Glossar und Troubleshooting.

Doku

1. Architektur 2. Setup Linux
2. Windows 4. Modding
3. Wartung 6. GCP-Failover
4. Troubleshooting 8. Spawn-Punkte
5. Performance

Regeln

• .env wird niemals committet (Secrets!)
• Jede Mod-/Config-Aenderung = Commit (nachvollziehbar + revertbar)
• Build 42 only - B41-Mods sind inkompatibel