Commands & Diagnostics

Wann verwenden?

• Immer als ersten Schritt bei unbekannter Serverlast.
• Nach einer Änderung erneut ausführen, um die Wirkung leichtgewichtig zu prüfen.

Syntax

/monolith
/monolith status

Ausgabe verstehen

TPS

Tickrate der letzten 1, 5 und 15 Minuten.

MSPT

Average, P95 und P99 der Tickdauer. P95 beschreibt die langsamsten fünf Prozent ohne die extremsten Ausreißer; P99 macht seltene Spikes sichtbar.

Players / Loaded chunks / Entities

Aktuelle Größenordnung der beobachteten Arbeitslast.

Memory

Benutzter Heap im Verhältnis zum maximalen Heap; allein noch keine Leak-Diagnose.

GC

Aktiver Garbage Collector.

Runtime health

Health-Band und transparenter Score von 0 bis 100.

Proxy backend

Erkannter Direkt-, Velocity- oder Bungee-Modus.

Statuswerte

• EXCELLENT 90–100
• GOOD 75–89
• DEGRADED 50–74
• POOR 25–49
• CRITICAL 0–24

Seiteneffekte & automatische Beendigung

• Keine; liest nur den aktuellen Laufzeit-Snapshot.

Wann verwenden?

• Viele Fehler treten in kurzer Zeit auf.
• Vor einem kontrollierten Neustart oder nach einem Recovery-Ereignis.

Syntax

/monolith stability

Ausgabe verstehen

Failure storm mode

ACTIVE oder INACTIVE.

Failures in window / Unique fingerprints

Fehlerhäufigkeit und deduplizierte Signaturen samt Evictions.

Memory pressure / reason

Aktueller Speicherdruck und Scoregrund.

Storage health

Beobachtete Weltintegrität.

Shutdown

Nicht angefordert oder Phase samt verstrichener Zeit.

Fingerprintzeilen

Kurz-ID, Quelle, Häufigkeit und letzte Recovery-Entscheidung.

Seiteneffekte & automatische Beendigung

• Keine; liest nur den aktuellen Laufzeit-Snapshot.

Wann verwenden?

• Vor längeren Tests oder einer Betriebsfreigabe.
• Nach Recovery-, Kill- oder Soak-Tests.

Syntax

/monolith readiness

Ausgabe verstehen

Status

NOT_ASSESSED, BLOCKED oder READY_FOR_EXTENDED_TESTING; niemals eine automatische Produktionsfreigabe.

Checks

Je Gate PASS, FAIL oder NOT_RUN mit konkreter Evidenz.

Limitation

Expliziter Hinweis, dass Backups, Kill-Tests, Soak-Evidenz und Betreiberprüfung extern bleiben.

Statuswerte

• BLOCKED bei mindestens einem FAIL
• READY_FOR_EXTENDED_TESTING nur ohne FAIL und mit drei vollständigen Evidenzdateien
• NOT_ASSESSED ohne FAIL, solange Evidenz fehlt

Seiteneffekte & automatische Beendigung

• Keine; liest nur den aktuellen Laufzeit-Snapshot.

Wann verwenden?

• Konsole zeigt eine Monolith-Fehler-ID.
• Stability meldet neue Fingerprints.

Syntax

/monolith errors

Ausgabe verstehen

MONOLITH RECENT ERRORS

Kennzeichnet die sortierte Fehlerübersicht.

Error ID / category / risk / summary

Identität, Klassifikation, Risiko und Kurzbeschreibung.

Full trace

Pfad zur vollständigen Stacktrace-Datei.

No errors…

In diesem Prozess wurde noch kein Fehler analysiert.

Seiteneffekte & automatische Beendigung

• Keine; liest nur den aktuellen Laufzeit-Snapshot.

Wann verwenden?

• TPS ist dauerhaft niedrig.
• Average MSPT wirkt gesund, aber Spieler melden einzelne Spikes.
• Entity-, Chunk-, Plugin-, Netzwerk- oder Speicherarbeit soll voneinander getrennt werden.

Syntax

/monolith performance

Ausgabe verstehen

