Glossar

Glossar

← Home

Alphabetisches Nachschlagewerk der wichtigsten Begriffe rund um den Project-Zomboid-B42-Dedicated-Server und dieses Repo. Jeder Eintrag trägt das Label der ihm zugrunde liegenden Quelle ((Repo-Default), (Community-Quelle) oder (Heuristik)) und verweist am Ende auf die Detailseite. Der Mythos-Kasten am Ende nennt nur, wo Fantasie-Begriffe auftauchen — die Fantasie-Begriffe selbst sind hier bewusst nicht gelistet.

A bis Z

B42 / Build 42

Aktueller Stable-Build von Project Zomboid (B42.20). Seit diesem Meilenstein ist Build 42 der Standard-Steam-Branch; ein -beta-Opt-in ist nicht erforderlich (Community-Quelle: Steam-Diskussionsforen). Architektur.

Cell / Chunk

Weltkacheln, die der Server beim Bewegen der Spieler von der Platte streamt. Jede Cell misst 300×300 Tiles — worldX/worldY adressieren die Cell, posX/posY die Position darin (Community-Quelle: pzwiki). B42 streamt pro Chunk bis zu 32 Etagen — siehe Storage-und-Map-Streaming.

Dedicated Server

Eigenständiger Serverprozess ohne Spielclient; Bezug über SteamCMD mit App-ID 380870 (Repo-Default, so vom Repo-Skript install.sh verwendet). Läuft in einer JVM, Ports 16261/16262. Details: Quickstart-Linux.

envsubst

GNU-Tool zum Ersetzen von ${VAR}-Platzhaltern durch .env-Werte. scripts/render-config.sh rendert damit servertest.ini.tmpl zur lauffähigen servertest.ini (Repo-Verhalten, 1:1). ENV-Variablen.

Fixpunkt-Spawn

Wird in servertest.ini per SpawnPoint=x,y,z gesetzt und erzwingt einen einzigen Punkt für alle Spieler — überschreibt Regionen und eigene Punkte (Community-Quelle: PZ-Community-Doku). Das Repo belässt den Wert auf SpawnPoint=0,0,0 (Repo-Default), damit das Spawn-Menü aktiv bleibt. Spawn-System.

G1GC / ZGC

Zwei Garbage-Collector der JVM: G1GC pausenarme Standard-Empfehlung für B42-Allokationsdruck, ZGC noch kürzere Pausen bei sehr großen Heaps (beide Community-Quelle: JVM-/Hosting-Guides). Aktivierung per -XX:+UseG1GC bzw. -XX:+UseZGC in StartServer64.sh; Repo setzt keinen GC-Flag (Repo-Stand). Performance-Guide.

Heap (Xms / Xmx)

Java-Speichergrenzen -Xms (initial) und -Xmx (Maximum). Community-Empfehlung: beide gleich setzen, um Heap-Resize-Pausen zu vermeiden (Community-Quelle: Hosting-Guides). Repo setzt nur -Xmx${RAM_XMX}; -Xms bei Bedarf ergänzen (Repo-Stand).

Healthcheck

scripts/healthcheck.sh mit drei Prüfungen: (1) Serverprozess läuft (pgrep -f ProjectZomboid), (2) UDP-Port 16261 gebunden, (3) keine kritischen Fehler (OutOfMemory|Exception in thread|FATAL) im Journal der letzten 5 Minuten (1:1). Der Exit-Code steuert Auto-Rollback und Watchdog. make healthcheck oder make status. Monitoring-und-Alerts.

Load-Order

Die Ladereihenfolge der Mods. Vom Repo-Generator scripts/mods-generate.sh anhand der category-Reihenfolge in mods.yaml gesetzt (library → framework → map → gameplay → qol, Repo-Default). In Mods= ist die Eintragsreihenfolge entscheidend — Frameworks zuerst (Community-Quelle: PZ-Community-Doku). Mods-Referenz.

Map= (INI-Zeile)

Eine der drei generierten Mod-Zeilen. Listet die internen Karten- Ordnernamen semikolongetrennt; Muldraugh, KY immer zuletzt, frühere Einträge gewinnen bei Zell-Überlappung (Community-Quelle: Repo- Changelog 0.3.0). Aus mods.yaml (map_name aktiver Karten) erzeugt — manuell in servertest.ini pflegen.

MaxGCPauseMillis

JVM-Parameter, der das Pausenziel des G1GC in Millisekunden setzt. Standardwert 200 (Community-Quelle: JVM-/Hosting-Guides); konservativere Alternative 50 (Heuristik). Praxisregel bei Spielerrückmeldungen: bei Rucklern senken, bei CPU-Last in GC erhöhen.

mcrcon

