MRadmin

Der Werkzeugkasten für dein Server-Team: Wartungen mit Countdown, Tickets und Reports, Admin-Modus, Spieler-Werkzeuge, Ankündigungen, Staff-Chat - im Spiel über Menüs und vom Handy über eine eigene Weboberfläche. Außerdem verbindet MRadmin alle anderen MRtechnology-Plugins miteinander.

#Was kann MRadmin?

• Wartungsarbeiten: Während einer Wartung kommt nur das Team auf den Server. Geplante Wartungen kommen auf Wunsch live aus Uptime Kuma, vorher läuft eine Bossbar mit Countdown.
• Tickets & Reports: Spieler melden Regelverstöße, Bugs und Fragen mit /report über ein Menü. Das Team antwortet im Spiel oder im Web - wie in einem Chat.
• Admin-Modus: Creative und ein Menü-Item. Beim Beenden ist alles wieder exakt wie vorher - Inventar, XP, Leben, Position.
• Spieler-Werkzeuge: hinteleportieren, herholen, Inventar und Enderchest ansehen, einfrieren, kicken.
• Ankündigungen auf dem Bildschirm aller Spieler, mit Vorlagen (z.B. fürs Restart-Script) und auf Wunsch im Community-Discord.
• Admin-Dashboard mit Live-Kacheln, Serverzustand und Staff-Chat.
• Weboberfläche fürs Handy: Tickets, Spieler, Serverzustand, Wartungen, Push-Benachrichtigungen - mit 2FA und Passkeys.
• Spielerseite im Web (/web): Jeder Spieler bekommt seine eigene Seite - eigene Tickets, Ranglisten und alles, was die anderen Plugins anbieten (z.B. Chunkloader verwalten, Duell-Statistik). Als Lesezeichen speicherbar, Deutsch und Englisch.
• Karte: eigene Karte auf der Spielerseite mit den Ebenen der anderen Plugins (z.B. Chunkloader, Wegpunkte) - squaremap rendert sie, MRadmin installiert, aktualisiert und richtet es selbst ein.
• Plugins, Updates & Einstellungen: alle MRtechnology-Plugins im Web - im Browser einstellen (config.yml als Formular, sofort neu geladen), installierte mit ihren Updates (per Klick herunterladen, Installation beim nächsten Neustart), nicht installierte direkt installieren, den Server mit Countdown neu starten.
• Discord-Logs, Update-Prüfung, eine Permission für jede Funktion, jede Funktion einzeln abschaltbar.

#Schnellstart

1. MRadmin herunterladen und die JAR in den Ordner plugins/ legen.
2. Den Server starten. Dabei entstehen plugins/MRadmin/config.yml und die Sprachdateien in plugins/MRadmin/lang/.
3. Rechte geben - es gibt fertige Gruppen (in allen MRtechnology-Plugins gleich aufgebaut):

   /lp group default permission set mradmin.player true
   /lp group supporter permission set mradmin.groups.support true
   /lp group staff permission set mradmin.groups.staff true
   /lp group admin permission set mradmin.groups.admin true
   

4. Fertig: /mradmin öffnet das Dashboard, Spieler erstellen Tickets mit /report.

Alles andere ist optional: Uptime Kuma für geplante Wartungen, ein Discord-Webhook für Logs, die Weboberfläche fürs Handy.

Update: Die alte JAR durch die neue ersetzen und den Server neu starten. Die Config wird automatisch angepasst: Deine Werte bleiben, neue Optionen kommen dazu, die alte Datei wird als config.v<N>.backup.yml gesichert.

#Funktionen ein- und ausschalten

Alles, was du nicht brauchst, schaltest du unter features in der Config ab (/mradmin reload genügt):

features:
  maintenance: true    # Wartungsmodus inkl. Uptime Kuma
  announce: true       # Ankündigungen
  admin-mode: true     # Admin-Modus und Menü-Item
  teleport: true       # zu Spielern teleportieren
  summon: true         # Spieler herholen
  inventory: true      # Inventar/Enderchest ansehen
  freeze: true         # Einfrieren
  server-status: true  # Serverzustand
  tickets: true        # Tickets & Reports (/report)
  staff-chat: true     # Staff-Chat (/sc)

Eine ausgeschaltete Funktion verschwindet komplett aus Befehlen, Menüs und Web. Ihre Daten (Tickets, geplante Wartungen) bleiben erhalten.

#Admin-Dashboard

/mradmin (oder Rechtsklick mit dem Menü-Item) öffnet das Dashboard:

• Live-Kacheln für Spieler, Server, Wartung und Tickets. Darunter zeigt eine farbige Scheibe den Zustand, z.B. TPS (grün ab 19,5, gelb ab 15), Wartung (gelb = geplant, rot = aktiv), Tickets (rot = warten auf Antwort).
• Ankündigen: die eigenen Vorlagen als Knöpfe (die eingebauten aus der Sprachdatei stehen nicht im Menü), „Eigener Text“ öffnet einen Dialog.
• Plugin-Knöpfe: Admin-Menüs der anderen MRtechnology-Plugins mit Live-Infos. Eigene Knöpfe (z.B. für Chunky) gehen über admin-mode.menu.buttons.
• Schalter für Admin-Modus und Staff-Chat.

Fehlt eine Permission, fehlt einfach der Knopf. Alle Befehle zeigt /mradmin help.

#Admin-Modus

• /mradmin mode on (oder der Schalter im Dashboard): Inventar, Rüstung, XP, Leben, Hunger, Effekte, Flugstatus und Position werden gespeichert. Danach bist du im Creative-Modus mit dem Menü-Item (Strukturleere, admin-mode.compass-material).
• /mradmin mode off: Alles wird exakt wiederhergestellt, und du landest wieder am Ausgangspunkt.
• Gespeichert wird vor jeder Änderung - auch ein Absturz verliert nichts. Du bist danach einfach noch im Admin-Modus.
• Im Admin-Modus kann man nichts fallen lassen oder aufheben, damit keine Creative-Items ins Survival gelangen.
• /mradmin mode list zeigt, wer im Admin-Modus ist. /mradmin mode off <spieler> beendet ihn für andere.

#Spieler-Menü & Serverzustand

Spieler-Menü (Menü-Item → Spieler teleportieren → Kopf anklicken, oder /mradmin player <spieler>):

• Infos: Position, Spielmodus, Leben, Ping, Spielzeit, erster Join
• Hinteleportieren und zu mir holen (Shift-Klick auf einen Kopf teleportiert direkt)
• Inventar und Enderchest ansehen - live und nur lesend
• Einfrieren: Der Spieler kann sich nicht bewegen, bauen oder kämpfen und nimmt keinen Schaden. Ausloggen hilft nicht.
• Seine Reports und die Infos aus den anderen MRtechnology-Plugins

Serverzustand (Dashboard → Server oder /mradmin status): TPS, MSPT, RAM, Chunks, Entities und Spieler pro Welt. Darunter mit MRchunks die auffälligen und gesperrten Chunkloader, ohne MRchunks die Chunks mit den meisten Entities - ein Klick teleportiert hin.

#Tickets & Reports

• /report (auch /ticket, /support) öffnet für alle Spieler das Ticket-Menü: neues Ticket, offene Tickets (neue Antworten leuchten) und das Archiv.
• Neues Ticket: Kategorie wählen, dann ein Formular ausfüllen. Bei Spieler-Reports wird erst der Spieler gewählt. /report <spieler> springt direkt zur Auswahl des Grundes. Der Standort wird mitgespeichert.
• Kategorien legst du unter tickets.categories an. Standard: Cheating, Chat, Griefing, Betrug, Bug, Frage/Sonstiges.
• Im Ticket steht der Verlauf wie in einem Chat. Wer offline ist, erfährt beim nächsten Join von neuen Antworten.
• Das Team bekommt neue Tickets mit [Öffnen] [Teleport] [Alle Tickets]. Unter Dashboard → Tickets oder /mradmin tickets: filtern, antworten, übernehmen, schließen, wieder öffnen. Wer zuerst antwortet, übernimmt das Ticket automatisch.
• Automatische Tickets von Plugins: Meldet ein Plugin ein Problem eines Spielers, bekommt er automatisch ein Ticket - z.B. mit MRchunks, wenn sein Chunkloader wegen Lag gesperrt wird, mit allen Messwerten. Schließen kann es nur das Team. Abschalten mit tickets.plugin-reports: false.

#Staff-Chat

/sc <nachricht> schreibt an alle mit mradmin.staffchat, auch aus der Konsole. /sc ohne Text schaltet um: Dann geht dein normaler Chat ans Team. Spiegeln in den Admin-Discord ist optional (Event staff-chat).

#Wartungsarbeiten

#Ohne Uptime Kuma

#Uptime Kuma

Wartungen, die du in Uptime Kuma planst, übernimmt MRadmin live - inklusive Countdown. Wird eine Wartung in Kuma verlängert, verschoben oder abgesagt, passt sich alles sofort an, und die Spieler werden informiert.

