Zum Hauptinhalt springen

Diagnose-Dateien pro Reaktor

Mit FlammiCraft ausgelieferte Mod-Version: 0.556.0

Betriebslogbuch · Startbedingungen prüfen · English

Ursache einer Abschaltung finden

  1. Lass die Kühlung laufen. Fahre am verbundenen Leitstand über AUTO-SCRAM. Notiere Auslöser, Ursache, Zeitpunkt und Position des Controllers. Im Reiter Log findest du den Ablauf und die Messwerte zur Abschaltung.
  2. Reicht der Hinweis nicht, aktiviere den Mitschnitt vor dem nächsten Versuch. Bei einem dedizierten Server liegen die Dateien im Spielverzeichnis des Servers.
  3. Ordne den Mitschnitt über die Controllerposition im Dateikopf zu. Behalte die Teile mit der Aktion und den Messwerten unmittelbar davor und danach.

Mitschnitt einschalten

Aktiviere die Aufzeichnung nur für den benötigten Zeitraum. Die Mod beginnt ab 32 MiB einen neuen Dateiteil und löscht alte Dateien nicht automatisch. Der Platzbedarf wächst mit der Zahl geladener Reaktoren und der Laufzeit. Stelle die Einstellung nach der Aufnahme wieder auf false. Bereits angenommene Zeilen werden noch geschrieben, und die Dateien bleiben erhalten.

Aktiviere den Mitschnitt in der wirksamen nucleus-server.toml der Welt.

[monitoring]
reactorDiagnostics = true

Der Standard ist false. Die vorhandene Datei bearbeiten, keinen zweiten [monitoring]-Abschnitt anlegen. Nach einer Änderung die Server-Config neu laden lassen oder beim nächsten manuellen Serverstart verwenden. Es ist keine neue Config-Datei nötig. Das Betriebslogbuch am Leitstand bleibt unabhängig davon aktiv.

Jeder geladene Controller erhält beim ersten Mitschnitt eine gespeicherte UUID. Unter logs/nucleus/ des laufenden Servers beziehungsweise Einzelspieler-Clients entstehen Dateien reactor-<uuid>_<utc-zeitstempel>_<teil>.log. Der Kopf nennt Welt, Dimension, Controllerposition, Modversion und die wirksamen Common-/Servereinstellungen. So lässt sich die UUID dem gebauten Reaktor zuordnen. Entladen und erneutes Laden, erneutes Einschalten, Config-Reload oder Neustart beginnen einen neuen Mitschnitt mit derselben ID. Ein neu platzierter Controller erhält eine neue ID; /reactorreset erhält die ID des zurückgesetzten Controllers.

Jede Zeile ist ein JSON-Datensatz: UTC-Uhrzeit und Welttick, angeforderte Stabprozente, tatsächliche Regel- und Abschaltbank, Leistung, Reaktivität mit Brennstoff-, Xenon-, Samarium-, Bor- und Temperaturanteilen, Brennstofftemperaturen, Nachwärme, gespeicherte Kühlkreismesswerte samt Mess-Tick, Versorgung, Schutzmasken, und Bedienaktionen samt Akteur. Einfache und realistische Kerndaten werden getrennt benannt. Der Betriebsmodus steht in jeder Zeile. Nicht endliche Zahlen stehen als null in der Datei. Das Logging lädt keine Chunks und initialisiert keine Simulation; die Kühlwerte stammen aus dem letzten regulären Simulationsabruf.

Vollständige Zustandsaufnahmen ab Schema 2

Die schnellen Messpunkte bleiben alle fünf Ticks erhalten. Zusätzlich enthält der erste Messpunkt, mindestens alle 20 Ticks und jede Bedienaktion eine vollständige checkpoint-Aufnahme. Bei 20 TPS sind das vier schnelle Messpunkte und mindestens eine vollständige Aufnahme pro Sekunde. Der geladene Aufbau wird spätestens nach 40 Ticks neu gelesen, außerdem nach einem regulären Reaktorscan. Sein eigener tick bleibt angegeben. Beim Entladen wird der Aufbau nicht erneut gelesen.

