# UNMA – Universelle Nachrichten-Meldeanlage

**Benutzeranleitung:** [Deutsch](USER_GUIDE_DE.md) ·
[English](USER_GUIDE_EN.md)

UNMA ergänzt Captain of Industry um eine frei konfigurierbare industrielle
Schlitzmelder-Tafel. Das Vorbild ist die klassische Meldeanlage: im Ruhezustand
hellgrau mit schwarzer Schrift, beim Kommen blinkend in Aktivfarbe und nach
`MASTER QUIT` dauerhaft stehend und stumm. Geht eine noch ungequittierte
Meldung, bleibt sie als `GEGANGEN · UNQUITTIERT` gespeichert; nur der Bediener
oder eine ausdrücklich gewählte automatische Quittierung setzt sie zurück.

Zielversion: Captain of Industry **0.8.6c**.

## Funktionen

- Spiegelung aller aktiven Vanilla-Benachrichtigungen über den
  `INotificationsManager`.
- Jeder bekannte Vanilla-Meldungstyp kann im **TÖNE**-Tab global, für genau ein
  Objekt oder für alle Objekte desselben Prototyps auf `NORMAL`,
  `LOGGEN · TON AUS`
  oder `LOGGEN · TON AUS · AUSBLENDEN` gestellt oder mit
  `NICHT LOGGEN · KOMPLETT IGNORIEREN` vollständig verworfen werden.
  Objektregeln haben Vorrang vor Prototyp- und Meldungstypregeln. Ausgeblendete Ereignisse
  fehlen in HOME und den aktiven Zählern, bleiben aber im Verlauf; vollständig
  ignorierte Ereignisse werden gar nicht erst angelegt. Die Benachrichtigung
  des Spiels selbst wird nicht verändert.
- Unter **OPTIONEN** lässt sich ein spielstandsübergreifendes Standardprofil
  mit einzeln auswählbaren Kategorien speichern und mit Vorschau atomar in
  eine andere Welt einspielen. Meldungsart- und Prototypregeln sind portabel;
  weltgebundene Entity-Regeln werden nachvollziehbar übersprungen. Verlauf,
  aktive Alarmzustände und zeitliche Memories gelangen nie in das Profil.
  Nur wenn die Profildatei tatsächlich fehlt, legt UNMA das eingebaute Profil
  **UNMA Recommended Quiet** an. Ein exakt erkanntes früheres Built-in wird nur
  im Speicher erweitert; Profildateien werden dabei nicht überschrieben.
- Das Home-Dashboard zeigt ausschließlich aktuell anstehende Meldungen (`K` und
  `KQ`) aus allen Quellen. Normale, gegangene und leere Plätze werden dort
  vollständig ausgeblendet.
- Benutzerdefinierte Betriebsbereiche gruppieren globale Panels, ohne deren
  Alarm-, Verlaufs- oder Audiologik zu verändern. **ALLE**, **NICHT
  ZUGEORDNET** und jeder konkrete Bereich filtern Panelleiste und HOME; das
  gefilterte HOME führt aktive Meldungen seiner Mitgliedspanels zu genau einem
  Schlitz je Alarm zusammen.
- **BEREICH QUITT.** und **BEREICH WEITER** gelten für den aktuellen Bereich;
  **ALLES QUITTIEREN** bleibt global. Quittiert wird immer der gemeinsame
  Alarmzustand: Ist derselbe Alarm in mehreren Bereichen sichtbar, erscheint
  die Quittierung deshalb überall und erzeugt keinen zweiten Verlauf.
- Die ausschließlich auf HOME sichtbare **INCIDENT-LINSE** gruppiert aktive
  Meldungen als zeitliche Heuristik: Liegen aufeinanderfolgende Kommen-Zeitpunkte
  höchstens zwei Spieltage auseinander, gehören sie zu einem Cluster.
  **ERSTES SIGNAL** ist nur dessen früheste Meldung und keine bestätigte
  Ursache oder Ursachenanalyse.