Kommandozeilen-Client für das Source-Engine-RCON-Protokoll. Vom Repo-Skript announce.sh benutzt, um In-Game-Ansagen zu senden (Repo-Stand). Verbindung: mcrcon -H 127.0.0.1 -P ${RCON_PORT} -p ${RCON_PASSWORD} — Host ist im Repo hardkodiert 127.0.0.1; eine RCON_HOST-Variable existiert nicht.

Mod-ID

Interne Text-ID einer Mod aus deren mod.info-Datei. Wird in Mods= eingetragen — der Repo-Generator setzt automatisch den B42-Pflicht- Backslash davor (Repo-Verhalten, mods-generate.sh). Eine Mod kann ohne Mods=-Eintrag still nicht laden, auch wenn WorkshopItems= gesetzt ist (Community-Quelle: pzwiki).

Mods= (INI-Zeile)

Eine der drei generierten Mod-Zeilen. Listet die Mod-IDs mit führendem Backslash (\damnlib;\NeatUI_Framework;...), bestimmt die Lade-Reihenfolge. Vom Generator erzeugt; manuell in servertest.ini pflegen (manueller Schritt im Repo-Stand, Architektur).

.planned-stop

Leere Datei ${REPO_ROOT}/.planned-stop, die einen geplanten Stop markiert. Der minütliche Cron-Watchdog scripts/monitor.sh greift nur ein, wenn sie fehlt (Repo-Stand, 1:1). Wird von Hand vor Wartung gesetzt (touch .planned-stop) und danach entfernt.

posX / posY / posZ

Relativkoordinaten innerhalb einer Cell. posX/posY = 0–299 (Tile in der Zelle), posZ = Etage (0 = Erdgeschoss). Verifizierungs-Tool: https://map.projectzomboid.com (Community-Quelle). Werte aus spawns.yaml (Repo-Default).

Persistent=true

Timer-Option in systemd-Units: holt verpasste Auslösungen nach Reboot nach. Im Repo gesetzt in zomboid-backup.timer (04:00 täglich) und im templated zomboid-update.timer (Repo-Stand, 1:1 aus den Unit-Files). Details: systemd-Referenz.

RAM_XMX

.env-Variable, die das Repo via systemd an start-server.sh als -Xmx${RAM_XMX} durchreicht (1:1 aus zomboid.service). Default 12G (8 Spieler + Repo-Modliste); im B42-Larger-Tier üblich sind 16G — dann Host mit ≥24 GB RAM (Community-Quelle: .env.example und EN-Checkliste).

RCON

Fernsteuerungs-Protokoll der Source-Engine, vom Zomboid-Server auf einem TCP-Port (Default 27015, Repo-Default in .env.example) angeboten. Aktiviert über RCON_ENABLED=true; genutzt für In-Game- Ansagen und das saubere /quit. Verbindung ausschließlich lokal über mcrcon -H 127.0.0.1. Details: Monitoring-und-Alerts.

RCON_ENABLED / RCON_PORT / RCON_PASSWORD

Drei .env-Variablen, die den RCON-Zugriff konfigurieren. Defaults (Repo-Default in .env.example): RCON_ENABLED=true, RCON_PORT=27015, RCON_PASSWORD=CHANGE_ME (muss gesetzt werden). Eine RCON_HOST-Variable existiert nicht — Verbindungen gehen immer gegen 127.0.0.1.

SandboxVars

Lua-Datei <SERVER>_SandboxVars.lua für Weltregeln, Population und Loot-Schwierigkeit. Wird beim make render aus config/presets/sandbox/coop-balanced.lua kopiert (Repo-Verhalten). Werte des Repo-Presets sind Repo-Defaults — Server-Konfiguration.

server.ini

Zentrale Server-Konfigurationsdatei; Dateiname folgt -servername (-servername servertest → servertest.ini, Community-Quelle: pzwiki). Repo erzeugt sie aus config/templates/servertest.ini.tmpl per envsubst. Echte INI-Optionen: Server-Konfiguration — die neun Fantasie-Namen sind dort und sonst nirgendwo gelistet.

Simulationsthread

Der eine Thread, in dem Zombie-KI, Pfadfindung, Beleuchtung und Chunk-Arbeit laufen (Community-Quelle: PDF-Handbuch Kapitel 1). Single-threaded auf einem Kern — Taktfrequenz schlägt Kernanzahl. Vertiefung: Hardware-Empfehlungen und Performance-Guide.

Single Source of Truth (SSOT)

Architektur-Prinzip: jede Information hat genau eine Quelle. Im Repo: Mods nur in mods.yaml, Spawns nur in spawns.yaml, Werte nur in .env. Generatoren (mods-generate.sh, spawns-generate.sh, render-config.sh) erzeugen daraus die lauffähigen Dateien. Hand-Edits an generierten Dateien werden beim nächsten make render überschrieben (Repo-Prinzip). Architektur und Konventionen-und-Quellen.

