MonolithWIKI
1.21.11 aktiv
MONOLITH WIKIBackend

Installation & Migration

Sicherer Wechsel eines Minecraft-1.21.11-Backends von Paper oder einer älteren Monolith-JAR zu Build 25.

Reicht das Ersetzen der server.jar?

Sichere Migration

  1. 01

    Staging-Kopie erstellen

    Kopiere das gesamte Backend-Verzeichnis einschließlich Welten und Plugins auf eine getrennte Instanz.

  2. 02

    Server regulär stoppen

    Kein JAR-Tausch während des Betriebs. Prüfe, dass der Prozess vollständig beendet ist.

  3. 03

    Offline-Backup anlegen

    Das Backup muss Welten, Konfigurationen, Plugins, Datenbanken und Startskripte gemeinsam enthalten.

  4. 04

    JAR austauschen

    Entferne oder archiviere nur die alte gestartete JAR. Nutzt dein Panel den festen Namen server.jar, darf Build 25 entsprechend umbenannt werden.

  5. 05

    Java 21 beibehalten

    Übernimm bewährte Heap- und GC-Flags zunächst unverändert.

    text
    java -Xms8G -Xmx8G -jar server.jar --nogui
  6. 06

    Start und Smoke-Test

    Prüfe READY, Buildidentität, Plugins, Welten, Bossbars, Proxy-Modus und einen normalen Shutdown.

Bestehende Konfiguration

Build 25 behält config-version: 1 für monolith.yml. Bestehende Schlüssel und Standardwerte bleiben kompatibel. Analytics ist über seinen begrenzten Command-Lifecycle verfügbar; DEEP-Diagnosen sind zeitlich begrenzt. Der echte Client-Schwarm bleibt standardmäßig aus und zusätzlich mehrfach testgebunden. Debug Chunk Mode nutzt weiterhin ausschließlich seine eigene, nur im gesicherten Modus erzeugte Datei.

Prüfsequenz
/monolith version
/monolith runtime
/monolith bossbar status
/monolith reload
/monolith readiness

Rollback

  • Server vollständig stoppen und niemals zwischen laufenden JARs wechseln.
  • Nur auf ein zur Weltversion passendes Paper 1.21.11 oder die zuvor gesicherte Monolith-JAR zurückgehen.
  • Wenn ein Test Weltdaten verändert hat, das vollständige Offline-Backup wiederherstellen statt nur die JAR zu tauschen.
  • Synthetic-Player-Weltdaten werden nicht automatisch zurückgesetzt; Testwelten separat halten.

Verifikationscheckliste

PrüfungSollzustandBefehl oder Evidenz
BuildMinecraft 1.21.11 · Build 25/monolith version
RuntimeKonfiguration ohne Ablehnung angewandt/monolith runtime
PluginsErwartete Plugins aktiv/plugins und Serverlog
ProxyREADY / CONFIGURED oder bewusst DIRECT/monolith proxy
SpeicherungNormaler Save und RegionFile-FlushShutdown-Log