Admin Befehle

Admin-Befehle

← Home

Übersicht über die wichtigsten In-Game- und Server-Konsolenbefehle für den B42-Dedicated-Server dieses Repos. Befehlsliste verifiziert gegen die pzwiki-Seite „Admin Commands" (Community-Quelle: pzwiki, Stand Build 42.17.0, Verifikationsdatum 2026-08; das Wiki ist nicht vollständig für 42.20+ aktualisiert, aber die hier gelisteten Befehle funktionieren laut Stand 2026-08 weiterhin).

Vertieft in Repo: scripts/announce.sh (RCON-Beispiel); Detailseiten Monitoring-und-Alerts, ENV-Variablen, Server-Konfiguration, Cheatsheet-Tagesbetrieb.

Voraussetzungen

• Admin-Account im Spiel vorhanden. Der Admin-Account wird beim ersten Serverstart angelegt; das Passwort wird dort abgefragt und entspricht AdminPassword= aus servertest.ini (Repo-Default). Wert kommt aus ADMIN_PASSWORD in der .env und wird per make render in die ini geschrieben.
• Zugriff auf die Server-Konsole ODER RCON: Befehle funktionieren sowohl im In-Game-Chat (mit führendem /) als auch auf der Server- Konsole (ohne /). Das Repo bietet RCON ausschließlich lokal an (siehe unten) — In-Game ist der Normalfall.
• Bei Multiplayer zählt /-Präfix im Chat, nicht auf der Konsole (Community-Quelle: pzwiki, Dedikated-Server-Guide).

Verifizierte Befehlstabelle

Übernommen aus mini-guides/04-admin-befehle.md (Community-Quelle: pzwiki Admin-Commands; Stand der Wiki-Seite 42.17.0, Verifikation 2026-08). Befehle wie gelistet übernehmen, nichts hinzudichten.

Befehl	Wirkung
/players	Listet alle verbundenen Spieler
/save	Speichert die aktuelle Welt
/quit	Speichert und beendet den Server
/adduser "name" "passwort"	Legt einen neuen Benutzer an (Whitelist-Server)
/setpassword "name" "neues-passwort"	Ändert das Passwort eines Benutzers
/setaccesslevel "name" "level"	Setzt die Rechte-Stufe (siehe unten)
/showoptions	Zeigt alle aktuellen Server-Optionen mit Werten
/changeoption optionName "wert"	Ändert eine einzelne Server-Option
/reloadoptions	Lädt die Optionen aus der ini neu und sendet sie an die Clients
/teleport	Teleportiert den Admin zu einem Spieler
/invisible	Macht einen Spieler für Zombies unsichtbar
/noclip	Lässt einen Spieler durch Wände und Strukturen laufen
/voiceban "name"	Blockiert die Stimme eines Benutzers
/servermsg "text"	Sendet eine Nachricht an alle Spieler
/checkModsNeedUpdate	Prüft, ob Server-Mods Updates brauchen

Mit /help listet der Build alle verfügbaren Befehle auf — falls ein Befehl nach größerem Update fehlt, ist /help die Quelle der Wahrheit (Community-Quelle: pzwiki).

Access-Level-Modell

Quelle: mini-guides/04-admin-befehle.md (Community-Quelle: pzwiki).

Level	Bedeutung (gelabelt)
Admin	Voller Zugriff (Community-Quelle: pzwiki)
Moderator	Moderationsrechte (Community-Quelle: pzwiki)
Overseer	Erweiterte Moderationsrechte (Community-Quelle: pzwiki)
GM	Game-Master-Funktionen (Community-Quelle: pzwiki)
Observer	Nur beobachten, keine Eingriffe (Community-Quelle: pzwiki)
none	Keine Rechte (Community-Quelle: pzwiki)

Setzen mit /setaccesslevel "name" "level" (Befehl verifiziert s. o.). Die Reihenfolge der Privilegien ist nicht offiziell dokumentiert; die gelisteten Level sind die aus der pzwiki-Admin-Commands-Seite.

RCON im Repo

scripts/announce.sh nutzt mcrcon für die In-Game-Ansagen (1:1 aus dem Skript):

command -v mcrcon >/dev/null 2>&1 || { warn "mcrcon nicht installiert..."; exit 0; }
[[ "${RCON_ENABLED:-false}" == "true" ]] || exit 0