- Incident-Cluster respektieren **ALLE**, **NICHT ZUGEORDNET** und konkrete
  Betriebsbereiche. Der davon unabhängige globale Druck zählt Vorkommen der
  letzten zehn Spieltage mit den Gewichten Hinweis 1, Warnung 2, Kritisch 4
  und Notfall 8. Unter 8 ist er **NORMAL**, ab 8 **ERHÖHT**, ab 16 **STURM**
  und ab 32 **SCHWER**; zusätzlich erscheinen Vorkommen und verschiedene
  Alarmkennungen.
- Die erweiterte Linse zeigt höchstens sechs Incident-Karten und acht
  Mitglieder pro Karte; weitere bleiben gezählt. **FOKUS** navigiert nur zu
  einer noch sichtbaren Meldung beziehungsweise ihrem Objekt. Dabei wird
  nichts quittiert, versteckt oder gelöscht; Ton und Verlauf bleiben
  unverändert.
- Dauerhaft feste Meldeschlitze je Fachpanel: Eine stabile Alarm-ID behält ihren
  Platz auch zwischen `NORMAL`, `KOMMT`, `STEHT` und `GEGANGEN`. Wiederholte
  Vanilla-Ereignisse derselben Meldungsart und Entität erscheinen genau einmal;
  einzelne K/G/Q-Ereignisse bleiben im Verlauf vollständig erhalten.
- `HomelessLeft` bleibt bei negativem Bevölkerungs-`+/-` auch über den
  Monatswechsel hinweg dieselbe stehende Meldung. Wechselnde Personenzahlen
  aktualisieren nur den Text; erst ein Wert von `0` oder größer setzt sie auf
  gegangen und erlaubt danach ein wirklich neues Ereignis.
- Drei automatische Kernüberwachungen:
  - Gesundheit: `10` ist neutral; Krankheit und Pollution/Müll werden getrennt
    ausgewertet und mit der prozentualen Arbeitsreserve verknüpft;
  - Nahrung: 12 Monate, 3 Monate, Hunger/Todesfälle;
  - Arbeiter: prozentuale freie beziehungsweise fehlende Arbeitsreserve.
- Die mitgelieferten Systemmeldungen sind im **SYSTEM**-Tab vollständig und
  dauerhaft editierbar: Aktivierung, Text, Messwerte, Operatoren, Schwellen,
  Alarmstufe, Farbe und Ton.
- Die Werkvorgaben verwenden **NOTFALL** nur für eine aktive Hunger- oder
  Gesundheitstodesspirale. Dabei nutzt UNMA die vom Spiel bereits gerundete und
  mit positiven Geburten-/Ediktbeiträgen verrechnete Nettoentwicklung. Ein
  reiner Arbeitermangel eskaliert höchstens auf
  kritisch.
- Klingel für Warnungen, Industriehorn für kritische Zustände und eine E57-nahe
  Motorsirene für Notfälle. Ihr kräftigerer Lauf steigt zwei Sekunden an und
  fällt zwei Sekunden ab. Das tiefe Industriehorn tönt 3,2 Sekunden und macht
  anschließend 1,2 Sekunden Pause.
- Zusätzliche synthetische Sinus-, Rechteck-, Sägezahn-, Dreieck- und
  Impulssignale. Alle eingebauten Signale entstehen mathematisch zur Laufzeit.
- Eigene `.wav`- und `.ogg`-Dateien aus dem Ordner `Sounds`.
- Eigene Tonzuordnung und frei wählbare automatische Quittierung je bekannter
  Vanilla- und Systemmeldung; eigene Regeln wählen Ton, Alarmstufe,
  Aktivfarbe und Quittierverhalten direkt im Editor.
- Goldene UNMA-Alarmglocke direkt im Inspector jeder unterstützten Entität;
  ein Klick öffnet die eigene, dauerhaft gespeicherte Gebäudetafel.
- `+ NEUE MELDUNG` im jeweiligen Fach- oder Gebäudepanel öffnet den getrennten
  Meldungseditor. Gebäudemeldungen können dort über
  **ZU GLOBALEM PANEL HINZUFÜGEN** in globale Fachtafeln gespiegelt werden,
  ohne einen zweiten Alarmzustand zu erzeugen. HOME bleibt eine reine aktive
  Übersicht und nimmt keine festen Zuordnungen auf.
- Ein Pfeil unten rechts in objektbezogenen Schlitzen zentriert die Kamera auf
  das zugehörige Gebäude/Fahrzeug und öffnet dessen Inspector.
