☰ Inhalt: MRadmin
Für Admins

Warteraum (Proxy)

Vorschau: unveröffentlichter Stand (Branch beta) - kann sich bis zum nächsten Release noch ändern. Zur veröffentlichten Fassung →

Neustarts und Wartungen sind für das Team wichtig, für Spieler aber eine Unterbrechung. Mit einem Proxy (Velocity) und einem kleinen zweiten Server mit MRwaitroom fliegt dabei niemand mehr raus: Die Spieler warten im Warteraum, sehen Grund und Restzeit und kommen von selbst zurück.

Der Warteraum ist freiwillig und standardmäßig aus. Ohne Proxy läuft MRadmin wie bisher.

Was MRadmin dabei macht

  • Vor einem Neustart oder Stopp (Countdown aus dem Browser, /mradmin restart|stop, geplante Neustarts) schickt MRadmin alle Spieler kurz vor dem Herunterfahren in den Warteraum (waiting-room.on-restart).
  • Bei Wartungsbeginn wechseln alle, die laut Rechten nicht bleiben dürfen, in den Warteraum, statt gekickt zu werden - auch wer während einer Wartung joint (waiting-room.on-maintenance).
  • Die Ankündigungen sagen es dazu: Der Countdown zu Neustart und Stopp und die Wartungsankündigungen im Chat enden mit „Du musst nicht rausgehen.“ (Platzhalter <stay>, nur mit Warteraum) - so verlässt niemand vorher den Server.
  • Kein doppeltes Willkommen: Wer aus dem Warteraum zurückkommt, gilt nicht als neu angekommen - Hinweise wie „Noch im Admin-Modus“, Team-Meldungen, Tickets und Update-Hinweise kommen nicht noch einmal.
  • Infos für den Warteraum: Über eine eigene kleine Schnittstelle (nicht die Weboberfläche) erfährt der Warteraum Neustart-Countdown und Grund, laufende und geplante Wartung und aktive Warnungen aus Neuigkeiten. Er merkt sich die letzte Antwort, damit die Infos auch dann noch da sind, wenn dein Server aus ist.

Was der Warteraum anzeigt und wann er die Spieler zurückschickt, steht in der Anleitung von MRwaitroom.

