☰ Contents: MRwaitroom
For developers

Code structure

This page is currently only available in German.

Paper-Plugin für einen Warteraum hinter einem Velocity-Proxy. Kein Bezug zu anderen MR-Plugins im Code: MRadmin liefert über seine Schnittstelle waiting-room.link reines JSON, MRwaitroom liest es.

Pakete

Klasse Aufgabe
MRwaitroom Hauptklasse: Config, Texte, Start/Stopp der Teile, Xaero-ID beim ersten Start erzeugen
Settings alle Werte der config.yml, einmal pro (Re)Load geprüft
ConfigUpdater, Messages, UpdateChecker, util/Versions, util/LanguageChoice gemeinsame Bausteine aller MR-Plugins (von MRsleep übernommen)
link/MainStatus die Antwort von MRadmin (GET /waiting-room/status), tolerant gelesen (unbekannte Felder egal, fehlende neutral)
link/MainLink fragt alle main.poll-seconds (eigener Thread): Port-Check + MRadmin. Zustandsmaschine Phase (RESTART, STOP, CRASH, STARTING, MAINTENANCE, READY), Ausfallart aus der letzten Antwort (kindOf), Neustartdauer gemessen (Median der letzten 10), alles in state.yml gespeichert. Liefert einen unveränderlichen Schnappschuss View
room/Room Welt anlegen (Void-Generator + Plattform, einmalig per Marker im World-PDC - MC 26 legt Zusatzwelten im Hauptweltordner ab), Schutz-Listener, Chat
room/Display jede Sekunde: Item (neuer Name hält die Anzeige über der Hotbar sichtbar, Anzahl = Minuten) und Bossbar pro Spieler in seiner Sprache; Chatzeile beim Betreten
room/Returner Rückkehr in Schüben über den BungeeCord-Kanal (Connect), Wartung nur mit dem gemeldeten Bypass-Recht, Kick nach max-attempts
room/XaeroWorldId schickt bei PlayerRegisterChannelEvent für xaerominimap:main / xaeroworldmap:main Paket 0 + int (Format aus Xaero 26.6.2: LevelMapProperties, Index 0)
command/* /mrwaitroom, /main

Protokoll mit MRadmin

GET <link-url>/waiting-room/status mit Authorization: Bearer <key> → JSON (protocol 1): time, name, ready, stopping, online, restart {at, restart, reason}, maintenance {active, title, start, end, bypass}, alerts [{id, title {de, en}}]. Gegenstück: mradmin/src/main/java/at/marcelr/mradmin/network/WaitingRoom.java. Neue Felder nur additiv; protocol nur bei Änderungen erhöhen, die alte Warteräume nicht lesen können.

Tests

LanguageFilesTest (DE/EN gleiche Schlüssel, Hover), WebConfigFormTest (jede Einstellung hat ein Feld), MainStatusTest (JSON lesen, Ausfallart), VersionsTest (Versionsschema).

✎ Edit on GitHub·docs/DOKUMENTATION.md ↗·View unreleased state