Multiplayer

Project Zomboid Server-Admin-Befehle und Tools

Cheat-Panel, Admin-Tools-Mod, Sandbox-Reload und Moderations-Etikette für dedizierte Hoster.

Zuletzt aktualisiert:

Server-Admin-Befehle und Tools

Einen dedizierten Project-Zomboid-Server zu betreiben bedeutet, jedes Wochenende die gleichen Hand voll Fragen zu beantworten : wie teleportiert man einen verlorenen Spieler zurück, wie setzt man einen Sandbox-Wert ohne vollen Neustart zurück, und was ist der richtige Weg, Restocks während eines öffentlichen Events auszugeben. Build 42.20.4 Stable (26. August 2026 Sicherheits-Hotfix) entfernte loadstring / loadstream aus Lua-Kontexten, also benötigen einige alte Admin-Mods, die Code hot-reloaded, jetzt expliziten Rebuild. Dieser Guide behandelt das Default-Cheat-Panel, die Admin-Tools-Mod der Community, Sandbox-Reload-Befehle, Spielermoderation und patch-bewusste Etikette für Hoster.

Für Server-Setup paare diese Seite mit Dedizierte Server und Server und Coop. Für Sandbox-Tuning siehe Sandbox-Einstellungen.

Standard In-Game-Admin-Zugang

Project-Zomboid-Server aktivieren Admin-Zugang über server-options.ini und die Spieler-Account-Whitelist. Das Basisspiel unterstützt einen Chat-getriebenen Admin-Channel nur für Hoster.

Setup-Schritte :

  1. Füge deinen Steam- oder GOG-Account-Namen zum Admin-Abschnitt der Server-Config hinzu.
  2. Setze AdminUsername und Password für passwortgeschützten Zugang auf gemieteten Boxen.
  3. Starte den Server neu, dann logge dich ein. Dein Chat-Prompt erhält den admin-Tag in Server und Coop-UIs.
  4. Tippe !help im Admin-Channel, um verfügbare Befehle auf deinem aktuellen Build zu sehen.

Standard-Befehle variieren je nach Patch ; das Cheat-Panel kann hinter einer Server-Option für gemietete Hosting-Lösungen gesperrt sein. Überprüfe immer zuerst die Admin-Docs deines Hosting-Providers - einige Unternehmen schränken !additem und ähnliche Befehle ein.

Cheat-Panel : das Survival-fokussierte Admin-Toolkit

Das Vanilla-Cheat-Panel öffnet sich mit dem !cheats-Chat-Befehl (nur Hoster). Es zeigt dieselben Toggles, die Admins früher bei der World-Erstellung setzten, plus mehrere, die nach Build 42 in die Sandbox gewandert sind. Verwende es für :

  • !toggle zum Umschalten häufiger Cheats wie Build (kostenloses Bauen), NoClip oder Invisible.
  • !additem <Item> <Count>, um Items dir selbst oder einem Ziel-Spieler zu geben.
  • !godmode zum Testen der Kampf-Balance ohne zu sterben.
  • !time, um die In-Game-Stunde während geplanter Events zu setzen.
  • !weather, um Regen zu löschen oder Stürme zum Testen auszulösen.

Das Cheat-Panel gewährt nicht automatisch Admin für andere Spieler. Es ist dein Hoster-only Tool für Testing und Live-Support.

Admin-Tools-Mod : Community-Power-Features

Die Community-gepflegte Admin-Tools-Mod (von Whicker, aktuell die führende Mod im Steam-Workshop für B42.x-kompatible Releases) erweitert das Cheat-Panel mit sichereren, gehosteten Server-Grade-Controls. Nach Build 42.20.4 wird sie ohne loadstring ausgeliefert und funktioniert auf der neuen Sicherheits-Baseline.

Bemerkenswerte Befehle :

  • !additem <Spielername> <ItemName> <Anzahl> - Items gewähren ohne das Admin-Inventar zu verlassen.
  • !addxp <Spielername> <SkillName> <Level> - hebt eine Überlebenden-Skill für Testing oder Events.
  • !teleport <Spielername> <x,y> - bewegt Spieler zurück zur Basis oder zu einem bekannten Safe House.
  • !removezombies - löscht alle Zombies im aktuellen Chunk. Nützlich mitten im Event, wenn der Chunk-Unloader versagt.
  • !restock - setzt Container-Zustände global zurück.
  • !kick <Spielername> und !ban <Spielername> - Spielermoderation.
  • !saveworld - erzwingt einen Save außerhalb des Autosave-Intervalls.