TPS

Aktuelle Ein-Minuten-Tickrate.

MSPT AVG / P95 / P99 / MAX

Mittelwert, Tail-Latenz und langsamster gemessener Tick. Ein guter Mittelwert kann gleichzeitig eine schlechte P99 besitzen.

Tick budget

Average MSPT relativ zu 50 ms samt Klasse EXCELLENT bis SEVERE.

P95 / P99 headroom

50 ms minus jeweiliges Perzentil. Negative Werte liegen über dem Tickbudget.

Primary measured cost

Größter aktuell gemessener Hotpath oder unavailable — start a benchmark, wenn keine Evidenz vorliegt.

Entities / Chunks

Geladene und, sofern verfügbar, tatsächlich tickende beziehungsweise aktive Mengen.

Heap / CPU

JVM-Heap und Prozess-CPU; unavailable bleibt ausdrücklich sichtbar.

GC since sample

GC-Pausenzeit und Verhältnis seit der letzten Stichprobe.

Adaptive runtime

NORMAL, CONSTRAINED, RECOVERING oder DISABLED.

Autopsy

OFF, LIGHT, DEEP oder BENCHMARK samt Restzeit und Ringpuffergröße.

Recent spike clusters

Anzahl beobachteter Spikes und zusammengefasster Signaturen.

Primary autopsy boundary

Führende Kategorie der aktuellen Autopsy-Evidenz.

Observed queues

Tiefe der Monolith-Hintergrund- und Save-Warteschlange.

Score factors

Jeder tatsächlich angewandte Health-Abzug.

Statuswerte

• EXCELLENT < 10 ms
• HEALTHY 10 bis < 25 ms
• HEAVY 25 bis < 40 ms
• SATURATED 40 bis < 50 ms
• OVER_BUDGET 50 bis 100 ms
• SEVERE > 100 ms

Seiteneffekte & automatische Beendigung

• Keine; liest nur den aktuellen Laufzeit-Snapshot.

Wann verwenden?

• Der leichte Performance-Überblick zeigt keine eindeutige Ursache.
• Seltene Spikes müssen während eines reproduzierbaren Fensters erfasst werden.

Syntax

/monolith performance diagnose
/monolith performance diagnose 60

Argumente

Ausgabe verstehen

Startmeldung

Bestätigt Dauer, DEEP-Modus, automatische Rückkehr und Artefakterzeugung.

Fehlertext

Nennt ungültige Dauer oder einen konkurrierenden Benchmark beziehungsweise Flight Recorder.

Artefakte

Nach Ablauf entstehen Performance-Analysis- und Autopsy-Dateien; der konfigurierte Low-Overhead-Modus wird wiederhergestellt.

Seiteneffekte & automatische Beendigung

• Aktiviert tiefere Hotpath-Messung für ein begrenztes Zeitfenster.
• Schreibt Diagnoseartefakte.
• Stoppt automatisch nach der gewählten Dauer.

Wann verwenden?

• Ein reproduzierbares Leistungsproblem als lokaler Report erfasst werden soll.
• Vor der Wahl zwischen LIGHT, STANDARD, DEEP und DEVELOPER.

Syntax

/monolith analytics
/monolith analytics help

Ausgabe verstehen

Help

Syntax für Start, Stop, Status, Cancel, History, Export und Compare.

Mode-Hinweis

STANDARD für normale Diagnose; tiefe Modi bleiben hart begrenzt.

Seiteneffekte & automatische Beendigung

• Keine; die Hilfe startet keine Aufnahme.

Wann verwenden?

• Lag, Spikes, Heapwachstum, breite Entity Queries, Pathfinding, Chunk-, Netzwerk-, Plugin- oder Queue-Arbeit reproduziert werden kann.

Syntax

/monolith analytics start
/monolith analytics start standard 60
/monolith analytics start deep 120
/monolith analytics start developer 60

Argumente

Ausgabe verstehen

State

CAPTURING.

Actionbar

Spieler sehen echten Zeitfortschritt, Samples und Spikes.

Report ID

Lokale stabile Kennung für History, Export und Compare.