- AWL-artige Bedingungstabelle mit sichtbarem Ist-Wert, verständlicher Kennung,
  allen sechs Vergleichszeichen, Soll-Wert und UND-/ODER-Verknüpfung.
- Spielzeitbasierte Auslöse- und Rücksetzverzögerung sowie Mindestaktivzeit je
  eigener Regel und Systemalarmstufe. Eine Hysterese je numerischer Bedingung
  hält Grenzwerte stabil; laufende Timer und Latches überleben Save/Load.
- Eigene Regeln können nach frei wählbarer aktiver Spielzeit einmalig auf eine
  höhere Stufe und einen anderen Ton eskalieren. Optional öffnet UNMA dann das
  passende Panel und beendet ausschließlich die vorübergehende
  Fünf-Minuten-Stummschaltung. Systemstufen bieten dieselben sicheren
  Operatoraktionen beim Wechsel eines bereits aktiven Alarms.
- Absolute Schwellen und `% VON` einem wählbaren Bezugs-Messwert. Kapazitäten
  werden für Lager, Förderer/Rohre und Fahrzeugfracht automatisch empfohlen.
- Bedingungen können statt eines Spielobjekts auch **GLOBALE VARIABLEN** wie
  Bevölkerung, Arbeitsreserve, Nahrungsvorrat oder Gesundheitswerte verwenden.
- Beim Schließen bietet der Meldungseditor Speichern, Minimieren oder Verwerfen
  an; bestehende eigene Meldungen lassen sich direkt im Editor löschen.
- Automatische Erkennung öffentlicher numerischer und boolescher Messwerte von
  Gebäuden, Lagern, Fahrzeugen, Rohren und Förderbändern.
- Offene Erweiterungsschnittstelle für andere Mods: aktive Provider können
  automatische Alarmvorlagen in `UNMA/*.json` mitliefern, eigene Messwert-
  Reader über die versionierte C#-API registrieren oder Alarmzustände direkt
  veröffentlichen. `aggregate` erzeugt einen festen Sammelschlitz,
  `per_entity` auf Wunsch je Instanz einen stabilen Schlitz.
- MultiLangLib-Grundanbindung für die UNMA-Fensterhülle und alle Providertexte. In Definitionen
  bleiben stabile Übersetzungsschlüssel gespeichert; ein verpflichtender
  Fallback verhindert sichtbare Schlüssel bei fehlenden Sprachdateien.
- Hauptfenster, Meldungseditor und abgekoppelte Tafeln nutzen CoIs öffentliche
  native UI-Bibliothek für Metallrahmen, Titelleiste, Verschieben, Pinning,
  Schließen und Größenänderung per Ziehgriff. Das Hauptfenster ergänzt native
  Tabs und **MINIMIEREN**. Die umfangreichen UNMA-Instrumente bleiben bei einer
  inkompatiblen Spielversion über einen automatischen Fallback erreichbar.
- Typisierte Produktmengen für Lager, Förderbänder/Rohre sowie Frachten von
  Trucks, Baggern, Tree Plantern, Tree Harvestern und Güterwaggons.
- Mehrere Bedingungen pro Sammelmeldung mit UND- oder ODER-Verknüpfung.
- Eigene Meldungen lassen sich nach dem Speichern erneut in den Editor laden
  und vollständig ändern.
- Ein Doppelklick auf einen eigenen Meldeschlitz öffnet dessen Regel direkt im
  Editor; ungespeicherte andere Entwürfe werden dabei nicht überschrieben.
- Mehrprodukt-Gebäude wie Lebensmittelmärkte bieten jeden zugewiesenen Artikel
  als verständlichen Messwert an, beispielsweise `Kartoffeln · Bestand`.
  Bedingungen können absolut (`< 400`) oder automatisch relativ zur summierten
  Produktkapazität (`< 50 %`) definiert werden.
- Frei wählbare Meldetexte, Alarmstufen, Aktivfarben und Töne.
- `Z` pausiert den Ton eines Meldeschlitzes für einen Spielmonat, `R` setzt ihn
  fort. Die Funktion arbeitet auch für zusammengefasste Objektmeldungen und
  verändert weder Quittierung noch Sichtbarkeit, Zähler oder Verlauf.