Bestätige die installierte Version gegen deinen Server-Build : Build 42.20.4-Hotfixes änderten Lua-Berechtigungen, also werfen ältere Admin-Tools-Mod-Builds Fehler. Aktualisiere die Mod durch den Workshop oder deinen manuellen Download-Ordner, bevor du live gehst.

Sandbox-Reload ohne Neustart

Der !reloadoptions-Befehl lädt SandboxVars.lua neu ohne den Server neu zu starten. Verwende ihn nach dem Tunen eines einzelnen Werts (Zombie-Migrations-Frequenz, Helikopter-Event-Tag-Fenster, Loot-Respawn-Stunden), damit Spieler keinen Disconnect-Pop sehen.

Beste Prze :

  • Kündige !reloadoptions immer im Discord an, bevor du es ausführst. Einige Sandbox-Änderungen beeinflussen Zombie-Populationen.
  • Kombiniere mit Sandbox-Einstellungen-Dokumentation, damit du nicht versehentlich eine Einstellung aktivierst, die deinen Save bricht.
  • Mache ein Save-Backup mit Save Backup vor jedem Live-Reload.

Wenn dein Server kein !reloadoptions hat, bedeutet das, dass das zugrundeliegende Cheat-Panel vom Host-Provider gesperrt ist. Die meisten großen Server-Hoster (G-Portal, Apex, Bisect) aktivieren es standardmäßig ; kleinere Hoster benötigen möglicherweise eine Anfrage.

Chunk-Management und Performance-Befehle

Die Build 42.20 Map-Erweiterung hat den spielbaren Bereich ungefähr verdoppelt. Server, die vor der 42.20-Linie existierten, laufen oft in Chunk-Lade-Probleme, wenn Gruppen lange Distanzen fahren. Nützliche Befehle :

  • !chunkreload - erzwingt einen Reload des Chunks um die Admin-Position. Hilfreich, wenn Texturen grau werden.
  • !vehicles - listet jedes aktive Fahrzeug im Speicher, nützlich wenn Fahrzeuge verschwinden oder duplizieren. Der 42.20.1-Hotfix hat das bereits verbessert, aber eine manuelle Liste hilft trotzdem nach Desync.
  • !players - listet Online-Spieler und ihre Koords.
  • !gc (Garbage Collect) - fordert die Java-Runtime auf, Speicher freizugeben. Führe nach einer langen Session aus.

Kombiniere mit System-Anforderungen, wenn Spieler Crashes melden. Memory-Leak-Fixes vom 42.20.3-Patch halfen, aber lange Saisons benötigen trotzdem gelegentliches !gc.

Spielermoderation

Das Admin-Toolkit enthält : !kick, !ban, !mute und !unmute. Paare sie mit einem schriftlichen Verhaltenskodex, der auf deinem Server-Discord gepostet ist. Der Standard-Project-Zomboid-Server protokolliert Moderations-Aktionen in server-console.txt für Transparenz.

Tipps :

  • Warne immer, bevor du kickst, es sei denn der Verstoß ist schwerwiegend.
  • Dokumentiere Bans mit Zeitstempeln und Gründen.
  • Verwende !mute für Spamming, bevor du !kick ausgibst.
  • Stelle einen klaren Beschwerdeweg in deinem Discord bereit.

Für breitere Community-Safety-Guidance siehe Wiki Resources.

Workshop-Mod-Management

Admin-Tools-Mod und ähnliche Mods werden typischerweise über den Steam-Workshop ausgeliefert. Build 42.20.4 ändert, welche Mods Lua-Kontexte laden können, also benötigen Workshop-Autoren möglicherweise Tage nach einem Hotfix, um Updates zu veröffentlichen. Plane Downtime nach Sicherheits-Patches ein.

Wenn du Mods manuell hostest :

  • Platziere Mods in /media/mods/ und aktualisiere die WorkshopItems=-Liste in server-options.ini.
  • Backup WorkshopItems, bevor du neue Mods hinzufügst.
  • Führe !reloadoptions aus, um die Mod-Liste ohne Neustart zu aktualisieren.

Beziehe dich auf Multiplayer-Mods für den breiteren Mod-Lebenszyklus-Workflow.