Statuswerte

• LIGHT ohne CPU-Sampling
• STANDARD als Default
• DEEP mit gesampelten Engine-Zählern
• DEVELOPER mit Vollzählung und MONO-PERF-Countern

Seiteneffekte & automatische Beendigung

• Aktiviert ausschließlich beobachtende Sampler und begrenzte Ringpuffer.
• Erzeugt nach der Analyse atomar einen eigenständigen Offline-HTML-Bericht unter monolith/analytics/.

Wann verwenden?

• Das Problem wurde vor dem automatischen Ende vollständig reproduziert.

Syntax

/monolith analytics stop

Ausgabe verstehen

Finalizing

Nennt den Dateinamen des entstehenden Reports.

Seiteneffekte & automatische Beendigung

• Stoppt Sampler, stellt temporäre Messzustände wieder her und plant atomaren Report-I/O außerhalb des Tickthreads.

Wann verwenden?

• Während CAPTURING, FINALIZING, ANALYZING oder GENERATING_REPORT geprüft werden soll, ob die Aufnahme gesund und begrenzt bleibt.

Syntax

/monolith analytics status

Ausgabe verstehen

State

IDLE, INITIALIZING, CAPTURING, FINALIZING, ANALYZING, GENERATING_REPORT, COMPLETE, INCOMPLETE, CANCELLED, REPORT_GENERATION_FAILED oder FAILED.

Samples

Retained Tick Samples, CPU Samples und echte Spikeanzahl.

Latest report

Relativer lokaler HTML-Pfad ohne Offenlegung eines absoluten Dateipfads.

Seiteneffekte & automatische Beendigung

• Keine; liest nur den Analytics-Zustand.

Wann verwenden?

• Der Workload falsch war oder der Lauf nicht als Evidenz dienen darf.

Syntax

/monolith analytics cancel

Ausgabe verstehen

Cancelled

Bestätigt, dass keine Reportdatei geschrieben wurde.

Seiteneffekte & automatische Beendigung

• Verwirft nur die aktive Telemetrie; Welten, Spieler und Serverzustand bleiben unberührt.

Wann verwenden?

• Eine Report-ID für Export oder Vergleich benötigt wird.

Syntax

/monolith analytics history

Ausgabe verstehen

Reportübersicht

Neueste monolith-analytics-<ID>.html-Dateien samt verständlicher Kerndaten in absteigender Änderungsfolge.

Seiteneffekte & automatische Beendigung

• Keine; liest nur das lokale Analytics-Verzeichnis.

Wann verwenden?

• Ein HTML-Bericht lokal geöffnet, archiviert oder an Support übergeben werden soll.
• Automatisierung ausdrücklich das interne Rohmodell benötigt.

Syntax

/monolith analytics export MA-20260823-120000-1
/monolith analytics export MA-20260823-120000-1 raw

Argumente

Ausgabe verstehen

Verified offline HTML report

Relativer HTML-Pfad innerhalb monolith/analytics/.

raw

Optionaler verifizierter JSON-Sidecar; für normale Nutzung nicht erforderlich.

Seiteneffekte & automatische Beendigung

• Keine Kopie und kein Upload; validiert nur die vorhandene Datei.

Wann verwenden?

• Vor und nach einer Konfigurations-, Plugin- oder MONO-PERF-Änderung derselbe Workload aufgenommen wurde.

Syntax

/monolith analytics compare analytics-before analytics-after

Argumente

Ausgabe verstehen

Compatible

Nur true bei passendem Schema, Minecraft, Modus, vollständigen Reports, Umgebung und ähnlicher Dauer.

Warnings

Ein anderer Monolith-Build ist bei einem Patchvergleich erwartbar, bleibt aber sichtbar.

Deltas

Average, P50/P95/P99, Max, Headroom, CPU, Allocation, Heap und verfügbare Engine-Metriken.

Seiteneffekte & automatische Beendigung

• Keine; liest und verifiziert beide lokalen Reports.

Wann verwenden?

• Tiefe JVM-, Thread-, GC- oder Allokationsevidenz nach einer gezielten Diagnose noch fehlt.

