Der Starter startet deinen Paper-Server und bringt ihn von selbst zurück: nach einem Neustart aus MRadmin, nach einem Absturz und wenn der Server hängt. Bei jedem Start spielt er auf Wunsch den neuesten stabilen Paper-Build ein. Gesteuert wird alles aus MRadmin: Neustart-Knopf im Browser, Countdown im Spiel, tägliche Neustarts, Arbeitsspeicher, Paper-Updates.
Der Starter ist freiwillig. Ohne ihn läuft MRadmin wie bisher.
Der Starter steckt in der MRadmin-JAR - es gibt nichts extra herunterzuladen. Er läuft unter Linux (screen oder systemd) und Windows.
Was er kann
- Neustart und Stopp mit Countdown aus dem Browser (Seite Server, Reiter Übersicht), im Spiel (
/mradmin restart,/mradmin stop) oder auf dem Rechner (mrserver restart,mrserver stop). Angekündigt wird im Spiel wie bei/mradmin announce restart(Vorlagenrestartundstopin der Sprachdatei), im Community-Discord nur mitserver.discord-announce: true. - Mit Grund: Jeder Neustart und Stopp steht mit Grund in der Konsole, im Protokoll und im Team-Discord. Eigenen Grund einfach hinten anhängen (
/mradmin restart 5m Hardware-Tausch,mrserver stop 10m Umzug) bzw. im Browser ins Feld Grund schreiben. Ohne eigenen Grund nennt MRadmin ihn selbst: „Geplanter Neustart (05:00)“, wartende Updates (z.B. „Updates: MRchunks 1.2.2, Paper 244“) oder „kein Grund angegeben“. - Tägliche Neustarts zu festen Uhrzeiten (
server.restart-times). Der Countdown beginnt genauserver.countdownvorher (Standard 15 Minuten). Auf der Seite Server kannst du sie 24 Stunden aussetzen (z.B. während eines Events) oder einen laufenden geplanten Neustart überspringen. - Genug Vorlauf für die Spieler: Im Browser stehen für Neustart und Stopp 15, 30 und 60 Minuten zur Wahl (
versions.restart-delays). Kürzere Zeiten gibt es nur über den roten Knopf in der Zeile Notfall (für Neustart und Stopp): Er fragt zuerst noch einmal nach deinem 2FA-Code oder Passkey und dann nach Zeit (versions.emergency-delays) und Grund. Spieler, die gerade ein Duell spielen, bekommen den Countdown als Zeile über der Hotbar statt als Titel über den ganzen Bildschirm. - Abstürze: Fällt der Server aus, startet der Starter ihn nach 10 Sekunden wieder. Nach
server.crashes.maxAbstürzen inserver.crashes.window-minutesMinuten (Standard 3 in 15) gibt er auf - dann stimmt etwas Grundsätzliches nicht und der Server bleibt aus, bis du nachsiehst. - Hänger: Tickt der Server
server.hang-secondsSekunden lang nicht (Standard 180), beendet der Starter ihn und startet ihn neu. - Paper-Updates (
server.paper-update: auto): vor jedem Start der neueste stabile Build deiner Minecraft-Version aus dem offiziellen PaperMC-Download, nur mit passender Prüfsumme. Eine neue Minecraft-Version (z.B. 26.3 → 26.4) spielt er nie ein. Startet ein neuer Build nicht, nimmt der Starter von selbst wieder den alten und überspringt den fehlerhaften. Ob Paper aktuell ist, prüft MRadmin alle 15 Minuten (auch ohne Starter) und zeigt es auf der Seite Server. Mit Starter lädt MRadmin einen neuen Build gleich vorab herunter - die Steuerung zeigt dann „bereit für den Neustart“, und der Neustart muss nicht erst laden. 5 Minuten vor einem geplanten Neustart prüft MRadmin Paper und die Plugins noch einmal. - Meldungen: Abstürze, Hänger, Aufgeben und Paper-Updates stehen nach dem nächsten Start in der Konsole, im Protokoll und im Discord-Log (Ereignisse
server-crash,server-hang,server-gave-up,paper-updated,paper-rollback). - Autostart beim Hochfahren des Rechners.
Einrichten
Neuer Server
Am einfachsten mit einem Befehl (auch auf der Download-Seite zum Kopieren):
| System | Befehl |
|---|---|
| Linux (als normaler Benutzer, nicht root) | curl -fsSL https://mrtechnology.marcelr.at/install.sh | sh |
| Windows (PowerShell) | irm https://mrtechnology.marcelr.at/install.ps1 | iex |
Das Skript prüft Java 25 und installiert es auf Wunsch (Debian/Ubuntu mit sudo apt, Windows mit winget), fragt nach dem Ordner (Standard ~/MINECRAFT/Server bzw. %USERPROFILE%\MINECRAFT\Server, muss leer sein), dem Arbeitsspeicher (min./max.), der öffentlichen Adresse der Weboberfläche (optional), ob du Beta-Versionen willst (Standard nein; ja = die neueste MRadmin-Beta, falls neuer als die stabile Version, und versions.channel: beta für alle Plugins) und der Minecraft-EULA. Dann lädt es MRadmin und Paper (beides mit Prüfsumme), schaltet die Weboberfläche ein (nur lokal auf Port 8125, Speicher SQLite) und richtet auf Wunsch Autostart und Start ein. Weitere MRtechnology-Plugins installierst du danach im Browser unter Server → Hauptserver → Plugins.
Ohne Fragen, z.B. für Skripte: Linux
… | sh -s -- --memory-min 4G --memory-max 4G --web-url https://admin.example.com --accept-eula --yes(dazu--dir <ordner>,--no-start,--betabzw.--stable,--proxy here|docker|<adresse>); Windows über UmgebungsvariablenMR_DIR,MR_MEMORY_MIN,MR_MEMORY_MAX,MR_WEB_URL,MR_PROXY,MR_CHANNEL=beta,MR_ACCEPT_EULA=1,MR_YES=1,MR_START=0vor dem Befehl. Die Skripte sind öffentlich einsehbar: install.sh, install.ps1.
Testserver mit Dev-Builds (jeder Entwicklungsstand) nur mit dem Freigabetoken des Entwicklers: Linux
--dev(fragt nach dem Token) bzw.MR_DEV_TOKEN, WindowsMR_DEV_TOKEN. MRadmin kommt dann als Dev-Build, die anderen Plugins folgen Beta; der Token landet alsversions.dev-tokenin derconfig.yml.
Von Hand:
- Leeren Ordner anlegen und
mrserver.sh(Linux) bzw.mrserver.cmd(Windows) aus dem MRadmin-Download hineinlegen. - Einrichten - lädt MRadmin und Paper selbst herunter (beides mit Prüfsumme) und fragt nach der Minecraft-EULA:
- Linux:
sh mrserver.sh setup - Windows:
mrserver setup
- Linux:
- Autostart einschalten und starten:
./mrserver.sh install, dann./mrserver.sh start(Windows:mrserver install,mrserver start).
Java 25 muss installiert sein (z.B. sudo apt install openjdk-25-jre-headless, unter Windows Adoptium).
Bestehender Server
- Im Spiel oder in der Konsole:
/mradmin starter setup(Permissionmradmin.server.setup). Das legtmrserver.sh,mrserver.cmdundmrserver.propertiesin den Serverordner - nichts Bestehendes wird verändert. Alternativ auf dem Rechner im Serverordner:java -jar plugins/MRadmin-….jar setup. - Den Server ein letztes Mal auf dem alten Weg stoppen und dein altes Start-Skript bzw. dessen Autostart abschalten (sonst starten zwei Programme den Server).
./mrserver.sh installund./mrserver.sh start(Windows:mrserver install,mrserver start).
Altes Skript mit Wächter oder täglichem Neustart per cron (z.B. ein eigenes
start.shodermc.sh): Die cron-Einträge vor dem Umstieg entfernen (crontab -e) - sonst startet der alte Wächter den Server neben dem Starter ein zweites Mal. Tägliche Neustarts stellst du stattdessen inserver.restart-timesein, Arbeitsspeicher inserver.memory-min/memory-max.
Ob der Starter aktiv ist, zeigt
/mradmin starter.versions.restart-methodbrauchst du mit dem Starter nicht mehr.
Wie der Starter läuft (mode)
Einstellung mode in mrserver.properties im Serverordner. setup wählt sie automatisch, ändern mit mrserver setup --mode <modus>, danach mrserver uninstall und mrserver install.
mode |
System | Konsole | Autostart |
|---|---|---|---|
systemd |
Linux mit systemd (Standard, wenn vorhanden) | mrserver attach zeigt die Ausgabe, Befehle mit mrserver console |
systemd-Dienst des Benutzers (kein root nötig) |
screen |
Linux | mrserver attach (verlassen mit Strg+A, dann D) |
Eintrag @reboot in der crontab |
window |
Windows | eigenes Konsolenfenster | Windows-Aufgabe bei der Anmeldung |
foreground |
Docker, Hoster-Panel | im eigenen Terminal (mrserver run) |
macht dein Panel bzw. Container |
systemd: Damit der Server auch läuft, wenn du nicht angemeldet bist, einmal als root
loginctl enable-linger <benutzer>ausführen.mrserver installversucht das selbst und sagt Bescheid, wenn es nicht geht.
Befehle auf dem Rechner
Im Serverordner ./mrserver.sh <befehl> (Linux) bzw. mrserver <befehl> (Windows):
| Befehl | Was er tut |
|---|---|
setup [--accept-eula] [--mode …] [--memory-min 2G] [--memory-max 4G] [--web] [--web-url …] [--proxy here|docker|<adresse>] [--channel stable|beta|dev] |
Ordner einrichten, fehlendes Paper herunterladen; Arbeitsspeicher, Weboberfläche und Kanal übernimmt MRadmin beim ersten Start in die config.yml. --proxy sagt, wo dein Reverse-Proxy läuft: here (dieser Rechner, MRadmin hört nur lokal), docker (Docker auf diesem Rechner: hört auf allen Adressen, vertraut 172.16.0.0/12) oder Adresse/Bereich eines anderen Rechners. --channel gilt nur für einen neuen Server (Dev braucht den Token in MRSERVER_DEV_TOKEN) |
install · uninstall |
Autostart an · aus (ein laufender Server läuft weiter) |
start · run |
im Hintergrund starten · im aktuellen Terminal starten |
stop [zeit|now] · restart [zeit|now] |
mit Countdown stoppen bzw. neu starten (ohne Zeit: server.countdown, Standard 15 Minuten) |
cancel |
Countdown abbrechen |
status |
läuft der Server? Paper-Build, Modus |
console <befehl> |
Befehl an die Server-Konsole schicken |
attach |
Konsole (screen) bzw. Ausgabe (systemd) anzeigen |
Zeiten wie 30s, 5m, 1h, eine Zahl (Sekunden) oder now. Antwortet MRadmin nicht (z.B. nicht installiert), stoppt bzw. startet mrserver sofort ohne Countdown.
Einstellungen
Im Browser bzw. in der config.yml (Abschnitt server, Server → Plugins → MRadmin → Konfiguration → „Starter & geplante Neustarts“ - dort steht oben auch, ob der Starter eingerichtet und aktiv ist). Arbeitsspeicher und Java-Optionen gelten ab dem nächsten Start.
| Schlüssel | Standard | Wofür |
|---|---|---|
server.memory-min · memory-max |
1G · 4G |
Arbeitsspeicher des Servers |
server.java-flags |
leer | zusätzliche Java-Optionen zum Abstimmen (z.B. Aikar-Flags) |
server.paper-update |
auto |
auto = bei jedem Start, notify = nur anzeigen, off |
server.restart-times |
[] |
tägliche Neustarts, z.B. ["05:00"] (Zeitzone general.timezone) |
server.countdown |
15m |
Countdown der geplanten Neustarts und von mrserver stop/restart ohne Zeit |
server.plain-stop |
stop |
was ein einfaches /stop macht: stop = Server bleibt aus, restart = er kommt wieder |
server.discord-announce |
false |
Countdown von Neustart/Stopp auch im Community-Discord (das Team-Log bekommt ihn immer) |
server.crashes.max · window-minutes |
3 · 15 |
wann der Starter aufgibt |
server.hang-seconds |
180 |
Hänger-Erkennung, 0 = aus |
server.stop-timeout-seconds |
180 |
so lange darf das Herunterfahren dauern |
Sicherheit: Über den Browser lassen sich nur Java-Optionen zum Abstimmen setzen. Alles, womit man Programme auf dem Rechner starten oder beliebige Dateien lesen und schreiben könnte (z.B.
-XX:OnOutOfMemoryError,-javaagent, eine log4j-Konfiguration), ignoriert MRadmin mit einer Warnung in der Konsole. Welches Java, welche Paper-JAR und weitere Optionen stehen nur inmrserver.propertiesauf dem Rechner (java,jar,mode,name,java-flags) - die lassen sich im Browser nicht ändern.
Wo die Dateien liegen
mrserver.sh,mrserver.cmd,mrserver.propertiesim Serverordner. Die beiden Skripte erneuert MRadmin bei Updates selbst - bitte nicht bearbeiten.plugins/MRadmin/starter/: Austausch zwischen MRadmin und Starter (launch.properties, Lebenszeichen, Ereignisse),starter.logmit allem, was der Starter getan hat,paper-previous.jar(der Paper-Build vor dem letzten Update).- Nach einem MRadmin-Update nimmt der Starter seine neue Version beim nächsten Neustart von selbst.
Häufige Fragen
Der Server startet nach /stop nicht wieder. Gewollt: server.plain-stop: stop. Zum Neustarten /mradmin restart oder mrserver restart nutzen - oder plain-stop: restart einstellen.
Der Starter hat aufgegeben. mrserver status zeigt es. Sieh in logs/latest.log und crash-reports/ nach, behebe die Ursache und starte mit mrserver start.
Ich will eine neue Minecraft-Version. Das macht der Starter bewusst nicht automatisch, weil dann meist auch die Plugins neue Versionen brauchen. Siehe Installieren & aktualisieren.
Warteraum-Server einrichten
Hinter einem Velocity-Proxy kann der Starter auch einen Warteraum-Server betreiben - dort läuft Paper mit MRwaitroom statt MRadmin:
MRSERVER_LINK_KEY=<waiting-room.link.key> ./mrserver.sh setup --role waitroom \
--main-server main --main-address 10.0.0.5:25565 --link-url http://10.0.0.5:8126
Oder einfach den Installer von der Website nehmen und bei der ersten Frage Warteraum-Server wählen. Danach funktionieren mrserver install|start|stop|restart|status|console wie gewohnt. Arbeitsspeicher, Paper-Updates und geplante Neustarts stellt man in der Konfiguration von MRwaitroom ein (Abschnitt server) - am bequemsten über Server → Warteraum → Konfiguration in deiner Weboberfläche. Neustarts des Warteraums siehe Warteraum (Proxy).
Den Starter selbst aktualisiert auf dem Warteraum niemand automatisch (dort läuft kein MRadmin). Eine neue Starter-Version kommt mit einem erneuten
mrserver setup --role waitroom- das ist selten nötig.