☰ Inhalt: MRadmin
Für Admins

Plugins & Updates

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

In der Weboberfläche unter Server → Hauptserver → Plugins siehst du alle MRtechnology-Plugins als Tabelle: oben die auf deinem Server mit installierter Version, Kanal, neuester Version im Kanal (Badge Aktuell, wenn sie installiert ist, Neu, wenn nicht) und ob ein Update wartet, darunter die übrigen. Ein Klick auf ein installiertes Plugin öffnet seine Seite mit „Was ist neu“.

Kanäle: Stable, Beta, Dev

Jedes Plugin folgt einem Kanal - in der Spalte Kanal umschaltbar (mradmin.versions.install):

Kanal Was kommt Für wen
Stable nur stabile Versionen (STA-…) jeden Server - Standard
Beta auch Betas (BET-…) - neue Funktionen früher, noch nicht ganz fertig wer Neues früh ausprobieren will
Dev jeder Entwicklungsstand (nach jedem Commit), unfertig nur Testserver, nur mit Freigabetoken
  • Ohne eigene Wahl folgt ein Plugin dem Standard-Kanal versions.channel (stable oder beta); „zurück auf Standard“ hebt die eigene Wahl wieder auf. 0.x-Plugins gibt es nur als Beta, sie bekommen immer Betas.
  • Zurück auf Stable stuft nie zurück: Läuft eine Beta oder ein Dev-Build, bleibt sie, bis eine neuere stabile Version erscheint (ältere Versionen könnten mit den bereits umgebauten Einstellungen nicht umgehen).
  • Schutz vor Rückschritten - gilt für jeden Kanal, auch für versions.auto-download:
    • Hat die angebotene Version eine kleinere config-version (config.yml) oder lang-version (Sprachdateien) als dein Server, wird sie nicht installiert: deine Einstellungen wurden schon von einer neueren Version umgebaut.
    • Stammen laufender und angebotener Build aus GitHub (alle Releases und Dev-Builds), muss der angebotene ein Nachfolger des laufenden sein. Wichtig nach Dev: Ein Dev-Build trägt die Nummer des letzten Releases - ein späterer Hotfix sähe „neuer“ aus, würde aber die Funktionen des Dev-Builds wieder entfernen. Er wird erst angeboten, wenn er den Dev-Stand enthält.
    • Gesperrte Versionen zeigt die Seite mit „Zurückstufen gesperrt“ und dem Grund. Wer wirklich zurück will, macht es von Hand: alte JAR einspielen und die config.yml aus einem Backup (config.v<nummer>.backup.yml) zurückholen.
  • Stable ist ausgegraut, solange es noch keine stabile Version gibt (Plugins mit bisher nur Betas, 0.x). Beta ist immer wählbar - sie bekommt auch die stabilen Versionen, du kannst also auf Beta bleiben, auch wenn gerade eine Stable die neueste ist.
  • Dev erscheint nur, wenn in der Konfiguration ein gültiger Freigabetoken steht (versions.dev-token, bekommst du vom Entwickler). Ist er falsch, bleibt Dev ausgeblendet und die Seite zeigt einen Hinweis. Die Dev-Builds liegen verschlüsselt im GitHub-Release mc0-dev; MRadmin entschlüsselt sie mit dem Token und prüft die Prüfsumme. Ein Plugin, auf dem ein Dev-Build läuft, ist mit Dev und dem Commit (z.B. Dev c44ebd6) markiert. Dev-Builds lädt versions.auto-download nur bei all von selbst.

Installieren

Nicht installierte Plugins installierst du mit einem Klick (mradmin.versions.install). 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. Installiert wird, was der Kanal des Plugins anbietet (siehe oben); gibt es bisher nur Vorabversionen (z.B. MRpvp 0.x), die neueste davon.

Einstellen im Browser

Jeder Server hat den Reiter Konfiguration (Server → Hauptserver → Konfiguration bzw. Server → Warteraum → Konfiguration, mradmin.config, in mradmin.groups.admin), darin ein Reiter pro Plugin dieses Servers: 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. Verfügbar für MRadmin und alle MRtechnology-Plugins in aktueller Version.