uptime-kuma:
  enabled: true
  url: "https://status.deinserver.de"
  username: "admin"
  password: "geheim"
  monitor-ids: [12]      # nur Wartungen, die den Minecraft-Monitor (ID 12) betreffen

• 2FA in Kuma aktiv? Dann statt Passwort den Login-Token eintragen (token): im Browser bei Kuma einloggen, F12 → Anwendung → Local Storage → Wert von token kopieren.
• monitor-ids / maintenance-ids legen fest, welche Wartungen für diesen Server gelten (beide leer = alle).
• Ist Kuma nicht erreichbar, bleibt die zuletzt bekannte Planung gültig, und MRadmin verbindet sich automatisch neu.
• Unterstützt werden alle Wartungsarten von Kuma: einmalig, wiederkehrend, Cron und manuell. /mradmin maintenance refresh fragt sofort neu ab.

#Ankündigungen

/mradmin announce Heute Abend Event am Spawn!
/mradmin announce Achtung | Der Nether wird gleich zurückgesetzt
/mradmin announce restart 5 Minuten

• Eigener Text erscheint als Titel auf dem Bildschirm. Mit | trennst du Titel | Untertitel. Farben im MiniMessage-Format sind erlaubt.
• Eigene Vorlagen legst du in der Weboberfläche unter Kommunikation → Ankündigungen an (mradmin.announce.templates): Titel, Untertitel, Chat und Actionbar je Deutsch und Englisch mit Vorschau, optional ein Discord-Text, Anzeigedauer des Titels, Ton und Zielgruppe (Spieler, Bots, Support, Staff, Admin - jede Gruppe bekommt auch, was für die darunter gedacht ist; „Spieler“ = alle). Sie gehen im Web, im Ankündigungs-Menü und mit /mradmin announce <name>. Werte nach dem Namen füllen <arg1>, <arg2> … bzw. <args>.
• Eingebaute Vorlagen (restart, restart-now, update, event) stehen in der Sprachdatei unter announce-presets. MRadmin nutzt restart selbst (Neustart-Countdown); in den Menüs stehen sie nicht, mit dem Befehl und in Skripten gehen sie weiter.

mcrcon -p "$RCON_PW" "mradmin announce restart 5 Minuten"; sleep 240
mcrcon -p "$RCON_PW" "mradmin announce restart 1 Minute";  sleep 60
mcrcon -p "$RCON_PW" "mradmin announce restart-now" "stop"

#Ankündigungen im Community-Discord

Ein eigener Webhook für deinen öffentlichen Channel (discord-announce), getrennt vom Admin-Log. Er postet sparsam:

• Eine Nachricht pro Wartung, höchstens 24 Stunden vorher (announce-ahead). Sie wird mitgeführt statt neu gepostet: „Wartungsarbeiten geplant“ → „Wartungsarbeiten laufen“ → „Server wieder online“ mit der tatsächlichen Zeit (bei vorzeitigem Ende mit Hinweis) oder „Wartung abgesagt“. Neue Zeiten werden in dieselbe Nachricht eingetragen. Die Rolle aus ping-role-id wird nur beim ersten Post erwähnt.
• Ankündigungen, wenn die Vorlage einen discord-Text hat. Eigene Texte nur mit -d: /mradmin announce -d Heute Abend Event!. Mit -q geht eine Vorlage nicht nach Discord.

Zeiten erscheinen als Discord-Zeitstempel - jeder sieht sie in seiner Zeitzone. Test: /mradmin discord test announce.

Discord benachrichtigt bei bearbeiteten Nachrichten nicht. Beginn und Ende einer Wartung sieht also, wer in den Channel schaut - der Ping kommt nur, wenn die Wartung zum ersten Mal gepostet wird.

#Weboberfläche

MRadmin vom Handy, Tablet oder PC bedienen: Übersicht mit Live-Werten, Tickets, Spieler, Serverzustand, Wartungen und Ankündigungen, Push-Benachrichtigungen, dazu Seiten für Chunkloader, Schlaf und Duelle, wenn die Plugins installiert sind. Im Web gelten dieselben Rechte wie im Spiel.