rcon() { mcrcon -H 127.0.0.1 -P "${RCON_PORT}" -p "${RCON_PASSWORD}" "$1" >/dev/null 2>&1 || true; }

Drei harte Repo-Fakten zum RCON-Pfad:

1. Host ist hardkodiert 127.0.0.1. Eine Variable RCON_HOST existiert im Repo nicht — Repo-Befund, kein Tippfehler (Repo-Default). Wer RCON remote nutzen will, muss mcrcon selbst mit anderer -H-Option aufrufen, das Skript selbst anpassen oder SSH-Tunnel benutzen.
2. Guard RCON_ENABLED: bei false oder leer macht das Skript still exit 0 (Repo-Default, 1:1 aus scripts/announce.sh). RCON-Ansagen kommen also nur durch, wenn RCON_ENABLED=true in der .env gesetzt ist.
3. Werte aus .env: RCON_PORT und RCON_PASSWORD liest das Skript per lib/common.sh aus der .env (siehe ENV-Variablen).

Beispiel: einmalige servermsg-Ansage via RCON von der Kommandozeile des Servers aus (gleiches Muster wie announce.sh):

mcrcon -H 127.0.0.1 -P "${RCON_PORT}" -p "${RCON_PASSWORD}" \
  'servermsg "Server-Restart in 10 Minuten"'

${RCON_PORT} und ${RCON_PASSWORD} müssen aus der .env gesetzt sein — direkter Aufruf ohne Source der .env scheitert an leeren Variablen.

/reloadoptions vs. Mod-Liste

Wichtige Unterscheidung, die leicht verschluckt wird:

• /reloadoptions liest servertest.ini neu ein und verteilt geänderte Optionen an die Clients. Gedacht für Optionen — nicht für die Mod- Liste (Community-Quelle: pzwiki Dedicated-Server-Guide).
• Änderungen an Mods=, WorkshopItems= oder Map= benötigen einen Server-Restart, kein /reloadoptions. Konsistent mit Mods-Referenz und der Mods-Sektion in Server-Konfiguration.
• Sandbox-Optionen (servertest_SandboxVars.lua) werden ebenfalls nicht per /reloadoptions verteilt — Restart nötig (Community-Quelle: pzwiki).

Heuristik: Wenn eine Änderung trotz /reloadoptions nicht ankommt, ist sie mit hoher Wahrscheinlichkeit in Mods=, WorkshopItems=, Map= oder in der Sandbox-Lua — alle vier brauchen einen Neustart.

UNVERIFIZIERT

Folgende Befehle und Schritte sind in dieser Doku nicht verifiziert und werden bewusst nicht ausführlich beschrieben — wer sie braucht, muss sie selbst in der jeweils aktuellen pzwiki oder im offiziellen TIS-Forum nachschlagen:

Thema	Status
/grantadmin	Nicht auf pzwiki Admin-Commands gefunden (Stand 2026-08); Befehl nicht erfunden
/changeuserpassword	Nicht auf pzwiki Admin-Commands gefunden (Stand 2026-08); stattdessen /setpassword
/setoption (Singular)	Nicht verifiziert; stattdessen /changeoption
Exakter In-Game-Admin-Login-Schritt	Auf pzwiki nicht weiter dokumentiert (siehe mini-guides/04); konkretes Tasten-/Chat-Muster in dieser Wiki nicht belegt

Wenn etwas davon in einem Build geht: /help zeigt es. Diese Wiki gibt bewusst keine erfundenen Schritte aus.

Stolperfallen

• Passwörter im Chat-Log: /adduser und /setpassword schreiben Benutzernamen und Passwort in den Chat-Puffer, der für andere Spieler einsehbar ist, solange niemand den Puffer leert (Community-Quelle: mini-guides/04-admin-befehle.md). Passwörter besser auf der Server- Konsole setzen oder nach der Ausgabe sofort ändern (Heuristik).
• Anführungszeichen vergessen: Werte mit Leerzeichen brauchen "..."; fehlen sie, wird der Befehl still ignoriert (1:1 aus mini-guides/04-admin-befehle.md).
• /quit bei vollem Server: Speichert und beendet den Server sauber — vor Update / Restart der Normalpfad. Bei „hartem" Stop über systemctl stop kann das Journal einen Unclean-Shutdown-Eintrag zeigen (Community-Quelle: pzwiki; siehe systemd-Referenz).
• /changeoption ohne /reloadoptions: Wert wird im RAM gesetzt, aber nicht in die ini zurückgeschrieben und nicht an alle Clients verteilt (Community-Quelle: pzwiki). Wer persistent will: ini editieren + /reloadoptions.
• RCON auf falschem Host aufgerufen: 127.0.0.1 ist im Repo fest verdrahtet. Wer von einem zweiten Host aus RCON spricht, muss SSH-Tunnel oder eine eigene mcrcon-Zeile mit -H <eigener-host> verwenden — das Repo-Skript unterstützt das nicht.
• RCON_ENABLED=false: Skripte (z. B. announce.sh) machen exit 0, ohne irgendetwas zu senden. Symptom: kein Countdown vor Update trotz vorhandener mcrcon-Installation.

