MonolithWIKI
1.21.11 aktiv
MonolithDebug Chunks
MONOLITH WIKIBuild 10

Debug Chunk Mode

Wartungsgebundene Chunk-Vorbereitung mit Doppel-Gate, Weltgrenze, adaptiver Pipeline und atomarer Fortsetzung.

Nur vor dem Start freischaltbar

server.properties
white-list=true
Start mit unveränderlichem Gate
java -Dmonolith.debug.chunk-mode=true -Xms4G -Xmx4G -jar monolith-1.21.11-25.jar --nogui

Wird die Whitelist später ausgeschaltet, wechselt die Engine sofort in LOCKED und sendet keine weitere Chunk-Anfrage. Ein unvollständiger Lauf behält seinen bestätigten Fortsetzungspunkt; ein bereits abgeschlossener Lauf erzeugt dadurch keinen neuen Checkpoint.

Fläche wie eine Weltgrenze einstellen

  1. 01

    Welt wählen

    Verwende den exakten Namen einer bereits geladenen Bukkit-Welt.

    text
    /debugchunks world world
  2. 02

    Mittelpunkt setzen

    X und Z sind Blockkoordinaten und werden korrekt auf den Mittelpunkt-Chunk abgebildet.

    text
    /debugchunks center 10000 10000
  3. 03

    Radius setzen

    Der Blockradius wird nach außen auf vollständige Chunks gerundet.

    text
    /debugchunks radius 5000
  4. 04

    Form wählen

    SQUARE deckt das umschließende Quadrat ab; CIRCLE überspringt Kantenbereiche ohne große Leerschleifen.

    text
    /debugchunks shape circle

Start, Fortschritt und Fortsetzung

text
/debugchunks status
/debugchunks start
/debugchunks pause
/debugchunks resume
/debugchunks stop
/debugchunks reload
/debugchunks reset
BefehlWirkungSicherheitsgrenze
statusZeigt Gates, Fläche, Pipeline, Fortschritt, Rate, ETA, Retries und BerichtKeine Mutation
startStartet neu oder vom bestätigten CheckpointNur mit beiden Gates
pauseStoppt neue Dispatches und lässt offene Anfragen auslaufenCheckpoint bleibt
resumeSetzt denselben Lauf fortFläche unverändert
stopBeendet kontrolliert nach offenen AnfragenKonservativ fortsetzbar
reloadLädt nur monolith-debug-chunks.ymlNur im Leerlauf
resetEntfernt nur den FortschrittKeine Weltdatenlöschung

Begrenzte asynchrone Pipeline

  • Monolith verwendet Papers vorhandenen Moonrise-Chunk-Scheduler und keinen unsicheren privaten Welt-Thread.
  • max-in-flight begrenzt offene Anfragen; dispatch-per-tick begrenzt neue Arbeit je Tick.
  • Oberhalb pause-above-mspt pausiert die Engine, unterhalb resume-below-mspt setzt sie mit Hysterese fort.
  • pause-when-players-online ist standardmäßig aktiv und schützt Wartungsfenster vor versehentlichem Spielerbetrieb.
  • Der Flächenplan benötigt konstanten Speicher; bestätigte Bereiche werden atomar gespeichert.
  • Nach einem Prozessabbruch kann ein jüngster Chunk erneut vorbereitet werden, aber die Engine springt nie über eine unbestätigte Lücke.
Dateien
monolith-debug-chunks.yml
monolith/debug-chunks-progress.json
monolith/reports/debug-chunks-YYYYMMDD-HHMMSS.json

Build-10-Evidenz und Leistungsgrenze

PrüfungBeobachtungErgebnis
Positiver StartFlag + WhitelistDatei und Befehl aktiv
Negativer StartFlag + Whitelist ausKeine Datei, unbekannter Befehl
Entfernte FlächeCIRCLE · Mittelpunkt 10000,10000 · 49 Chunks49/49 · 0 Fehler
Pause/Fortsetzung8 offene Anfragen liefen ausCheckpoint und Abschluss korrekt
Test-Suite100 Monolith-Tests · 9.040 Paper-Tests0 Fehler