Syntax

/monolith record
/monolith record 60s

Argumente

Ausgabe verstehen

State

ACTIVE oder INACTIVE.

Window

Start- und Endzeit des aktuellen oder letzten Fensters.

Latest package

Pfad zum letzten erzeugten Flight-Recorder-Paket.

Seiteneffekte & automatische Beendigung

• Aktiviert Java Flight Recorder und gleichzeitig das Pluginprofil.
• Schreibt ein Diagnosepaket.
• Stoppt automatisch nach 5 bis 300 Sekunden.

Wann verwenden?

• RAM wächst über längere Zeit.
• GC-Pausen oder Allocation sind auffällig.
• Eine mögliche Retention soll ohne voreilige Leak-Behauptung untersucht werden.

Syntax

/monolith memory

Ausgabe verstehen

State

NORMAL, ELEVATED, HIGH, CRITICAL oder RECOVERING nach dem konfigurierten Composite-Risiko und bestätigten Stichproben.

Classification / Reason

Dominierende Druckquelle und maschinenlesbarer Grundcode.

Composite risk

Höchstes korreliertes Risiko von 0,00 bis 1,00; Standardgrenzen: 0,42 / 0,68 / 0,88.

Used heap / Maximum heap / Heap pressure

Aktuelle Heapbelegung. Ein hoher Momentanwert allein beweist keine Retention.

Natural post-GC heap

Nach einer natürlichen GC verbliebener Heap. Fehlt als UNAVAILABLE, bis eine unterstützte GC-Benachrichtigung vorliegt.

Post-GC trend

Steigung in MiB pro Minute und RISING, STABLE oder FALLING.

Old-generation pressure

Belegung der alten Generation, sofern der Collector sie liefert.

Allocation

Temporär erzeugte Bytes pro Sekunde; hohe Werte können vollständig wieder freigegeben werden.

GC pressure

Collection-Ereignisse und Pausenzeit pro Minute.

Direct memory

Direkte Puffer außerhalb des Java-Heaps, sofern messbar.

Queues

Korrelierter Druck sowie Tiefe und bekannte Kapazität von Hintergrund- und Save-Warteschlange.

Bounded diagnostic caches

Einträge, Limit und Druck der begrenzten Diagnose-Caches.

Possible retained growth

Wird erst nach mindestens vier frischen Post-GC-Werten, drei Anstiegen und ausreichender Steigung wahr.

Estimated critical headroom

Zeit bis zur 93-Prozent-Projektion nur bei bestätigtem Retention-Trend; sonst UNKNOWN.

Why not higher

Erklärt, welche Evidenz für eine stärkere Einstufung fehlt.

Safe action

Nur Monolith-eigene Hintergrundkonkurrenz kann begrenzt werden; kein System.gc und kein automatischer Heap-Dump.

Statuswerte

• NORMAL unter ELEVATED-Schwelle
• ELEVATED ab konfiguriertem Score nach Bestätigung
• HIGH ab High-Score nach Bestätigung
• CRITICAL ab Critical-Score oder hartem 97/93-Prozent-Signal
• RECOVERING nach bestätigter Entlastung aus HIGH/CRITICAL

Seiteneffekte & automatische Beendigung

• Keine; liest nur den aktuellen Laufzeit-Snapshot.

Wann verwenden?

• PLUGIN_EVENTS oder PLUGIN_TASKS führt die Hotpath-Liste an.
• Ein Plugin-Callback oder Scheduler-Task wird als Spike-Ursache vermutet.

Syntax

/monolith plugins

Ausgabe verstehen

State / Window

Profilstatus und Messzeitfenster.

Plugin workload

Bis zu 15 Plugins mit Gesamtzeit, Aufrufen, Maximaldauer und Stalls.

Server allocation

Serverweite MiB/s samt Messqualität.

Handler allocation quality

Qualität der Callback-Allokationszuordnung.

Plugin / operation

Bis zu 15 Zuordnungen mit Gesamtallokation, KiB pro Aufruf und Klassifikation.

Plugin failure fingerprints

Anzahl erkannter Plugin-Fehlersignaturen.

