Home

ProjectZomboiD — Wiki

Dieses Wiki dokumentiert ProjectZomboiD, einen selbstwartenden Dedicated Server für Project Zomboid Build 42 für bis zu 8 Coop-Spieler (MaxPlayers=8, Repo-Default). Der Haupt-Host läuft unter Linux; Windows-Admins und Clients werden durch Paritäts-Skripte unterstützt, und ein gestoppter GCP-Failover sichert den Betrieb für den Notfall.

Features

Feature	Beschreibung
Config-as-Code	.env + Templates erzeugen die Server-Configs — nie von Hand editieren
mods.yaml	Deklarative Modliste (Workshop-verifizierte B42-IDs); der Generator baut Load-Order + B42-Backslashes + Map=-Zeile automatisch
Sichere Updates	Pre-Backup → Update → Healthcheck → Auto-Rollback
Selbstwartung	Watchdog (minütlich), Backups (täglich), Updates (wöchentlich)
Spawn-System	Eigene Coop-Startpunkte inkl. Raven-Creek-Regionen
Performance-getunt	B42-Presets für Heap, Zombie-Simulation und 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-Instanz, 3 Slots, Kosten nahe null im Leerlauf

Feature-Angaben dieser Tabelle stammen 1:1 aus der Repo-README (Repo-Quelle: README.md); „3 Slots" ist FAILOVER_SLOTS=3 aus .env.example (Repo-Default).

Schnellstart (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 [[Quickstart-Linux]] (Schritt 5)

Die vollständige Anleitung mit Voraussetzungen, Verifikation und Stolperfallen steht auf Quickstart-Linux.

Seitenindex

Seite	Inhalt	Für wen
Quickstart-Linux	Linux-Haupt-Host in 7 Schritten von klon bis erste Verbindung	Erstnutzer
Architektur	Prinzipien, Komponenten, Datenflüsse, Repo- und Betriebsverzeichnisse	Wer verstehen will, was passiert
Setup-Windows	Windows-Clients, Admin-/Testmaschine, PowerShell-Parität	Windows-Spieler und -Admins
Makefile-Referenz	Alle make-Targets im Überblick	Alltag
Cheatsheet-Tagesbetrieb	Kompakte Alltags-Befehle: make, systemctl, journalctl, Skripte, Notfall	Alltag
ENV-Variablen	.env vollständig: Gruppen, Defaults, Pflichtwerte	Erstsetup, Fehlersuche
Server-Konfiguration	servertest.ini-Optionen, Sandbox-Preset, Mythen zu Fake-Optionen	Feintuning
Admin-Befehle	Verifizierte Admin-Befehle, Access-Level, RCON im Repo	Admins
Mods-Referenz	mods.yaml-Syntax, Load-Order, enthaltene Mods	Mod-Verwaltung
Spawn-System	spawns.yaml, Koordinaten-Schema, eigene Coop-Spawns	Spawn-Anpassung
Skripte-Referenz	Alle Bash- und PowerShell-Skripte mit Verhalten	Automatisierung
systemd-Referenz	Units, Timer, Templating, Watchdog-Cron	Linux-Betrieb
Ports-und-Netzwerk	Ports, Protokoll-Quellenkonflikt, Firewall, Router	Erreichbarkeit
Sicherheit-und-Hardening	Secrets, UFW, RCON-Isolation, Security-Audit	Absicherung
SteamCMD-Referenz	SteamCMD-Aufrufe, App 380870, Workshop-Downloads	Installation, Updates
Wartung-und-Automatik	Tages-/Wochenroutinen und Automatik-Übersicht	Alltagsbetrieb
Backup-und-Restore	Backup-Strategie, Rotation, interaktiver Restore	Datensicherheit
Updates-und-Rollback	Update-Zyklus und Auto-Rollback im Detail	Update-Sicherheit
Monitoring-und-Alerts	Healthcheck, Watchdog, Discord-Alerts	Stabilität
Docker-Betrieb	Optionaler Container-Pfad (compose, Volumes, Healthcheck)	Container-Betrieb
GCP-Failover	Notfall-Instanz, Backup-Sync, Hochfahren im Ausfall	Notfallvorsorge
Modding-Workflow	Mods hinzufügen/entfernen von der YAML bis zum Restart	Mod-Pflege
Performance-Guide	Heap, GC, Zombie-Simulation, Welt-Hygiene	Tuning
Storage-und-Map-Streaming	Storage-Tiers, Messung (iostat & Co.), tmpfs-Variante	Performance
Hardware-Empfehlungen	Host-RAM-Klassen, CPU-Priorität, Heap-Ableitung	Anschaffung
Troubleshooting	Typische Fehler mit Diagnose und Lösung	Alle
Runbook-Raven-Creek	Schritt-für-Schritt-Deployment der Raven-Creek-Karte	Karte einrichten
Glossar	Begriffe von Access-Level bis envsubst, kompakt erklärt	Neulinge, Nachschlagen
Konventionen-und-Quellen	Label-System, Quellen-Hierarchie, Redaktionsregeln	Autoren, kritische Leser

Lesepfade

1. „Nur schnell laufen lassen"

1. Quickstart-Linux — Server installieren und starten
2. ENV-Variablen — .env korrekt ausfüllen
3. Ports-und-Netzwerk — Erreichbarkeit sicherstellen
4. Troubleshooting — falls etwas hakt

2. „Alltagsbetrieb"

1. Makefile-Referenz — das eine CLI beherrschen
2. Cheatsheet-Tagesbetrieb — alles Alltägliche auf einer Seite
3. Backup-und-Restore — Datensicherheit verstehen
4. Updates-und-Rollback — sichere Updates
5. Monitoring-und-Alerts — Alerts einrichten
6. Wartung-und-Automatik — Routinen übernehmen lassen
7. Troubleshooting — wenn der Alltag aus der Bahn springt

3. „Tiefenwissen"

1. Architektur — wie das Repo zusammenspielt
2. Spawn-System — Koordinaten und eigene Startpunkte
3. Modding-Workflow — Modliste pflegen
4. Performance-Guide — Ressourcen tunen
5. Storage-und-Map-Streaming — Storage-Engpässe verstehen
6. Runbook-Raven-Creek — komplettes Karten-Deployment
7. Konventionen-und-Quellen — Zahlen und Quellen kritisch einordnen

Konventionen in diesem Wiki

Jede Zahl und behauptete Größe trägt ein Label: Community-Quelle (extern belegt), Repo-Default (steht genau so im Repo) oder Heuristik (begründete Eigen-Empfehlung). The Indie Stone publiziert keine offiziellen Storage-/IOPS-/Performance-Specs — Zahlen daher nie als TIS-Anforderung lesen. Details: Konventionen-und-Quellen.

Die vertieften Originale der Setup- und Betriebsanleitungen liegen im docs/-Ordner des Repos. Dieses Wiki ist aber eigenständig nutzbar und wiederholt alle nötigen Inhalte.