Andere Plugins beobachten

Unter Plugins hat jeder Server zwei Kacheln: MRtechnology-Plugins (verwalten wie oben) und Andere Plugins - alle übrigen Plugins des Servers (z.B. LuckPerms, LibertyBans), beim Hauptserver und beim Warteraum je für sich. Updates spielt MRadmin für sie nicht ein, kann sie aber beobachten:

  • Automatisch: MRadmin fragt Modrinth mit dem Fingerabdruck (SHA-1) jeder Plugin-JAR. Kennt Modrinth die Datei, steht das Projekt mit „auto“ in der Spalte Quelle - und MRadmin weiß genau, welche Version installiert ist.

  • Von Hand: Ein Klick auf die Quelle öffnet ein Fenster (Permission mradmin.versions.install): Reiter Modrinth mit Suche (Treffer zeigen, ob es Versionen für deine Minecraft-Version gibt) oder GitHub (owner/repo oder die github.com-Adresse). Darunter steht vor dem Speichern, welche Version MRadmin vergleichen würde. Automatisch erkennen geht zurück zum Fingerabdruck, Nicht beobachten schaltet die Suche für das Plugin ab.

  • Passend zur Minecraft-Version: Als neueste Version gilt bei Modrinth die neueste für die Minecraft-Version des Servers und einen Paper-tauglichen Loader (Paper, Spigot, Bukkit, Purpur, Folia). Bei GitHub das neueste Release, das die Minecraft-Version nennt (Name, Text oder Dateinamen) - nennt keines sie, das neueste Release mit dem Hinweis MC-Version nicht angegeben. Gibt es gar nichts für die Version, steht dort Keine Version für Minecraft ….

  • Kanal Stable | Beta: Im Fenster lässt sich pro Plugin wählen, ob nur Releases zählen (Stable, Standard) oder auch Betas (Beta) - auch bei automatisch erkannten Plugins, die bleiben dabei „auto“. Gibt es für die Minecraft-Version nur Betas, steht bei Stable Nur Betas für Minecraft …. In der Tabelle zeigt ein kleines Beta neben der Quelle den Kanal.

MRadmin prüft alle 6 Stunden (bei Fehlern nach 15 Minuten wieder) und zeigt Aktuell oder Neu. Plugins mit neuerer Version stehen oben.

Reihenfolge

Die MRtechnology-Plugins sind nach Dringlichkeit sortiert: Fehler und Updates oben, dann was auf einen Neustart wartet, aktuelle Plugins unten.

Updates

  • Herunterladen (mradmin.versions.install) 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 Server → Hauptserver → 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.
  • Geprüft wird alle versions.check-interval-hours und mit Jetzt prüfen (mradmin.versions.install).
  • Downloads und Neustarts stehen im Protokoll und im Discord-Log (plugin-update-downloaded, server-restart).

Server neu starten

Am einfachsten mit dem Starter, der in MRadmin steckt: Er startet den Server nach jedem Neustart, Absturz oder Hänger wieder, spielt Paper-Updates ein und kann täglich neu starten. Dann brauchst du versions.restart-method nicht; neu starten geht außerdem jederzeit mit /mradmin restart.

Nach dem Herunterladen oder Installieren zeigt die Seite „Neustart nötig“. Einen Neustart-Knopf (mradmin.server.restart) mit Countdown (versions.restart-delays, Standard 15, 30 und 60 Minuten, angekündigt wie /mradmin announce restart; kürzere Zeiten nur über den Knopf Notfall mit erneuter Anmeldung und Grund, versions.emergency-delays) gibt es nur, solange ein 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:

versions.restart-method Was passiert
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)

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.

Beispiel: Start-Skript mit Schleife (für restart-method: stop)

Das Skript startet den Server nach jedem Stopp nach 5 Sekunden wieder. Zum endgültigen Beenden in diesen 5 Sekunden Strg+C drücken.

Linux (start.sh, ausführbar machen mit chmod +x start.sh, z.B. in screen oder tmux starten):

#!/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

Windows (start.bat):

@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

Den Speicher (4G) und den Namen der Paper-JAR an deinen Server anpassen.

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