Automatic plugin unload

Immer DISABLED; Monolith entlädt Plugins nicht automatisch.

Operation circuit breaker

Konfigurationszustand; eine Isolation benötigt einen nachgewiesenen sicheren Rand.

Seiteneffekte & automatische Beendigung

• Keine; liest nur den aktuellen Laufzeit-Snapshot.

Wann verwenden?

• Pluginlast ist wahrscheinlich, aber noch keinem Callback zugeordnet.
• Allokation pro Plugin-Operation soll gemessen werden.

Syntax

/monolith profile
/monolith profile start
/monolith profile start 60
/monolith profile stop

Argumente

Ausgabe verstehen

Start / stop

Bestätigt Messfenster oder manuelles Ende.

State / Window

ACTIVE oder INACTIVE und das letzte Messfenster.

Workloads

Gesamtzeit, Aufrufe, Maximaldauer und Stalls je Plugin.

Allocation

Serverrate und Plugin/Operation-Zuordnung samt Qualitätsangabe.

Seiteneffekte & automatische Beendigung

• Aktiviert Callback- und Allokationszuordnung für 5 bis 300 Sekunden.
• Gesammelte Daten bleiben nach stop lesbar.
• Schreibt keine Welt- oder Pluginzustände um.

Wann verwenden?

• Chunks speichern langsam.
• Save-Sturm, I/O-Rückstau oder Weltfehler wird vermutet.

Syntax

/monolith worlds

Ausgabe verstehen

Storage observation

Gesamtzustand der beobachteten Speicherpfade.

Save queue depth / Oldest operation

Rückstau und Alter des ältesten noch offenen Vorgangs.

Latency avg / P95

Mittlere und Tail-Latenz der Save-Operationen.

Failures / Paper retries observed

Beobachtete Fehler und autoritative Paper-Wiederholungen.

Tracking quality

Kennzeichnet die Güte der Erfassung.

Weltzeilen

Je Welt: Health, offene Vorgänge, Fehler und P95.

Causality warning

Warnt vor einer Kausalitätsbehauptung, wenn nur Korrelation vorliegt.

Seiteneffekte & automatische Beendigung

• Keine; liest nur den aktuellen Laufzeit-Snapshot.

Wann verwenden?

• Logins über Velocity oder Bungee schlagen fehl.
• Forwarding- oder Backend-Konfiguration soll vor Freigabe geprüft werden.

Syntax

/monolith proxy

Ausgabe verstehen

Mode

DIRECT, Velocity Modern oder Bungee Legacy in lesbarer Form.

Validation

READY oder ACTION REQUIRED.

Backend online-mode

Backend-Authentifizierungszustand.

Forwarding online-mode / secret

Velocity- oder Bungee-Einstellungen; Secrets erscheinen nur als CONFIGURED oder MISSING.

PROXY Protocol

ENABLED oder DISABLED.

ERROR / NOTICE

Konkrete erkannte Fehlkonfigurationen und Hinweise.

Seiteneffekte & automatische Beendigung

• Keine; liest nur den aktuellen Laufzeit-Snapshot.

Wann verwenden?

• Bossbars global aktiviert oder deaktiviert werden sollen.
• Palette, Schwellen, Auswahl und Viewer geprüft werden.

Syntax

/monolith bossbar
/monolith bossbar status
/monolith bossbar on
/monolith bossbar off
/monolith bossbar toggle

Argumente

Ausgabe verstehen

State / Refresh

Globalzustand und Aktualisierungsintervall.

Animated RGB gradient / palette / speed

Effektive Farbanimation.

Bars

Sichtbare TPS-, RAM- und CPU-Kombination.

Warning / critical

Konfigurierte Schwellen je Metrik.

Viewers

Anzahl aktueller Betrachter.

Seiteneffekte & automatische Beendigung

• on, off und toggle ändern nur den Laufzeitstatus.
• Die Änderung schreibt monolith.yml nicht um und geht bei Reload oder Neustart verloren.

Wann verwenden?

• Alle drei Bars gleichzeitig sichtbar oder unsichtbar werden sollen.