- Beliebig viele Panels mit klar getrennter Auswahl, Bearbeitung und Neuanlage,
  Spaltenzahl, festen hoch/runter sortierbaren Schlitzen, gezieltem Hinzufügen
  bekannter Meldungen sowie Vanilla-/System-Automatik und kommagetrennten
  Suchfiltern. Neu entdeckte passende Meldungsarten werden einmalig hinten
  angehängt und verschieben vorhandene Plätze nicht.
- Globale Panels lassen sich als unabhängige Vorlage duplizieren. Reihenfolge,
  Filter und eigene Regeln werden tief kopiert; kopierte Regeln erhalten neue
  Kennungen und starten deaktiviert, während Livezustand und Verlauf unberührt
  bleiben. Das Duplikat übernimmt den Bereich seines Quellpanels.
- Im Bereichseditor lassen sich bis zu 64 Bereiche als gemeinsamer Entwurf
  anlegen, umbenennen, umsortieren und löschen. Erst Speichern wendet den
  gesamten Entwurf atomar an; beim Löschen werden die betroffenen Panels nur
  **NICHT ZUGEORDNET**. Die Panel-Einstellungen weisen ein Panel direkt zu.
  Ein neues Panel übernimmt einen konkret ausgewählten Bereich, beginnt unter
  **ALLE** oder **NICHT ZUGEORDNET** jedoch unzugeordnet.
- Persistente UI-Skalierung von 75 bis 200 Prozent für 1080p- und 4K-Monitore.
  Klicks, Drags und Mausradbewegungen werden nur innerhalb der sichtbaren
  UNMA-Rahmen abgefangen. Außerhalb bleiben Gebäudeauswahl, Kartenbewegung und
  Zoom auch bei geöffnetem UNMA-Fenster verfügbar. Schmale beziehungsweise
  auf 200 Prozent skalierte Fenster vergrößern ihre Mindestarbeitsfläche im
  verfügbaren Viewport; Panel- und Bereichseinstellungen stapeln zusätzlich
  ihre Bedienelemente. Ungespeicherte Entwürfe werden vor Schließen oder
  Wechseln ausdrücklich geschützt.
- Mehrere gleichzeitig abgekoppelte, verschiebbare In-Game-Tafeln.
- Der persistente **VERLAUF** führt jedes Alarmereignis mit `K` (gekommen),
  `KQ` (gekommen und quittiert), `KG` (gekommen und gegangen) oder `KGQ`
  (gekommen, gegangen und quittiert). `K` blinkt rot, `KG` blinkt mit
  schwarzer Schrift auf weißem Hintergrund; `KQ` und `KGQ` stehen schwarz auf
  weiß. Suche, Zustands- und Stufenfilter grenzen den Verlauf ein; neue
  Ereignisse führen Spielzeitmarken für Kommen, Gehen und Quittieren. Die
  gefilterte Ansicht lässt sich als RFC-4180-CSV oder JSON exportieren. Nur
  abgeschlossene `KGQ`-Einträge lassen sich ausdrücklich löschen.
- Spielstandsbezogene Persistenz in `unma-world-<GameId>.json`; Entity-Regeln
  werden zusätzlich gegen Typ, Prototyp und gegebenenfalls Produkt geprüft.
  Auch `STEHT`-Quittierungen und `GEGANGEN · UNQUITTIERT` überleben Speichern
  und Neuladen. Schema 20 übernimmt ältere Konfigurationen mit unzugeordneten
  Panels und unverändertem **ALLE**-Verhalten. Die Incident-Linse bleibt ein
  vorübergehender, aus aktuellen Alarm- und Verlaufssnapshots abgeleiteter
  Zustand und benötigt in 0.10.1 weder neue Speicherfelder noch eine weitere
  Schema-Migration. Eine erkannte Konfiguration aus einem neueren Schema bleibt
  bytegenau unangetastet; UNMA arbeitet dann mit sicheren Vorgaben und sperrt
  Schreibvorgänge für die Sitzung. Ein revisionsgebundener
  Verlaufscache wird nur bei Änderungen neu aufgebaut und begrenzt den
  globalen Druck auf die neuesten 8.192 Vorkommen; Sortierung und Analyse
  laufen außerhalb des Alarm-Locks. Wechselt die Revision fortlaufend, liefert
  UNMA nach höchstens zwei Versuchen einen konsistenten lokalen Snapshot, statt
  den Renderpfad zu blockieren.