Feld Inhalt
controller_saved_snbt Vollständiger gespeicherter Controllerzustand einschließlich geerbter Behaviours, Aktionslog, Alarme, Reserven und flacher Modell-Speicherdaten. SNBT ist Minecrafts Textdarstellung von NBT; Datentypen und Zusatzdaten bleiben erhalten.
controller_save_complete Ob dieser Export vollständig gelang. Bei false steht die Ursache in controller_save_error; der vorhandene Text darf dann nur als Teilaufnahme gelten.
fluid_tanks Alle sieben Tanks, auch der sonst nicht gespeicherte interne steam-Tank: Fluid-Registry-ID, mB, Kapazität, Leerzustand und vollständiger Stack als SNBT samt Komponenten. Ein Codecfehler steht ausdrücklich als stack_serialization_error daneben.
core_layout Breite, Tiefe, Moderation, Leckage, Spitzenfaktor, Stababdeckung, Layout-Reaktivität und jede Spalte mit Leistungsfaktor und fehlender Stababdeckung. columnKind: 0 Kühlmittel, 1 Graphit, 2 Brennstoff, 3 Stab; Index x + z*width.
plant_model / simple_model Vollständige interne Simulationszustände: Regelziele und Istwerte, sechs verzögerte Neutronengruppen, Kinetik, Brennstoff-/Hüllrohrknoten, Iod/Xenon, Samarium/Promethium, Nachwärmegruppen, Bor, Rückkopplungen, Siedekrise, Schäden, Zufallszustand und Teilmodelle. Auch vorhandene, im aktuellen Betriebsmodus unbenutzte Modelle bleiben sichtbar.
physics_readout / physics_history Letzte berechnete Physikgrößen und Betriebshistorie; vorhandene Cachewerte sind keine zusätzliche Neuberechnung.
safety_agent ARGUS-Eingangsverläufe, Ausgaben, Schwellzustände, Wartezeiten und Lern-/Netzzustand.
physical_vessel / physical_containment / physical_power Physische Wasser-/Energie-/Gaszustände und Versorgungszustand samt abgeleiteten Cachewerten.
runtime Nicht vollständig gespeicherte Controllerwerte: Scanlisten, Stab-/Portpositionen, Wärme- und Dampfakkumulatoren, Übergänge, Boiler-Meldungen, Sperren, Scanbedarf und Alarm-Haltezeiten.
setup.reactor Geladener dreidimensionaler Blockaufbau, genaue Registry-IDs und Blockeigenschaften, Weltfluidzustände, Anzahl je Blocktyp sowie gespeicherte Daten eigener Block-Entities. Stab-/Nozzle-/Pumpendaten bleiben damit der Position zuordenbar.
setup.generator Verknüpfter geladener Dampferzeuger: vollständiger Speicher- und Kreiszustand, Fluidstacks, bekannte heiße/kalte Leitungsabschnitte, Pumpenrichtungen, Tanks, Puffer, Ports und deren geladene Block-/Gerätedaten.

Die Blockkarte verwendet eine Palette. cells enthält Palettenindizes in der Reihenfolge x + z*width + y*width*depth, jeweils relativ zu min. -1 bedeutet nicht geladen, niemals Luft. complete besagt nur, dass die angefragten Blockzellen gelesen werden konnten; es bestätigt keinen gültigen Reaktor. own_block_entity_data_complete, die Statusfelder der einzelnen Geräte sowie assembled und der eigentliche Strukturfehler sind gesondert zu beachten. Unbekannte oder übergroße Grenzen werden nicht ausgedehnt. Fremde Block-Entities werden mit ihrem Typ benannt, ihre privaten Inventare werden nicht serialisiert. Die Leitungsdaten des Generators sind dessen zuletzt erkannte Abschnitte; das Log behauptet keinen neuen Scan aller entfernten Rohrblöcke. Fehlende Generator-Chunks werden als unloaded protokolliert.

Im Dateikopf stehen zusätzlich die geladenen Modversionen und Hashes der Controller-, Generator- und Logger-Klassenressourcen. Diese kennzeichnen die ausgelieferte Codebasis, nicht nachträgliche Änderungen durch andere Mixins. capture_sequence ordnet Datensätze innerhalb einer Aufnahme. Ein neuer Dateiteil enthält bei Bedarf checkpoint_context.source, also die letzte vollständige Aufnahme mit ihrem ursprünglichen Tick. Dieser Kontext ist kein neuer Messpunkt.