Syntax

/allbars
/allbars on
/allbars off
/allbars toggle
/allbars status

Argumente

Ausgabe verstehen

MONOLITH ALL BARS

ENABLED nur, wenn Globalzustand sowie alle drei Bars aktiv sind; sonst DISABLED.

Runtime only

Zeigt TPS, RAM und CPU jeweils als ON oder OFF.

Seiteneffekte & automatische Beendigung

• Ändert nur die aktuelle Runtime; keine YAML-Datei.

Wann verwenden?

• Die CPU-Bar unabhängig von den beiden anderen Bars geändert oder geprüft werden soll.

Syntax

/cpubar
/cpubar on
/cpubar off
/cpubar toggle
/cpubar status

Argumente

Ausgabe verstehen

MONOLITH CPU BAR

ENABLED oder DISABLED als Text.

Runtime only

Zeigt TPS, RAM und CPU jeweils als ON oder OFF.

Seiteneffekte & automatische Beendigung

• Ändert nur die aktuelle Runtime; keine YAML-Datei.

Wann verwenden?

• Die RAM-Bar unabhängig von den beiden anderen Bars geändert oder geprüft werden soll.

Syntax

/rambar
/rambar on
/rambar off
/rambar toggle
/rambar status

Argumente

Ausgabe verstehen

MONOLITH RAM BAR

ENABLED oder DISABLED als Text.

Runtime only

Zeigt TPS, RAM und CPU jeweils als ON oder OFF.

Seiteneffekte & automatische Beendigung

• Ändert nur die aktuelle Runtime; keine YAML-Datei.

Wann verwenden?

• Die TPS-Bar unabhängig von den beiden anderen Bars geändert oder geprüft werden soll.

Syntax

/tpsbar
/tpsbar on
/tpsbar off
/tpsbar toggle
/tpsbar status

Argumente

Ausgabe verstehen

MONOLITH TPS BAR

ENABLED oder DISABLED als Text.

Runtime only

Zeigt TPS, RAM und CPU jeweils als ON oder OFF.

Seiteneffekte & automatische Beendigung

• Ändert nur die aktuelle Runtime; keine YAML-Datei.

Wann verwenden?

• Nach `reload` geprüft werden soll, was wirklich aktiv ist.
• Adaptive Drosselung oder Trading-Hall-Verhalten erklärt werden muss.

Syntax

/monolith runtime

Ausgabe verstehen

Uptime / Adaptive state / Sample interval

Prozesslaufzeit und Telemetrie-/Drosselzustand.

Trading-hall brains

Enabled, Basis-, Effektiv- und Maximalintervall sowie Zähler für ausgeführte, übersprungene und angepasste Pässe.

Stall detection / Intelligent errors

Effektive Diagnose-Schalter.

Performance boss bars

Globalzustand, Auswahl und Viewer.

Boss bar RGB / thresholds

Animation, Palette, Geschwindigkeit, Refresh und Schwellen.

Paper behavior

In dieser Ausgabe compatible.

Seiteneffekte & automatische Beendigung

• Keine; liest nur den aktuellen Laufzeit-Snapshot.

Wann verwenden?

• Vor Supportanfragen, Vergleichen und Reproduktionsversuchen.

Syntax

/monolith version

Ausgabe verstehen

Minecraft / Monolith Build / Version

Versionsidentität des laufenden JARs.

Monolith Commit / Paper Upstream / Mapping / Patch State

Reproduzierbare Quell- und Patchidentität.

Java / GC

Laufzeit und Collector.

Maintainer

Im Build hinterlegte Maintainerangabe.

Seiteneffekte & automatische Beendigung

• Keine; liest nur den aktuellen Laufzeit-Snapshot.

Wann verwenden?

• Eine unterstützte Monolith-Konfiguration geändert wurde.

Syntax

/monolith reload

Ausgabe verstehen

File

Immer monolith.yml.

Boss bars / RGB gradient

Effektiv geladene Bar-Auswahl und Animation.

Trading halls

ACTIVE mit Brain-Intervall oder PAPER CADENCE.

Console