- Beim endgültigen Abriss beziehungsweise Zerstören einer überwachten Entity
  löscht UNMA deren eigene Regel samt festem Schlitz und aktivem Zustand
  automatisch. Bei einer Sammelmeldung wird die ganze UND-/ODER-Regel entfernt,
  damit ihre Logik nicht still verändert wird. Historische KG/KGQ-Einträge
  bleiben im Verlauf; temporär despawnte Fahrzeuge werden nicht gelöscht.
  Beschädigte Konfigurationen werden gesichert und durch sichere Standardwerte
  ersetzt.

## Bedienung

1. Mod im Spiel aktivieren und einen Spielstand laden.
2. UNMA mit `F8` oder dem kompakten Launcher am linken Rand öffnen.
   Die Schaltfläche erscheint nur bei geschlossener Zentrale und lässt sich am
   `↕`-Griff aus anderen HUD-Bereichen herausziehen; ihre Position wird
   gespeichert.
3. In **MELDETAFEL** zeigt **HOME** alle aktiven Meldungen. Über **ALLE**,
   **NICHT ZUGEORDNET** oder einen Betriebsbereich Panelleiste und HOME
   eingrenzen. Die **INCIDENT-LINSE** bei Bedarf erweitern, um die zeitlichen
   Cluster dieses Bereichs zu prüfen; für die dauerhaft definierte
   Schlitztafel ein Fachpanel wählen.
4. Mit `Q` nur einen Schlitz, mit `PANEL QUITTIEREN` die sichtbare Tafel oder
   mit **BEREICH QUITT.** den ausgewählten Bereich oder mit `ALLES QUITTIEREN`
   sämtliche kommenden und gegangenen Meldungen quittieren. **BEREICH
   WEITER**, `NÄCHSTER ALARM` beziehungsweise standardmäßig
   `Umschalt links + F8` springt zyklisch durch unquittierte Meldungen.
   Bei einer weiterhin anstehenden Meldung bleibt die Aktivfarbe sichtbar,
   bis die Ursache verschwindet.
5. In **VERLAUF** zeigt eine eigene Zeile je Alarmereignis den Zustand `K`,
   `KQ`, `KG` oder `KGQ`. Vollständig abgeschlossene `KGQ`-Zeilen bleiben
   gespeichert, bis sie dort ausdrücklich gelöscht werden.
6. Für eine eigene Gebäudemeldung die Entität anklicken und im geöffneten
   Inspector die goldene UNMA-Glocke drücken. UNMA öffnet die dauerhaft zu
   dieser Entity-ID gehörende Gebäudetafel.
7. In dieser Tafel `+ NEUE MELDUNG` drücken. Im getrennten Meldungseditor kann
   die Regel zusätzlich mit einem oder mehreren globalen Fachpanels verknüpft
   werden. Ein Doppelklick auf den späteren Schlitz öffnet dieselbe Regel erneut.
8. Im Meldungseditor Kennung und eines der sechs
   Steuerzeichen wählen, Soll-Wert eingeben und die AWL-Zeile hinzufügen. Für
   relative Bedingungen `% VON` und anschließend den Bezugs-Messwert wählen.
   Für eine Sammelmeldung danach außerhalb des Fensters die nächste Entität
   anklicken, **AKTUELLE SPIEL-AUSWAHL ÜBERNEHMEN** drücken und die nächste
   Zeile hinzufügen; anschließend global UND oder ODER festlegen und speichern.
9. Unter **TÖNE** können Ton und Verhalten beim Gehen für jede bereits
   bekannte Vanilla-Meldung separat festgelegt werden. Objektbezogene
   Vanilla-Meldungen lassen sich dort nur für die konkrete Instanz oder für
   alle Objekte desselben Prototyps lautlos, aus HOME ausgeblendet oder
   vollständig ohne Verlaufseintrag ignoriert werden.