1. In der Config web.enabled: true und web.public-url auf deine Adresse setzen (z.B. https://admin.deinserver.de), dann /mradmin reload.
2. Reverse Proxy einrichten: deine Domain mit HTTPS → http://127.0.0.1:8125.
3. Im Spiel /mradmin web setup → Link öffnen → Passwort festlegen und Authenticator-App verbinden. Fürs Team: /mradmin web invite <spieler>.

Anmeldung immer mit Passwort und Code aus der Authenticator-App - oder per Passkey (Fingerabdruck, Face ID, Windows Hello) oder Discord. Alle Funktionen, Sicherheitsdetails, die Web-Konsole, Entbannungsanträge und das Kontaktformular: Weboberfläche im Detail.

Items wie im Spiel: Inventare und Kits zeigt die Weboberfläche mit den echten Item-Bildern und -Namen samt Tooltip. Dafür lädt MRadmin beim ersten Start einmal den offiziellen Spiel-Client von Mojang (rund 40 MB) und speichert daraus nur die fertigen Bilder unter plugins/MRadmin/items/. Abschalten mit web.item-icons: false - dann stehen Kürzel statt Bildern da.

#Spielerseite (/web)

Neben dem Team-Bereich hat jeder Spieler seine eigene Seite in der Weboberfläche. Standardmäßig ist sie aus.

1. Die Weboberfläche muss laufen (web.enabled, web.public-url, siehe oben).
2. In der Config player-web.enabled: true, dann /mradmin reload.
3. Spieler brauchen mradmin.web.self - das steckt in mradmin.player.

Für das Team: Wer im Team-Bereich angemeldet ist, kommt über Zur Spielerseite im Menü hinter dem eigenen Namen oben rechts (oder auf dem eigenen Eintrag unter Spieler) ohne Code zur Spielerseite. Das geht nur mit dem eigenen Konto, braucht ebenfalls mradmin.web.self und steht im Web-Protokoll.

Für Spieler: Die Seite hat immer dieselbe Adresse (<deine Adresse>/me) - am besten als Lesezeichen speichern. Zum Anmelden fragt sie nach einem 6-stelligen Code: /web im Spiel eingeben, der Chat zeigt den Link zur Seite und den Code (ein Klick auf den Code kopiert ihn). Der Code gilt 2 Minuten und nur einmal (player-web.code-seconds). Danach bleibt das Gerät höchstens 14 Tage angemeldet (player-web.session-days) und wird schon nach 7 Tagen ohne Besuch abgemeldet (player-web.idle-days) - dann fragt die Seite einfach wieder nach einem Code. /web devices zeigt, auf wie vielen Geräten man angemeldet ist, /web logout meldet alle ab - einzelne Geräte gehen auch auf der Seite unter Geräte (Klick auf den eigenen Namen oben rechts), dort steht auch, wie lange die Anmeldung noch gilt.

Was auf der Seite steht, hängt davon ab, was installiert ist:

Die Seite gibt es auf Deutsch und Englisch (Umschalter oben). Gesperrte Spieler (LibertyBans) kommen nicht hinein. Jedes Plugin prüft bei jeder Aktion dieselben Permissions und Regeln wie im Spiel.

Neuigkeiten, Changelogs und Warnungen (Team): In der Weboberfläche unter Kommunikation (Permission mradmin.news, in mradmin.groups.admin; dort auch die Ankündigungen mit mradmin.announce). Neuigkeiten mit Titel und Text, Changelogs mit Version, Einträgen (Neu, Geändert, Behoben, Entfernt) und Überschriften in drei Ebenen (z.B. „Plugins“ → „MRpvp“, eingerückt), kritische Warnungen, die sofort an alle Online-Spieler gehen (Chat und Titel, player-web.news.alerts). Texte auf Deutsch und Englisch - eine leere Sprache zeigt die andere. Pro Beitrag optional auch im Discord posten (Kanal von discord-announce, mit Link zur ganzen Nachricht). Neue Neuigkeiten und Changelogs bekommt jeder Spieler einmal als Vorschau im Chat mit Link (player-web.news.chat-preview). Vorfälle, die auf einer Uptime-Kuma-Statusseite angeheftet sind (uptime-kuma.status-pages), erscheinen wie eigene Warnungen und im Discord (discord-announce.kuma). Karussell: player-web.news (seconds, slides, show-maintenance, show-restart, show-plugin-notices, show-tickets). Details in docs/WEBOBERFLAECHE.md.

#Protokoll

In der Weboberfläche unter Protokoll (Permission mradmin.web.audit) stehen alle Ereignisse von MRadmin und den anderen MRtechnology-Plugins - dieselben wie in ihren Discord-Logs, auch wenn Discord aus ist - und alle Aktionen in der Weboberfläche: neueste oben, nach Tagen gegliedert, filterbar nach Herkunft, Text und Zeitraum, neue Einträge erscheinen sofort. Aufgehoben werden sie logging.keep-days Tage (höchstens 14) in plugins/MRadmin/logs/. Mit mradmin.web.console.view steht dort auch die Ausgabe der Server-Konsole als Quelle Konsole in derselben Liste - live und die älteren Tage aus Papers Logdateien (bis zu 14 Tage). Befehle ausführen geht nur auf der Seite Konsole (Admins).

#Plugins & Updates

In der Weboberfläche unter Plugins (Seite „Plugin-Konfiguration“) siehst du alle MRtechnology-Plugins: oben die auf deinem Server mit installierter und neuester Version und ob ein Update wartet, darunter die übrigen. Ein Klick auf ein installiertes Plugin öffnet seine Seite mit „Was ist neu“.

• Installieren: Nicht installierte Plugins installierst du mit einem Klick. MRadmin lädt das offizielle Release für deine Minecraft-Version (nur mit passender Prüfsumme) nach plugins/ - geladen wird es beim nächsten Neustart. Gibt es bisher nur Vorabversionen (z.B. MRpvp 0.x), wird die neueste davon angeboten.
• Einstellen im Browser: Auf der Seite eines installierten Plugins gibt es den Reiter Konfiguration: alle Einstellungen der config.yml als Formular mit Erklärungen (Deutsch/Englisch). Speichern prüft jeden Wert, schreibt die Datei (Kommentare bleiben, die alte Datei liegt als config.backup-web.yml daneben) und lädt das Plugin sofort neu - ohne Befehl, ohne Neustart. Von Hand bearbeiten geht weiterhin. Permission mradmin.config (in mradmin.groups.admin). Verfügbar für MRadmin und alle MRtechnology-Plugins in aktueller Version.
• Herunterladen holt die neue Version aus dem offiziellen Release auf GitHub - nur für deine Minecraft-Version und nur, wenn die Prüfsumme (SHA-256) stimmt. Sie landet in plugins/update/, installiert wird beim nächsten Neustart (das macht Paper selbst). Im laufenden Betrieb wird nichts ausgetauscht. Der Dateiname bleibt dabei der alte (z.B. MRsleep-mc26.3-v1.1.5.jar mit Version 1.2.0 darin) - nur so weiß Paper, welches Plugin ersetzt wird. Welche Version läuft, zeigt die Seite Plugins bzw. /<plugin> version.
• Automatisch: versions.auto-download: patch lädt z.B. Hotfixes (1.2.x) von selbst, minor auch neue Funktionen, all alles. Standard ist off.
• Server neu starten: Nach dem Herunterladen oder Installieren zeigt die Seite „Neustart nötig“. Einen Neustart-Knopf mit Countdown (versions.restart-delays, Standard 5 Minuten, 1 Minute, sofort, angekündigt wie /mradmin announce restart) gibt es nur, solange ein heruntergeladenes Update oder ein neu installiertes Plugin auf den Neustart wartet, und erst, wenn du versions.restart-method einstellst - denn ein Server kann sich nicht selbst wieder starten, das muss etwas außerhalb tun:
  • none (Standard): kein Knopf.
  • stop: Der Server stoppt, und dein Start-Skript mit Schleife, ein Wächter oder dein Hoster-Panel startet ihn wieder.
  • script: Der Server startet über das restart-script aus der spigot.yml neu (settings.restart-script).
• Downloads und Neustarts stehen im Web-Protokoll und im Discord-Log (plugin-update-downloaded, server-restart).

Stell stop oder script nur ein, wenn du sicher weißt, dass der Server danach wieder hochkommt - sonst stoppt der Knopf ihn nur. Viele Hoster-Panels starten nach einem normalen Stopp nicht von selbst neu, nur nach einem Absturz. Probier es einmal aus, bevor du den Knopf im Ernstfall benutzt.

#!/bin/sh
while true; do
  java -Xms4G -Xmx4G -jar paper.jar --nogui
  echo "Server stopped - restarting in 5 seconds (Ctrl+C to quit)"
  sleep 5
done

@echo off
:loop
java -Xms4G -Xmx4G -jar paper.jar --nogui
echo Server stopped - restarting in 5 seconds (Ctrl+C to quit)
timeout /t 5
goto loop

#Karte (squaremap)

Die Spielerseite hat einen Tab Karte mit echtem Minecraft-Gelände. Darauf zeigen die anderen Plugins ihre Ebenen - z.B. die eigenen Chunkloader (MRchunks) oder die Server-Wegpunkte (MRwaypoints), jeweils passend für den angemeldeten Spieler, mit Rechtsklick-Aktionen. Die Bilder dafür rendert squaremap, um das du dich nicht kümmern musst:

• Automatisch installiert: Fehlt squaremap, lädt MRadmin das offizielle Release für deine Minecraft-Version von Modrinth (nur wenn die SHA-512-Prüfsumme stimmt). Es ist nach dem nächsten Neustart aktiv.
• Automatisch aktualisiert: Neue squaremap-Versionen landen in plugins/update/, Paper tauscht sie beim nächsten Neustart (geprüft alle map.squaremap.check-hours, Standard 12 Stunden). Abschaltbar mit map.squaremap.auto-install und auto-update.
• Automatisch gerendert: Nach der Installation und nach jedem squaremap-Update rendert MRadmin alle Welten der Karte einmal komplett (alle generierten Chunks, im Hintergrund; map.squaremap.full-render, gemerkt in plugins/MRadmin/map-render.yml). Welten ohne Kartenbilder werden immer gerendert.
• Netherdecke als eigene Karte: squaremap zeigt den Nether von innen. Die Bedrockdecke und was darauf gebaut ist, rendert MRadmin selbst als eigene Karte „Nether · Decke“ (Bilder in plugins/MRadmin/map-roof/): einmal komplett im Hintergrund, danach jeder Chunk, in dem sich oben etwas ändert. Steht ein Spieler auf der Decke (ab Y 128), springt die Karte bei „Zu mir“ und „Folgen“ von selbst dorthin, sonst über die Welt-Auswahl. Wegpunkte und Chunkloader erscheinen auf der Karte, auf der sie liegen (Decke ab Y 128 bzw. darunter). Einstellungen unter map.nether-roof (enabled, from-y, full-render, chunks-per-second).
• Version im Blick: Auf der Seite Plugins steht bei MRadmin auch die squaremap-Version (und ein wartendes Update).
• Automatisch eingerichtet: Bei jedem Start bringt MRadmin die squaremap-Config auf den passenden Stand: squaremaps eigene Webseite aus, schnelle Aktualisierung, keine Spieler auf der Karte, Nether von innen statt der Bedrock-Decke, Namen der Dimensionen. Welten, die einem Plugin gehören (z.B. die Arena-Welt von MRpvp), bleiben von der Karte (map.hide-module-worlds). Was du selbst in plugins/squaremap/config.yml änderst, bleibt. /mradmin map setup überschreibt auch deine Änderungen, map.auto-configure: false lässt die squaremap-Config ganz in Ruhe.

Die Karte gibt es nur in MRadmin - squaremaps eigene Webseite (Port 8080) ist aus, du brauchst keinen Port freizugeben und keinen eigenen Proxy. Die Kartenbilder liefert MRadmin selbst aus, nur an angemeldete Spieler. Dafür muss die Spielerseite eingeschaltet sein (player-web.enabled) und web.public-url stimmen, damit /mradmin map einen Link geben kann.

Spieler auf der Karte (man selbst und die anderen Online-Spieler), Öffnen am eigenen Standort, „Mir folgen“ und das Chunkraster stellst du unter map.player-page ein. Für ein Manhunt z.B. map.player-page.players.others: false - dann sieht jeder nur sich selbst. Spieler im Admin-Modus, im Zuschauermodus und unsichtbare Spieler sehen andere nie (abschaltbar), in players.hidden-worlds genannte Welten zeigen niemanden. Andere Spieler sieht nur, wer mradmin.map.players hat.

/mradmin map gibt Spielern den Link zur Karte. Admins (mradmin.map.admin) sehen dort zusätzlich die squaremap-Version und ob ein Update auf den Neustart wartet oder die Installation fehlgeschlagen ist.

Karte für alle ausschalten: Auf der Seite Karte im Adminportal (früher „Wegpunkte“, mit MRwaypoints auch Kategorien und Wegpunkte) stehen zwei Schalter (mradmin.map.admin): Karte der Spielerseite (aus = der Tab „Karte“ verschwindet für alle Spieler) und Spieler auf der Karte (aus = niemand sieht andere Spieler oder kann nach ihnen suchen). Beide wirken sofort und bleiben über Neustarts.

Bis MRadmin 1.1 hat MRchunks squaremap angebunden, und die Karte war eine öffentliche squaremap-Webseite. Aktualisiere MRadmin und MRchunks gemeinsam - MRadmin übernimmt die Einrichtung aus der alten MRchunks-Config. Ein Reverse-Proxy oder eine Portfreigabe für squaremap kann danach weg.

#Befehle

#Permissions

Jede Funktion hat eine eigene Permission - im Spiel und im Web gleich. Am einfachsten vergibst du die Gruppen. Sie sind in allen MRtechnology-Plugins gleich aufgebaut (<plugin>.player und <plugin>.groups.support|staff|admin), jede Gruppe enthält die darunter. Standardmäßig haben sie nur OPs.

Die Gruppen bringen auch die nötigen LibertyBans-Rechte mit (falls installiert): Support sieht Strafen, Verlauf und die Bann- und Mute-Listen (libertybans.commands, libertybans.list.*), Staff darf kicken, muten und verwarnen, nur Admins bannen. Diese Rechte gelten dann auch für die LibertyBans-Befehle im Spiel.

mradmin.groups.admin enthält das Ausführen von Befehlen in der Web-Konsole - so mächtig wie die Server-Konsole. Gib die Gruppe nur Leuten, denen du den Server anvertraust. Vor dem Öffnen fragt das Web zusätzlich den 2FA-Code ab.

Alle MRtechnology-Plugins auf einmal einrichten: Permission-Übersicht mit fertigen LuckPerms-Gruppen - was Support, Staff und Admin in jedem Plugin dürfen, zum Kopieren.

Einzelnen Leuten gibst du zusätzlich einzelne Rechte, z.B. /lp user <name> permission set mradmin.announce true. Aus einer Gruppe nimmst du eins heraus mit z.B. /lp group staff permission set mradmin.player.kick false.

#Konfiguration

Am einfachsten im Browser: Weboberfläche → Plugins → MRadmin → Konfiguration - jede Einstellung mit Erklärung, Speichern lädt MRadmin sofort neu (Permission mradmin.config). Alles steht außerdem kommentiert in plugins/MRadmin/config.yml, im selben Aufbau wie bei allen MRtechnology-Plugins; Änderungen von Hand übernimmst du mit /mradmin reload. Nur in der Datei: eigene Dashboard-Knöpfe (admin-mode.menu.buttons), web.roles / web.players und neue Ticket-Kategorien.

Sprache: Alle Texte, Vorlagen und Discord-Nachrichten stehen in plugins/MRadmin/lang/<sprache>.yml. Neue Texte aus Updates werden automatisch ergänzt.

• Jeder Spieler bekommt seine Sprache: Mit general.language: auto (Standard) richtet sich MRadmin nach der Sprache, die der Spieler in Minecraft eingestellt hat - Deutsch (auch Österreich und Schweiz) bekommt Deutsch, Englisch bekommt Englisch. Für Sprachen ohne eigene Datei gilt fallback-language (Standard Englisch). Mit language: de oder en bekommen alle dieselbe Sprache.
• Server-Sprache: Discord-Logs und -Ankündigungen, die Serverliste während einer Wartung, Push-Benachrichtigungen, Mails und Notizen in Tickets haben keinen einzelnen Empfänger - sie kommen in general.server-language (Standard en). Auf einem deutschen Server also server-language: de setzen.
• Die Konsole ist immer Englisch.
• Ankündigungen, Wartungs-Countdown, Bossbars und Titel sieht jeder Spieler in seiner Sprache. Die Weboberfläche richtet sich nach der Sprache des Browsers - oder nach der Sprache, die man dort umgeschaltet hat.

#Speicher: YAML, SQLite oder MySQL

Umstellen: type ändern und den Server neu starten - die bisherigen Daten werden übernommen. Die Datenbank-Treiber lädt Paper beim ersten Start selbst herunter.

#Discord

Für das Admin-Log einen Webhook anlegen (Kanal bearbeiten → Integrationen → Webhooks), unter discord aktivieren und die URL eintragen. Welche Ereignisse gesendet werden (Tickets, Wartung, Admin-Modus, Web-Anmeldungen …), stellst du unter discord.events ein. Test: /mradmin discord test.

#Zusammenarbeit mit anderen Plugins

MRadmin, MRsleep, MRchunks, MRtoolbar, MRpvp und MRwaypoints laufen jeweils auch allein. Sind sie zusammen installiert, erkennt MRadmin sie automatisch und passt Menüs und Web von selbst an:

• Dashboard: ein Knopf je Plugin mit Live-Infos.
• Spieler-Menü: die Infos des Spielers aus jedem Plugin.
• Serverzustand: auffällige und gesperrte Chunkloader (MRchunks), wartende Duell-Prüfungen (MRpvp).
• Web: eigene Seiten Chunkloader, Schlaf, Duelle und Wegpunkte fürs Team, auf der Spielerseite (/web) die Bereiche Chunkloader, Duelle und Wegpunkte für die Spieler selbst.

MRadmin ist außerdem die Verbindung zwischen den anderen Plugins - ohne MRadmin bekommen sie voneinander nichts mit:

Einrichten musst du dafür nichts. Eine Verbindung abschalten geht unter integrations (z.B. mrsleep: false). Die Konsole zeigt beim Start, welche Plugins verbunden sind. Für Entwickler: docs/MODULE-API.md.

LibertyBans: Ist es installiert, zeigt MRadmin Strafen im Spieler-Menü und im Web und ermöglicht Entbannungsanträge über die Weboberfläche.

#Mehrere Welten (Multiverse)

MRadmin arbeitet mit beliebig vielen Welten. Multiverse-Core und Multiverse-Inventories sind nicht nötig, werden aber berücksichtigt:

• Admin-Modus und Multiverse-Core: Multiverse setzt beim Weltwechsel den Spielmodus der Welt. Im Admin-Modus wird das abgewiesen, du bleibst in Creative bzw. Spectator. /gamemode funktioniert weiter.
• Admin-Modus und Multiverse-Inventories: Solange der Admin-Modus läuft, tauscht Multiverse-Inventories das Inventar nicht. Beim Beenden kommt dein eigenes Inventar zurück.

Lass admin-mode.return-to-start mit Multiverse-Inventories auf true. Sonst bleibst du nach dem Beenden in der anderen Welt, und dein Inventar landet in deren Gruppe.

#Häufige Fragen

Ein Teammitglied wird bei der Wartung trotzdem gekickt. Es braucht mradmin.maintenance.bypass (in mradmin.groups.support enthalten). Ohne LuckPerms prüft MRadmin die Rechte erst beim Join.

Ich war im Admin-Modus, und der Server ist abgestürzt. Nichts verloren - du bist nach dem Neustart einfach noch im Admin-Modus. /mradmin mode off stellt alles wieder her. Die Dateien in plugins/MRadmin/admin-mode/ bitte nicht löschen.

Ein Rechtsklick mit dem Menü-Item löst ein anderes Plugin aus. Stell in admin-mode.compass-material ein Item ein, das kein anderes Plugin nutzt. Der Kompass ist zum Beispiel das Navigationswerkzeug von WorldEdit und teleportiert dich beim Rechtsklick - darum ist seit dieser Version die Strukturleere (STRUCTURE_VOID) der Standard. Sie lässt sich nicht platzieren.

Im Spectator-Modus kann ich in Menüs nichts anklicken. Das ist normal: Minecraft verwirft Inventar-Klicks von Zuschauern, bevor ein Plugin sie sieht. Wechsle für das Menü kurz in Creative (/gamemode creative). Aus demselben Grund eignet sich admin-mode.gamemode: SPECTATOR nur, wenn du ohne Menüs arbeitest. Die Befehle und die Weboberfläche funktionieren auch dann.

In der Weboberfläche stehen bei Items nur Kürzel statt Bildern. MRadmin konnte die Bilder nicht von Mojang laden (die Konsole sagt beim Start, warum - meist kein Internet am Server) oder web.item-icons steht auf false. Nach dem Beheben /mradmin reload - geladen wird nur einmal pro Minecraft-Version.

Wo sehe ich, welche Plugins verbunden sind? In der Konsole beim Start. Ist ein Plugin zu alt für die Verbindung, steht dort eine Warnung - dann alle MRtechnology-Plugins zusammen aktualisieren.

Ich habe einen Fehler gefunden oder einen Wunsch. Gern über das Formular auf der Website - am besten mit der Ausgabe von /mradmin version.

#Lizenz

MRadmin steht unter der MRtechnology Lizenz (source-available, nicht Open Source). Kurz gesagt:

Die Nutzung erfolgt auf eigenes Risiko - leg vor Updates eine Sicherung an. Maßgeblich ist der vollständige Text in LICENSE.

#Für Entwickler

Selbst bauen mit Java 25: gradlew build → build/libs/ (inkl. Unit-Tests und der Weboberfläche aus web/, Node lädt Gradle selbst). Zum Entwickeln der Oberfläche in web/ npm run dev (leitet /api an ein laufendes MRadmin auf Port 8125 weiter). Modul-API für andere Plugins: docs/MODULE-API.md, Branches und Releases: docs/RELEASES.md.