Einrichten

  1. Proxy: In der velocity.toml den Hauptserver und den Warteraum unter [servers] eintragen, try = ["main", "waitroom"] (Hauptserver zuerst) und bungee-plugin-message-channel = true setzen. Auf beiden Paper-Servern Velocity-Weiterleitung einschalten - Einzelheiten in der Anleitung von MRwaitroom.
  2. MRadmin: in der config.yml (oder im Browser unter Server → Hauptserver → Konfiguration → MRadmin → Warteraum):
    waiting-room:
      enabled: true
      server: "waitroom"        # Name des Warteraums in der velocity.toml
      link:
        bind: "10.0.0.5"        # interne Adresse dieses Rechners
        port: 8126
        key: ""                 # wird beim ersten Start erzeugt
    
  3. /mradmin reload - MRadmin erzeugt den Schlüssel (waiting-room.link.key) und meldet in der Konsole Waiting room link listening on ….
  4. Adresse (http://10.0.0.5:8126) und Schlüssel in die config.yml von MRwaitroom übernehmen (main.link-url, main.link-key).

link.bind gehört auf die interne Adresse (LAN), nie auf eine öffentliche. Die Schnittstelle verrät zwar nur, was die Spieler im Warteraum ohnehin sehen, aber sie gehört nicht ins Internet. Falsche Schlüssel werden nach 10 Versuchen pro Minute abgewiesen.

Warteraum aus MRadmin verwalten

Ist der Warteraum verbunden, steht MRwaitroom unter Server → Warteraum → Plugins - gekennzeichnet mit „Warteraum-Server“:

  • Konfiguration: wie bei jedem Plugin über Konfiguration (Permission mradmin.config). Beim Speichern holt sich der Warteraum die neue config.yml bei seiner nächsten Abfrage (wenige Sekunden), legt eine Sicherung an (config.backup-remote.yml) und lädt neu.
  • Updates: „Aktualisieren“ (Permission mradmin.versions.install, oder automatisch nach versions.auto-download) bestellt die neue Version. Der Warteraum lädt sie selbst - nur aus den offiziellen Releases und nur mit passender Prüfsumme - und startet neu, sobald niemand wartet und dein Server bereit ist.
  • Meldet sich der Warteraum länger nicht, steht dort „Meldet sich nicht“.

Konfiguration und Updates holt sich der Warteraum selbst bei MRadmin ab. Für Leistung, Protokoll und Konsole (unten) fragt MRadmin den Warteraum an seinem eigenen Port ab. Die Erstinstallation machst du von Hand (Anleitung von MRwaitroom).

Leistung des Warteraums

Unter Server → Warteraum → Leistung siehst du den Warteraum-Server genau wie deinen eigenen unter Server → Hauptserver → Leistung: TPS, Millisekunden pro Tick, CPU, Arbeitsspeicher, Spieler, Welten und die Chunks mit den meisten Entities, mit denselben Zeiträumen (1 Minute bis 30 Tage). Permission wie beim Hauptserver (mradmin.status.health).

  • MRadmin fragt den Warteraum jede Sekunde ab und zeichnet genauso auf wie beim Hauptserver: die letzte Stunde pro Sekunde, 24 Stunden als 10-Sekunden-Punkte, länger als 5-Minuten-Punkte, die gespeichert werden (health.history).
  • Laggt der Warteraum länger, kommt dieselbe Lag-Warnung wie beim Hauptserver, nur mit „Warteraum“ im Text (im Spiel und als Push, Art „Lag“).
  • Die Adresse findet MRadmin selbst: der Warteraum meldet seinen Port (agent.port, Standard 8127) und MRadmin nimmt die Adresse, von der seine Berichte kommen. Fest einstellen geht mit waiting-room.agent-url (z.B. http://10.0.0.6:8127).

Der Port braucht im Netz zwischen den beiden Servern eine Freigabe (Firewall) vom Hauptserver zum Warteraum. Am besten lauscht er nur auf der internen Adresse (agent.bind in MRwaitroom).

Protokoll und Konsole des Warteraums

  • Server → Warteraum → Protokoll zeigt die Ereignisse des Warteraums (gestartet, Neustart, Hauptserver weg und wieder da, Konfiguration und Updates aus MRadmin) und sein Server-Log der letzten 14 Tage - mit Suche, Zeitraum und Diagramm wie beim Hauptserver. Die Ereignisse speichert MRadmin in seinem eigenen Protokoll (logging.keep-days), im Protokoll des Hauptservers stehen sie nicht.
  • Server → Warteraum → Konsole zeigt die Ausgabe live und nimmt Befehle an - mit denselben Regeln wie beim Hauptserver: Permission mradmin.web.console.execute, Entsperren mit 2FA-Code oder Passkey (gilt für beide Konsolen), Sperrliste web.console.blocked, jeder Befehl im Web-Protokoll (mit „[waitroom]“). Links und IP-Adressen werden wie beim Hauptserver ausgeblendet.
  • Im Warteraum lassen sich Befehle aus MRadmin mit agent.console-commands: false ganz abschalten - die Konsole zeigt dann nur die Ausgabe.

Warteraum-Server steuern

Server → Warteraum → Steuerung steuert den Warteraum-Server wie den Hauptserver (Permission mradmin.server.restart):

  • Werte: Zustand (mit wartenden Spielern), läuft seit, Paper-Build (gelb, wenn ein neuerer Build für dieselbe Minecraft-Version da ist - der Starter spielt ihn beim nächsten Start ein), Starter, nächster geplanter Neustart.
  • Neu starten und Stoppen in 15, 30 oder 60 Minuten (versions.restart-delays), optional mit Grund. Kürzere Zeiten über Notfall - erst neu bestätigen (2FA-Code oder Passkey), dann Pflicht-Grund (versions.emergency-delays).
  • Ein laufender Countdown steht mit Uhr, Auslöser und Grund in der Kachel, Abbrechen beendet ihn.
  • Mit geplanten Neustarts (server.restart-times in MRwaitroom): Automatische Neustarts 24 h aussetzen / Wieder einschalten.
  • Darunter die Plugins des Warteraums und seine letzten Ereignisse.

Ein Neustart wartet zur Zeit noch, bis er darf:

  • dein Server läuft und ist bereit,
  • keine Wartung läuft,
  • kein Neustart deines Servers in den nächsten 15 Minuten ansteht,
  • niemand im Warteraum wartet (höchstens 10 Minuten, dann wird er aufgegeben).

Ist etwas davon schon beim Klick nicht erfüllt, ist der Knopf gesperrt und der Grund steht darunter. Ein Stopp und ein Notfall-Neustart warten nicht - Wartende kommen dann über den Proxy auf deinen Server. Ohne Starter bleibt der Warteraum nach einem Stopp aus.

Solange der Warteraum neu startet, lehnt MRadmin Neustart und Stopp deines Servers ab (Browser, /mradmin restart|stop, mrserver) - die Spieler hätten sonst keinen Platz zum Warten. Das dauert meist nur ein paar Sekunden.

Hinweise und Warnungen

  • Die Übersicht (Dashboard) und die Zähler in der Seitenleiste zeigen den Warteraum mit: meldet er sich nicht (rot), laggt er, läuft ein Countdown.
  • Die Lag-Warnung kommt im Spiel, als Push (Art „Lag“) und in den Discord-Log (Ereignisse waitroom-health-alert und waitroom-health-recovered in discord.events).
  • Unter Server → Warteraum → Plugins stehen in derselben Tabelle wie beim Hauptserver MRwaitroom (verwaltbar) und alle anderen Plugins des Warteraum-Servers. Für fremde Plugins lässt sich ein GitHub-Link hinterlegen - MRadmin zeigt dann das neueste Release und ob die installierte Version aktuell ist (nur Anzeige, keine Updates).
  • Seine Konfiguration steht unter Server → Warteraum → Konfiguration. Eine eigene Wartung hat der Warteraum nicht - die Wartung gilt fürs ganze Netzwerk und steht beim Hauptserver.
  • Im Protokoll des Warteraums stehen auch die Web-Aktionen zu ihm (Neustart, Stopp, Aussetzen, Befehle in seiner Konsole) - im Protokoll des Hauptservers nicht.

Rechte im Warteraum

Was das Team rund um den Warteraum darf, legst du in einer Tabelle fest: Konfiguration von MRadmin → Warteraum → Rechte pro Rolle (waiting-room.rights). Zeilen sind die Team-Rollen Admin, Staff und Supporter (es zählt die höchste von mradmin.groups.admin, .staff, .support), jede Zelle ist Nein, Ja oder Nur im Admin-Modus. Normale Spieler haben keines der Rechte.

Recht Bedeutung Admin Staff Supporter
Bei Wartung auf den Server Bleibt bei einer Wartung auf deinem Server bzw. kommt hinein - sonst wartet man im Warteraum Nur im Admin-Modus Nein Nein
Warteraum besuchen Knopf In den Warteraum im Admin-Menü (/mradmin), auch wenn nichts los ist Nur im Admin-Modus Nein Nein
Im Warteraum bleiben Wird nicht automatisch zurückgeschickt; zurück mit dem Item Zurück zum Server Nur im Admin-Modus Nein Nein
Admin-Modus im Warteraum Item Admin-Modus in der Hotbar des Warteraums Ja Nein Nein

Mit den Standardwerten ist ein Admin ohne Admin-Modus ein normaler Spieler: Bei einer Wartung landet er im Warteraum und wird danach wie alle zurückgeschickt. Bei Neustarts wechseln immer alle in den Warteraum - das ist kein Recht. Die Tabelle gilt nur mit eingeschaltetem Warteraum; ohne ihn bleibt bei der Wartung alles beim Wartungs-Bypass (mradmin.maintenance.bypass). Der Warteraum bekommt die Tabelle von MRadmin, dort stellst du nichts davon ein.

Admin-Modus im ganzen Netzwerk

Der Admin-Modus gilt auf beiden Servern: Wer ihn im Warteraum einschaltet, kommt auf deinem Server im Admin-Modus an (Inventar gesichert wie gewohnt); wer ihn dort ausschaltet, bekommt beim Zurückkommen sein Inventar wieder. Umgekehrt ist, wer bei dir im Admin-Modus ist, auch im Warteraum im Admin-Modus. admin-mode.end-on-quit wirkt mit Warteraum nicht - der Wechsel in den Warteraum ist kein Verlassen.

Wartung läuft und du willst auf den Server? Im Warteraum mit dem Item links in der Hotbar den Admin-Modus einschalten, dann mit Zurück zum Server (rechts) hinüber.

Umgekehrt passt MRadmin auf: Startet der Warteraum gerade selbst neu, wenn der Countdown deines Servers abläuft, wartet MRadmin bis zu 2 Minuten auf ihn, bevor es herunterfährt.

Einstellungen

Schlüssel Standard Bedeutung
waiting-room.enabled false Warteraum nutzen
waiting-room.server waitroom Name des Warteraums im Proxy
waiting-room.on-restart true Vor Neustart und Stopp alle in den Warteraum schicken
waiting-room.on-maintenance true Bei Wartung in den Warteraum statt Kick
waiting-room.link.bind 127.0.0.1 Adresse der Schnittstelle (leer = keine)
waiting-room.link.port 8126 Port der Schnittstelle
waiting-room.link.key (erzeugt) Gemeinsamer Schlüssel mit dem Warteraum
waiting-room.rights siehe oben Rechte pro Team-Rolle (Rechte im Warteraum)

Häufige Fragen

Was passiert bei einem Absturz? Velocity schickt die Spieler von selbst in den Warteraum, wenn die Verbindung zum Hauptserver unerwartet abbricht (failover-on-unexpected-server-disconnect = true, Standard). Der Warteraum zeigt dann „Server startet neu · seit …“.

Und bei /stop in der Konsole? Das ist kein Countdown von MRadmin - Paper wirft die Spieler raus. Nutze /mradmin stop bzw. /mradmin restart, dann wechseln sie vorher in den Warteraum.

✎ Auf GitHub bearbeiten·docs/wiki/warteraum.md ↗