10. Unter **SYSTEM** können Gesundheit, Nahrung und Arbeiter einschließlich
   ihrer Warn-, Kritisch- und Todesspiralenbedingungen jederzeit angepasst
   oder auf die Werkvorgabe zurückgesetzt werden.
11. Unter **OPTIONEN** lässt sich die gesamte UNMA-Oberfläche von 75 bis
    200 Prozent skalieren. `+ PANEL` legt eine globale Tafel an; das Zahnrad
    daneben öffnet deren getrennte Einstellungen samt Bereichszuordnung. Über
    **⚙ BEREICHE** werden Betriebsbereiche gemeinsam verwaltet.
12. Ebenfalls unter **OPTIONEN** ein Standardprofil aus den gewünschten
    Kategorien speichern oder, solange noch kein eigenes Profil vorhanden ist,
    **UNMA Recommended Quiet** verwenden. In einem anderen
    Spielstand zuerst die Importvorschau prüfen und danach zusammenführen. Ein
    Profil wird nie automatisch importiert; der Vorgang übernimmt nur die
    ausgewählten Einstellungen und verändert keine CoI-Meldung.

### Spielstandsübergreifendes Standardprofil

Das Profil kann Meldungsregeln einschließlich Tonzuordnung und automatischer
Quittierung, Systemalarm-Konfiguration, Alarmfarben/UI-Skalierung und optional
Fensterpositionen enthalten. Vor dem Import zeigt UNMA neue, geänderte,
unveränderte und übersprungene Werte. Erst die Bestätigung führt die gewählten
Kategorien atomar mit der Zielwelt zusammen; nicht ausgewählte und nur in der
Zielwelt vorhandene Werte bleiben bestehen.

Vanilla-Regeln werden anhand der stabilen Meldungsart (`NotificationType`) und,
falls vorhanden, des Entity-Prototyps übertragen. Regeln für eine konkrete
Entity-ID sind nicht zwischen Welten portabel und werden mit Ergebnisangabe
übersprungen. Verlauf, aktive Alarmzustände, Quittierungen, laufende Timer und
sonstige Laufzeit-Memories sind grundsätzlich ausgeschlossen. Eine importierte
Ignore-Regel unterdrückt deshalb nur die UNMA-Verarbeitung; die ursprüngliche
Captain-of-Industry-Meldung bleibt sichtbar und unverändert. Das atomar
geschriebene Profil liegt in
`%LOCALAPPDATA%\UNMA\profiles\default.json` und ist von den weltbezogenen
`unma-world-<GameId>.json`-Dateien getrennt.

Nur wenn `default.json` tatsächlich fehlt, erzeugt und persistiert UNMA das
eingebaute Profil **UNMA Recommended Quiet**. Exakt erkannte, unveränderte
frühere Built-ins – **UNMA Recommended Silent** mit sechs Silent-Regeln sowie
der Quiet-Zwischenstand mit zwei zusätzlichen Hidden-Regeln – werden beim Laden
nur im Speicher auf das aktuelle Quiet-Profil gebracht; ihre Dateien bleiben
unverändert. Abweichende und benutzerdefinierte Profile werden weder ergänzt
noch überschrieben. Das empfohlene Profil setzt die globalen Meldungsarten
`UpgradeInProgress`,
`DowngradeInProgress`, `VehicleGoalStruggling`,
`VehicleNoReachableDesignations`, `NoTreesToHarvest` und
`ExcavatorHasNoValidTruck` auf `SILENT`. Damit wird nur der UNMA-Ton
abgeschaltet; die Captain-of-Industry-Meldung sowie ihre Anzeige in UNMA HOME
und im Verlauf bleiben erhalten.