COMPACT oder EXPANDED.

Configuration applied

Bestätigt, dass kein Minecraft-/Plugin-Full-Reload stattfand.

Seiteneffekte & automatische Beendigung

• Übernimmt unterstützte Monolith-Einstellungen in die laufende Runtime.
• Setzt nicht persistierte Bossbar-Kurzbefehlsänderungen auf Dateiwert zurück.
• Berührt debug-chunks.yml nicht.

Wann verwenden?

• Die Schutz- und Erholungspfade eines isolierten Testservers unter künstlichem Ressourcendruck geprüft werden.

Syntax

/overload
/overload start
/overload start light 60
/overload start heavy 60
/overload start extreme 60
/overload status
/overload stop

Argumente

Ausgabe verstehen

LOCKED / IDLE / ACTIVE

Gate- und Laufzustand.

Profile / Progress

Intensität, Dauer, Fortschrittsbalken und Restzeit.

Tick pressure

LIGHT 5 ms, HEAVY 20 ms, EXTREME 35 ms pro gemessenem Tick.

CPU pressure

LIGHT ein Worker bei 40 Prozent; HEAVY halbe Prozessorzahl bei 70 Prozent; EXTREME Prozessorzahl minus eins bei 90 Prozent.

Heap pressure

Ziel und aktuell retained MiB; zusätzlich bleiben mindestens 30 Prozent oder 64 MiB Headroom.

Safety

Keine Welt-, Entity-, Netzwerk- oder Dateimutation durch die Overload-Engine.

Report / Last stop

Automatische Benchmarkaufzeichnung und Abschlussgrund.

Statuswerte

• LOCKED ohne -Dmonolith.testing=true
• IDLE freigeschaltet, aber inaktiv
• ACTIVE laufender Test
• STOPPED nach manuellem Ende

Seiteneffekte & automatische Beendigung

• Belastet absichtlich Main Thread, CPU, Heap und Garbage Collector.
• Allokationschurn stoppt ab 60 Prozent Heapbelegung.
• Stop, Ablauf und Shutdown beenden Worker und lösen retained Referenzen.
• Benchmark V2 schreibt Reportdateien.

Wann verwenden?

• Eine Welt ausschließlich im Wartungsmodus vorab vorbereitet werden soll.

Syntax

/debugchunks status
/debugchunks world <geladene-Welt>
/debugchunks center <Block-X> <Block-Z>
/debugchunks radius <Blöcke>
/debugchunks shape <square|circle>
/debugchunks start
/debugchunks pause
/debugchunks resume
/debugchunks stop
/debugchunks reload
/debugchunks reset

Argumente

Ausgabe verstehen

Mode

IDLE, RUNNING, PAUSED, THROTTLED, STOPPING, STOPPED, COMPLETED, FAILED oder LOCKED.

Safety gates

Immer PRE-START FLAG + WHITELIST; der Befehl ist ohne erfolgreiches Doppel-Gate gar nicht registriert.

World / Center / Area

Aktive Zielwelt, Mittelpunkt, Radius und Form.

Pipeline

Maximal offene Anfragen und Dispatches pro Tick.

Progress / Throughput / ETA

Bestätigte Chunks, Rate und berechnete Restzeit.

Requests

Aktive Anfragen, Wiederholungen und Fehler.

Checkpoint / Report / Reason

Fortsetzungspunkt, letzter Bericht und Zustandsgrund.

Statuswerte

• THROTTLED bei Spielern online oder MSPT oberhalb Pause-Schwelle
• PAUSED manuell; offene Requests laufen aus
• COMPLETED erst nach vollständiger Bestätigung
• LOCKED sobald Whitelist zur Laufzeit deaktiviert wird

Seiteneffekte & automatische Beendigung

• Erzeugt oder lädt echte Chunks in der gewählten Welt.
• Schreibt monolith-debug-chunks.yml, atomaren Checkpoint und Abschlussreport.
• reset löscht nur Fortschritt, niemals Weltdaten.
• world/center/radius/shape schreiben die Debug-Konfiguration und sind bei vorhandenem Checkpoint gesperrt.