Fluidtypen richtig lesen

Der Brennstofftank vereinheitlicht angenommene Brennstofflösungen intern auf einen Fluidtyp. Die tatsächliche mittlere Anreicherung und der MOX-Anteil stehen separat im Controllerzustand; die Fluid-ID allein beschreibt die Mischung nicht. Ein ausgeführtes fuel_input-Ereignis enthält deshalb den ursprünglichen Fluidstack, Anreicherung, MOX-Kennung und tatsächlich angenommene mB vor dieser Vereinheitlichung. Eine reine Transportsimulation wird nicht als erfolgte Befüllung protokolliert. Das im Kern dargestellte Weltwasser ist ebenfalls kein Nachweis, dass der Primärkreis normales Wasser enthält: dafür Tankstacks und Generatorzustand prüfen.

Auswertung: Anleitung oder Code

Zuerst Codebasis, Betriebsmodus und wirksame Einstellungen vergleichen. Danach Aufbau, Moderator-/Brennstoffpositionen, Stababdeckung, Fluidmischung, Versorgung und Kühlkreis gegen die Bau-/Betriebsanleitung prüfen. Ein unbekannter Chunk oder eine alte Cacheaufnahme darf nicht als fehlender Block oder aktueller Messwert gewertet werden. Dokumentationslücken anhand des bestätigten Aufbaus ergänzen.

Für Leistungssprünge die Folge vor und nach der Aktion vergleichen: angeforderte Stellung, Modellziel, tatsächliche Stäbe, Reaktivitätsanteile, Kinetik, Temperatur, Gifte und Schutzreaktion. Reale UTC-Zeit, Weltticks und komprimierte Modellzeit getrennt auswerten. Erst mit diesen Belegen entscheiden, ob Bedienhinweise fehlen oder ein reproduzierbarer Codefehler beziehungsweise eine Optimierung vorliegt.

Alle fünf Server-Ticks wird ein Messpunkt aufgenommen, bei 20 TPS vier pro Sekunde. Aktionen und zufällige Controller-Zwischenfälle kommen zusätzlich dazu. Für den Fall 60 auf 59 Prozent: vor dem Anfahren einschalten, den stabilen Betrieb und die spätere Änderung vollständig erfassen und anschließend die zugehörigen Teile sichern. Der Logger führt die Stabänderung nicht selbst aus. Die Ursache eines Leistungsanstiegs ist erst anhand dieser Daten zu beurteilen.

Die Ausgabe läuft über einen eigenen Schreibthread mit begrenzter Warteschlange. Bei Überlast nennt latest.log die Lücke; die nächste geschriebene Zeile meldet queue_overflow und die Zahl ausgelassener Datensätze. Schreibfehler stoppen den betroffenen Mitschnitt mit einer Fehlermeldung, ohne den Reaktor anzuhalten. Nach Beheben der Ursache aus- und wieder einschalten. Bei normalem Serverende wird die Warteschlange bis zu fünf Sekunden geleert; Zeitüberschreitung oder Abbruch werden gemeldet. Ein Prozessabbruch kann den letzten Teil unvollständig lassen.

Die Aufzeichnung ändert weder Physikparameter noch Brennstoff- oder Kühlmittelbestände. Die neue UUID bleibt beim Speichern erhalten.

Vollständige Aufnahmen sind wesentlich größer als einzelne Messwerte und werden für einen konsistenten Zustand im Server-Thread kopiert; nur die Dateiausgabe läuft im Hintergrund. Die Schreibwarteschlange ist zusätzlich auf 64 MiB an Textdaten begrenzt. Überlast oder ein zu großer einzelner Datensatz wird als Lücke gemeldet. Ein Dateiteil kann durch eine einzelne vollständige Aufnahme oder ihren Kontext größer als die Teilungsgrenze werden; Aufnahmen werden nicht abgeschnitten.

Dateiausgabe, Fehlerpfade und Zustandserhalt sind offline geprüft. Eine Aufnahme mit einer echten laufenden Anlage und die Ursache des gemeldeten Leistungsanstiegs bleiben ohne entsprechende Spiel-/Serveraufnahme offen.