`TruckCannotDeliver` und `TruckCannotDeliverMixedCargo` stehen im selben
Profil auf `IGNORED`: UNMA verwirft neue Ereignisse dieser Arten noch vor
`SetAlarm`, Verlaufserzeugung und Persistenz. CoI vergibt beim Zurücknehmen und
erneuten Senden eine flüchtige `NotificationId`; ohne vollständiges Ignorieren
würden dadurch fortlaufend neue Zustände entstehen und Incident-Linse,
Verlauf sowie Spielstand-Persistenz belasten. Beim bestätigten Import und beim
Normalisieren der Konfiguration bereinigt UNMA passende aktive Zustände und
Memories. Ältere globale Verlaufseinträge werden ebenfalls entfernt, sofern
keine spezifischere, nicht ignorierende Entity- oder Prototypregel erhalten
bleiben muss. Die ursprüngliche Captain-of-Industry-Meldung bleibt sichtbar
und unverändert. `CannotDeliverFromMineTower`, `VehicleGoalUnreachable` und
`VehicleNoFuel` gehören bewusst nicht zur Empfehlung und bleiben normal sowie
hörbar. Auch dieses Profil wird erst nach Importvorschau und ausdrücklicher
Bestätigung mit einer Welt zusammengeführt.

Die Gesundheitsanzeige des Spiels ist keine klassische 0–100-%-Skala:
`10` ist der neutrale Basiswert und erst unter `0` entsteht ein
gesundheitsbedingter Bevölkerungsverlust. UNMA verwendet deshalb den
abgeschlossenen Monatswert. Eine zeitlich begrenzte Krankheit mit großer
Arbeitsreserve bleibt niedriger priorisiert; dauerhafte Pollution/Müll unter
der Verlustgrenze oder eine Krankheit, deren erwarteter Nettoverlust die freie
Arbeitsreserve kurzfristig aufbraucht, gilt als Todesspirale.

Ein Lager kann beispielsweise über `Lagerinhalt = 0` überwacht und mit der
produktbezogenen Menge auf einem Förderband über UND verknüpft werden. Bei
Transporten stehen Gesamtmenge, theoretischer Inhaltsraum, Füllstand und die
aktuell vorkommenden Produkte zur Wahl. Gespeicherte Produktbedingungen lesen
auch nach dem Leerlaufen weiterhin korrekt `0`.

Für `Lagerinhalt % VON Lagerkapazität < 5` berechnet UNMA beispielsweise den
vergleichbaren Wert als `Istwert / Bezugswert × 100`. Ein fehlender, null oder
negativer Bezugswert erfüllt die Bedingung bewusst nicht und wird als nicht
berechenbar angezeigt; Werte über 100 % werden nicht künstlich begrenzt.

## Messpult im Kraftwerksstil der 1970er

Die Registerkarte **MESSPULT** zeigt frei zusammengestellte Live-Messwerte
unabhängig von den Alarmregeln. Öffne zuerst den Inspector eines Gebäudes,
übernimm es als Quelle und wähle anschließend Messwert, Skalenbereich und
Instrumenttyp. Mehrere Kohlelager lassen sich entweder als eigene Instrumente
dicht nebeneinander anordnen oder als berechnete Summe, Mittelwert, Minimum
beziehungsweise Maximum in einem gemeinsamen Instrument überwachen.

Mit **+ PANEL** lassen sich mehrere benannte Messpulte anlegen. Die
Instrumenttyp-Auswahl öffnet eine scrollbare Galerie mit Live-Vorschau.
Schreiber und CRTs führen eine kontinuierlich verbundene Kurve.

Zur Verfügung stehen vertikale und horizontale Profilanzeigen,
Rundinstrumente, rote und grüne Siebensegmentanzeigen, Nixie-Röhren,
bernsteinfarbene und grüne CRT-Anzeigen sowie ein Papierschreiber. **HIST**
öffnet bei jedem Instrument eine große Historienansicht mit Spielzeitfenstern
von einem Tag bis zur gesamten Sitzung. Neben aktuellem Wert, Minimum,
Mittelwert und Maximum zeigt sie die lineare Rate pro Spielmonat, R² und bei
belastbarem Trend die ETA zur oberen oder unteren Skalenbegrenzung;
**MELD.** öffnet direkte und berechnete Messwerte als Quelle
**VERKNÜPFTE WERTE: Schildname**. Weitere Werte desselben Messpults lassen sich
als Bedingungen ergänzen. Der dritte Quellenbutton **INSTRUMENT** und eine
verpflichtende Mehrfachauswahl legen pro Instrumentmeldung fest, auf welchen
Panels sie erscheint. Zeitbedingungen erkennen Rückgang oder Zunahme als Betrag/Prozent
und können einen Vergleich über Spieltage bis Jahrhunderte halten. Alle
Instrumente werden weltbezogen gespeichert; der Pfeil am Instrument springt
zur ersten überwachten Quelle.