Praxis-Beispiele

Drei kurze Sequenzen, die im Alltag auftauchen — alle Befehle verifiziert aus der Tabelle oben (Community-Quelle: pzwiki), Werte in Anführungszeichen wie in der Tabelle gefordert.

Spieler begrüßen / Hinweis

/servermsg "Wartung in 15 Minuten - bitte einloggen sichern"

Geht sowohl im In-Game-Chat (mit /) als auch via RCON von der Server- Konsole. Über RCON genügt die Variante aus dem Abschnitt „RCON im Repo" weiter oben.

Option live anpassen

/showoptions                          # aktuelle Werte sehen
/changeoption ZombieUpdateDelta "0.5" # einen Wert setzen
/reloadoptions                        # an alle Clients verteilen
/showoptions                          # verifizieren

Reihenfolge ist 1:1 aus mini-guides/04-admin-befehle.md. Hinweis: Die Änderung wird im RAM gesetzt; persistent wird sie erst, wenn die ini- Datei denselben Wert enthält. Nach make render + Restart ist die ini wieder Quelle der Wahrheit.

Admin-Level vergeben

/setaccesslevel "Spielername" "Moderator"
/setaccesslevel "NeuerAdmin" "Admin"

Groß-/Kleinschreibung der Level wie in der Access-Level-Tabelle oben (Community-Quelle: pzwiki). Bei Unsicherheit: /help zeigt die im Build akzeptierten Werte.

Passwort ändern — sauberer Weg

/setpassword "Spielername" "NeuesPasswort-123"

Niemals auf der öffentlichen Konsole eines Live-Servers setzen, wenn der Chat-Log mitgelesen werden kann (siehe Stolperfallen oben). Auf der Server-Konsole oder per RCON von der Maschine selbst (Repo-Default 127.0.0.1) ist es unkritisch.

Mini-Guide-Quelle

Die Tabelle oben und die Stolperfallen stammen aus mini-guides/04-admin-befehle.md im Repo (Verifikationsdatum 2026-08, pzwiki-Stand 42.17.0). Diese Wiki-Seite übernimmt die Tabelle 1:1 und ergänzt nur die RCON-Mechanik aus dem Repo (scripts/announce.sh).

RCON-Diagnose bei „Ansage kommt nicht"

Kurze Checkliste in Reihenfolge (Heuristik; Symptome aus scripts/announce.sh abgeleitet):

1. command -v mcrcon zeigt nichts → Skript macht exit 0 und loggt „mcrcon nicht installiert - In-Game-Warnung uebersprungen" (1:1 aus scripts/announce.sh). Lösung: mcrcon installieren (Distribution- Paket oder Tarball).
2. .env hat RCON_ENABLED=false oder fehlt → Skript macht still exit 0 (1:1 aus dem [[ "${RCON_ENABLED:-false}" == "true" ]] || exit 0-Guard).
3. RCON_PORT / RCON_PASSWORD leer → mcrcon schlägt fehl; durch das || true in der rcon()-Funktion bleibt das Skript aber insgesamt erfolgreich. Symptom ist „keine Ansage", kein Exit-Code-Problem.
4. mcrcon -H 127.0.0.1 -P ${RCON_PORT} Verbindung klappt, aber Spieler sehen die Nachricht nicht → Firewall auf dem Server blockt den RCON- Port nach außen (normal; RCON läuft nur lokal). In-Game-Ansagen kommen trotzdem an, solange der Server die RCON-Verbindung akzeptiert.

Siehe auch

Weiter: Monitoring-und-Alerts · ENV-Variablen · Server-Konfiguration · Cheatsheet-Tagesbetrieb