Spawn-Punkt

Exakter Koordinaten-Eintrag (worldX/worldY/posX/posY/posZ) in einer <SERVER>_<key>.lua-Datei; eine Liste davon pro Beruf. Schlüssel unemployed ist Fallback für alle Berufe ohne eigene Tabelle (Community-Quelle: PZ-Community-Doku). Spawn-System.

Spawn-Region

Eintrag in <SERVER>_spawnregions.lua — entweder file (zeigt auf die spawnpoints.lua einer Map/Mod) oder serverfile (eigene Datei in Zomboid/Server/ mit voller Kontrolle). Reihenfolge = Reihenfolge im Spawn-Menü. Spawn-System.

SteamCMD

Valves Kommandozeilen-Client für Steam-Server- und Workshop-Downloads. Vom Repo-Skript install.sh aufgerufen, um App 380870 anonym zu installieren (+login anonymous, Repo-Stand). Workshop-Downloads landen unter steamapps/workshop/content/108600/ (Community-Quelle). SteamCMD-Referenz.

Watchdog

scripts/monitor.sh ist der Crash-Watchdog des Repos und läuft minütlich per Cron (Repo-Stand, systemd/README.md). Erkennt ungeplante Ausfälle über systemctl is-active, startet ggf. neu und benachrichtigt Discord. Respektiert .planned-stop. Monitoring-und-Alerts.

Workshop-ID

Numerische Steam-Workshop-ID aus der Mod-URL. Wird in WorkshopItems= eingetragen und ist nicht mit der mod_id zu verwechseln (Community-Quelle: pzwiki). Quelle im Repo: mods.yaml, Workshop-Stand 2026-08 verifiziert (Repo-Default).

WorkshopItems= (INI-Zeile)

Eine der drei generierten Mod-Zeilen. Listet die numerischen Workshop-IDs semikolongetrennt und steuert nur den Download — wirkt erst zusammen mit dem Mods=-Eintrag. Vom Generator erzeugt; manuell in servertest.ini pflegen (manueller Schritt im Repo-Stand).

worldX / worldY

Cell-Koordinaten im Welt-Raster; jede Cell = 300×300 Tiles. Werte aus spawns.yaml (Repo-Default); verifizierte Raven-Creek-Bereiche auf Spawn-System. Werte außerhalb der cell_rects der Karte landen im Void (Community-Quelle: map_info.json).

ZombieUpdateDelta

Sekunden zwischen Zombie-Bulk-Updates; im Repo-Template auf 0.5 gesetzt (Repo-Default, 1:1 aus servertest.ini.tmpl). Niedrigerer Wert = glattere CPU-Verteilung, aber langsamere Zombie-Reaktion außerhalb der Sichtweite (Community-Quelle: Repo-Doku docs/09). Verwandt: ZombieUpdateMaxHighPriority, ZombieUpdateRadiusLowPriority, ZombieUpdateRadiusHighPriority — alle Repo-Defaults, [[Server- Konfiguration]] und Performance-Guide.

Labels (die drei Marken dieses Wikis)

Diese drei Marken begleiten jede Zahl im Wiki und stehen unmittelbar hinter dem Wert — Details und Begründung: Konventionen-und-Quellen.

• (Community-Quelle: ...) — extern belegt; Herkunft wird immer mitgenannt (z. B. pzwiki, Steam-Diskussionen, Hosting-Guides).
• (Repo-Default) — der Repo-Quellcode setzt genau diesen Wert 1:1 (Template, Skript, YAML, Makefile); autoritativ für das, was dieses Repo tut, aber keine TIS-Vorgabe.
• (Heuristik) — begründete Eigen-Empfehlung dieses Wikis / der Repo-Doku; Diskussionsgrundlage, keine Garantie.

Begriffe, die NICHT existieren

In Foren und KI-generierten „Optimierungslisten" kursieren Fantasie-Namen für angebliche Server-Optionen, die Project Zomboid (B42) nicht kennt. Unbekannte Keys werden vom Server still ignoriert — die erhoffte Wirkung tritt nie ein. Die vollständige Liste der neun Fantasie-Namen steht im Mythos-Kasten auf Server-Konfiguration. Hier wird er bewusst nicht wiederholt.

Verwechslungsgefahr: LightingUpdateInterval (mit „Interval") ist ein echter Repo-Default-Wert im Template und steht auf Server-Konfiguration in der Performance-Tabelle.

---

Weiter: Konventionen-und-Quellen · Server-Konfiguration · Performance-Guide