## API für andere Mods

UNMA lädt ausschließlich Definitionen tatsächlich aktiver Mods aus
`<Provider-Mod>/UNMA/*.json`. Eine defekte Datei wird isoliert protokolliert
und kann weder andere Provider noch den Spielstart blockieren. Erweiterte
Messwerte und direkt veröffentlichte Zustände stehen über
`UNMA.Api.UnmaApi` mit `ApiVersion = 1` bereit.

Der vollständige Vertrag, das JSON-Schema und ein lauffähiges Providerbeispiel
stehen im deutschsprachigen
[Integrations- und Mehrsprachen-Schnellstart](docs/provider-integration.de.md),
in [docs/external-mod-api.md](docs/external-mod-api.md),
[docs/unma-extension-v1.schema.json](docs/unma-extension-v1.schema.json) und
[examples/ProviderMod](examples/ProviderMod).

## Audio und Lizenzen

Eigene Dateien kommen nach:

```text
UNMA/Sounds/mein-alarm.wav
UNMA/Sounds/mein-alarm.ogg
```

Technisch unterstützt werden PCM-WAV und Ogg Vorbis. Ein Dateiformat macht den
Inhalt nicht automatisch lizenzfrei. Verwende eigene Aufnahmen, CC0-Material
oder Dateien mit einer Lizenz, die Weitergabe und Nutzung erlaubt.

## Grenzen der ersten Version

- Physische Straßen, Gebäude, Fahrzeuge und Transporte sind Entities und damit
  auswählbar. Logistikzonen, Designationen und abstrakte Routen sind in der
  Spiel-API dagegen keine anklickbaren `IEntity`-Objekte; dafür ist später ein
  eigener Zonen-/Routen-Picker nötig.
- Produktzeilen werden beim Anlegen für Produkte angeboten, die sich gerade im
  Lager, Transport oder Fahrzeug befinden. Ein völlig leeres, noch nie
  benutztes Objekt bietet zunächst nur Gesamtmenge und Füllstand an.
- Die Transportkapazität beschreibt den momentanen Inhaltsraum, nicht den
  Durchsatz pro Zeit.
- Vanilla- und Systemmeldungen besitzen eigene feste Auswertungsmodelle und
  nehmen deshalb keine Entity-Bedingungen direkt auf. Zum Verknüpfen wird eine
  eigene Meldung beziehungsweise das freie Plus-Karree verwendet.
- Abgekoppelte Panels bleiben innerhalb der Spieloberfläche. Die offizielle
  Mod-API stellt keine beliebig verschiebbaren nativen Betriebssystemfenster
  für Monitor 2, 3 usw. bereit. Das wäre ein separates Companion-Projekt mit
  IPC und eigener Sicherheits-/Kompatibilitätsprüfung.

## Bauen

Voraussetzungen:

- Captain of Industry 0.8.6c;
- MultiLangLib 0.1.0 oder neuer als aktivierte Mod-Abhängigkeit;
- optional Keybind Framework 2.0.2 oder neuer für frei konfigurierbare primäre
  und sekundäre Tastenkürzel;
- .NET Framework 4.8 Reference Assemblies;
- Visual Studio Build Tools 2022 oder `dotnet` mit passenden Referenzen.

```powershell
$env:COI_ROOT = 'C:\Program Files (x86)\Steam\steamapps\common\Captain of Industry'
.\build.ps1 -Configuration Release
```

Der normale Release-Build schreibt ausschließlich nach
`source\bin\Release\UNMA.dll`. Erst `build.ps1 -Deploy` kopiert die geprüfte
DLL ausdrücklich in den aktiven Mod-Stamm; dieser Schalter darf nur bei
geschlossenem Captain of Industry verwendet werden. `package.ps1` erzeugt
anschließend ein reproduzierbares Archiv, `tests\verify-release.ps1` prüft
Versionskonsistenz, Inhalt und SHA-256-Werte.

## Lizenz

Der Quellcode und die mathematischen Tongeneratoren stehen unter der MIT-Lizenz.
Captain of Industry und seine Assets sind Eigentum von MaFi Games.