Häufige Admin-Pitfalls in Build 42.20.4

  • Eine alte Admin-Tools-Mod-Version ausführen, die noch loadstring verwendet. Der 42.20.4-Sicherheits-Hotfix entfernt die Funktion und dein Server wird in einer Fehlerschleife enden.
  • !restock mitten im Event ausgeben, ohne Spielern Bescheid zu geben. Whiteboard-Markierungen werden gelöscht.
  • Spieler zu einem Teammitglied teleportieren, ohne zuerst den Standort des Teammitglieds zu bestätigen.
  • ZombieLore-Optionen live aktivieren. Siehe Spielmodi für die Lore-Preset-Details.
  • !saveworld nach Admin-Aktionen vergessen. Das Autosave-Fenster ist verzeihend, aber Live-Events profitieren von expliziten Saves.

Schritt-für-Schritt : einen verlorenen Spieler unterstützen

  1. Bestätige, dass der Spieler online ist : !players.
  2. Identifiziere seine Grid-Koordinate : !where <Spielername>.
  3. Überprüfe, ob er nicht in einem Fahrzeug festsitzt : !vehicles.
  4. Wenn er feststeckt, !teleport <Spielername> <SafeHouse> zu einem designierten Rally-Lot.
  5. Kommuniziere über Discord. Vermeide Teleportieren von Spielern während Helikopter-Events.
  6. Nach der Aktion !saveworld.

Dieses Muster hält deine Support-Tickets kurz und deine Spielerbasis zuversichtlich.

Patch-bewusste Hosting-Checkliste

  • Vor Patch : Save backupen, installierte Mods dokumentieren, neue Spieler-Joins einfrieren.
  • Patch-Tag : Server-Jar aktualisieren, !reloadoptions ausführen, neustarten, mit Admin-Account smoke-testen.
  • Nach Patch : server-console.txt auf Fehler überwachen, bekannte Issues im Discord kommunizieren.
  • Hotfix-Woche : auf Admin-Tools-Mod-Updates achten. Wenn möglich innerhalb von 48 Stunden anwenden.

Für Build 42.20.4 spezifisch folge Hotfix 42.20.4 für den Sicherheits-Kontext und Build 42 Übersicht für die breitere Post-42.20-Ära.

Backup vor jeder großen Admin-Aktion

Admin-Aktionen berühren geteilten Welt-Zustand. Verwende Save Backup jedes Mal, wenn du Sandbox-Werte änderst, !restock ausführst oder eine Spieler-Position zurücksetzt. Das Autosave-Fenster ist verzeihend, aber nicht unendlich.

FAQ

Häufig gestellte Fragen

Schnelle Antworten auf die häufigsten Fragen.

Wie aktiviere ich Admin-Zugang auf meinem Server ?

Füge deinen Steam- oder GOG-Account zum Admin-Abschnitt von `server-options.ini` hinzu, setze ein Passwort, wenn du öffentlich hostest, dann starte neu. Tippe `!help` im Admin-Chat, um zu sehen, was dein aktueller Build unterstützt.

Warum ist meine Admin-Tools-Mod nach Build 42.20.4 kaputt ?

Der 26. August 2026 Sicherheits-Hotfix entfernte `loadstring` / `loadstream` aus Lua-Kontexten. Ältere Mod-Builds verwendeten sie ; aktualisiere auf die neueste Mod-Version, die ohne diese Funktionen ausgeliefert wird.

Kann ich Sandbox-Werte ändern, ohne den Server neu zu starten ?

Ja. `!reloadoptions` lädt `SandboxVars.lua` live. Kündige das immer im Discord an und backup deinen Save zuerst ; einige Werte beeinflussen Zombie-Populationen.

Welcher Befehl bewegt einen feststeckenden Spieler zurück zur Basis ?

Verwende `!teleport <Spielername> <Koordinate>` aus der Admin-Tools-Mod oder deinem Host-Provider-Äquivalent. Vermeide Teleportieren während Helikopter-Events, um Zombie-Migration in den Pfad eines Teammitglieds zu verhindern.

Wie restocke ich Loot auf einem Live-Server ?

Führe `!restock` aus der Admin-Tools-Mod aus. Kündige das immer vorher im Discord an ; Spieler-Whiteboards und Gebäude-Marker werden gelöscht.