TOBI`S KARTENGENERATOR 0.3.6 BETA 1 HF1
BEDIENUNGSANLEITUNG - DEUTSCH
====================================

1. ZWECK DES PROGRAMMS
----------------------

Tobi`s Kartengenerator erzeugt leere, bearbeitbare Karten fuer Panzer Corps 1.
Folgende Zielmodule stehen zur Auswahl:

- Modern Conflicts
- PAK Mod
- Panzer Corps Original

Die erzeugte Karte enthaelt Gelaende, Gewaesser, Orte, Anlagen, Strassen und
Bahnlinien. Sie enthaelt absichtlich noch keine Einheiten, Siegbedingungen,
Trigger, Ereignisse, Aufstellungsfelder oder vollstaendige Missionslogik.
Die Endbearbeitung erfolgt deshalb im passenden Panzer-Corps-Editor.


2. SYSTEMVORAUSSETZUNGEN
------------------------

- Windows 11 (Zielsystem)
- Windows 10 wird mit BETA 1 HF1 zusaetzlich auf Kompatibilitaet getestet
- Windows PowerShell 5.1
- Panzer Corps 1 mit dem Editor des gewaehlten Zielmoduls
- kein Python erforderlich
- keine Internetverbindung erforderlich

Den gesamten Programmordner vor dem Start vollstaendig entpacken.


3. PROGRAMM STARTEN UND SPRACHE WAEHLEN
---------------------------------------

Deutscher Start:
  Start_MC_Kartengenerator.bat

Englischer Start:
  Start_MC_Map_Generator_EN.bat

Oben rechts muss "Version 0.3.6 BETA 1 HF1" stehen. Die Sprache kann waehrend
des Betriebs ueber "Sprache / Language" gewechselt werden.

Der Standard-Ausgabeordner lautet:

- deutsche Bedienung: Karten
- englische Bedienung: Maps

Wurde ein eigener Ausgabeordner ausgewaehlt, wird dieser durch einen
Sprachwechsel nicht veraendert.


4. ZIELMODUL AUSWAEHLEN
-----------------------

Die hervorgehobene Auswahl "ZIELMODUL AUSWAEHLEN" bestimmt, fuer welchen
Editor die Karte geschrieben wird.

Modern Conflicts
  Verwendet den bewaehrten MC-Writer und die bestaetigten MC-Overlays.

PAK Mod
  Verwendet die im PAK-Editor kontrolliert bestaetigten Tile- und
  Overlayabweichungen.

Panzer Corps Original
  Verwendet klassische PC1-Basis-Tiles. MC- und PAK-Overlays werden in diesem
  Modus ignoriert; jedes Overlayfeld wird mit dem Wert 0 geschrieben.

Wichtig: Die Karte spaeter immer mit dem Editor des ausgewaehlten Zielmoduls
oeffnen.


5. PROJEKT, KARTENGROESSE UND SEED
----------------------------------

Kartenname
  Bestimmt den Datei- und Szenarionamen. Ungeeignete Sonderzeichen werden
  beim Export durch Unterstriche ersetzt.

Ausgabeordner
  Zeigt den Zielordner fuer die fertigen PZSCN- und PZLOC-Dateien. Mit
  "Auswaehlen" oder "Ausgabeordner waehlen" kann ein eigener Ordner
  eingestellt werden.

Kartenbreite und Kartenhoehe
  Bestimmen die Kartengroesse in Hexfeldern.

Zufalls-Seed
  Derselbe Seed erzeugt bei gleichen Einstellungen dieselbe Kartengeometrie.
  "Neuen Seed" erzeugt eine andere Zufallszahl.

Projektdatei
  "Speichern" legt die aktuellen Einstellungen als MCMap-Projektdatei ab.
  "Oeffnen" laedt eine solche Projektdatei wieder.


6. KARTENTYP UND LANDSCHAFTSPROFIL
----------------------------------

Der Kartentyp bestimmt die Grundform, zum Beispiel Kontinent, Kueste,
Archipel, Seenlandschaft, Gebirgsregion, Wueste oder Gemischt.

"Kartentyp-Profil anwenden" laedt passende Grundeinstellungen fuer den
gewaehlten Kartentyp und setzt das Landschaftsprofil auf Standard zurueck.

Das Landschaftsprofil bestimmt eine typische Verteilung und Clusterform,
zum Beispiel:

- Osteuropa - offen
- Osteuropa - Wald/Sumpf
- Gebirge & Paesse
- Nordafrika - Wueste
- Kueste / Insel

"Landschaftsprofil anwenden" traegt die zu diesem Profil gehoerenden Werte
automatisch ein. Andere Werte muessen vorher nicht auf 0 gesetzt werden.
Nach dem Anwenden duerfen einzelne Einstellungen weiterhin manuell angepasst
werden.


7. GELAENDE, GEWAESSER, ORTE UND ANLAGEN
----------------------------------------

In den Einstellreitern werden Anzahl und Verteilung der Kartenelemente
festgelegt. Die angegebenen Prozentwerte beziehen sich auf die nutzbare
Landflaeche. Nicht verteilte Flaeche bleibt freies Grundgelaende.

Ortschaften und Flugplaetze werden nicht innerhalb der drei gesperrten
Hexreihen am Kartenrand platziert. Flugplaetze werden auf grossen Karten
moeglichst mit 14 bis 16 Hexfeldern Abstand verteilt. Auf kleinen Karten wird
der Abstand automatisch angepasst.

Haefen werden nur an nutzbaren und fuer das Zielmodul bestaetigten
Kuestenformen gesetzt. Kann keine passende Stelle gefunden werden, erscheint
ein Hinweis, statt eine falsche Hafengrafik zu erzwingen.


8. FLUESSE, STRASSEN UND BAHNLINIEN
-----------------------------------

Kleine und grosse Fluesse besitzen getrennte Anzahl- und Laengenfelder.
Bei der Flusslaenge bedeutet 0 eine automatische Laenge. Die Fluesse erhalten
wechselnde Richtungen, Kurven und Abstand zueinander; lange parallele Verlaeufe
werden nach Moeglichkeit vermieden.

Strassen und Bahnlinien werden als durchgehende Verkehrsnetze erzeugt. Sie
duerfen nicht im Karteninneren enden und erhalten Verbindungen zum Kartenrand.

HF2 korrigiert die technische Pruefung von Wuesten-Strassengrafiken unter
Orten und Befestigungen. Diese wurden zuvor gelegentlich faelschlich als
ungueltig gemeldet, obwohl der PC1-Editor die Karte korrekt oeffnete.


9. KARTE ENTWERFEN UND PRUEFEN
------------------------------

1. Alle gewuenschten Einstellungen vornehmen.
2. "Karte entwerfen" anklicken.
3. Vorschau und Statistik kontrollieren.
4. Bei Bedarf Einstellungen oder Seed aendern und erneut entwerfen.
5. "Technisch pruefen" anklicken.

Die Vorschau und der vollstaendige Prueftext werden innerhalb des Generators
angezeigt und nicht automatisch als Dateien gespeichert.


10. PZSCN UND PZLOC EXPORTIEREN
-------------------------------

Nach erfolgreicher Kontrolle "PZSCN + PZLOC exportieren" anklicken.

Beispiel bei deutscher Bedienung und Kartenname W_ste:

  Karten\W_ste\W_ste.pzscn
  Karten\W_ste\W_ste.pzloc

Der Kartenordner enthaelt ausschliesslich diese beiden erzeugten Dateien:

- PZSCN: eigentliche leere Editor-Karte
- PZLOC: Szenario-, Seiten- und Ortsnamen

Nicht mehr automatisch exportiert werden MCMap-Projekt, Vorschau-PNG,
Szenariobild, Pruefbericht oder ZIP. Bereits vorhandene Dateien in einem
selbst gewaehlten Ordner werden aus Sicherheitsgruenden nicht geloescht.


11. PROJEKT SPEICHERN
---------------------

Soll die Konfiguration spaeter erneut bearbeitet werden, unter
"Projekt & Groesse" auf "Speichern" klicken. Die MCMap-Datei wird
standardmaessig im Ordner "Projekte" abgelegt. Sie gehoert nicht zu den zwei
fertigen Kartendateien und wird deshalb nicht automatisch mitexportiert.


12. WEITERARBEIT IM PANZER-CORPS-EDITOR
---------------------------------------

1. PZSCN mit dem passenden Editor oeffnen.
2. Karte im Editor kontrollieren und speichern.
3. Einheiten, Seiten, Besitz, Aufstellungsfelder und KI-Befehle ergaenzen.
4. Siegbedingungen, Rundenzahl, Trigger und Ereignisse anlegen.
5. Fuer ein fertiges Szenario bei Bedarf ein eigenes Szenariobild hinzufuegen.
6. Das fertige Szenario im Spiel testen.

Der Kartengenerator ersetzt nicht den Panzer-Corps-Editor. Er nimmt dem Nutzer
die zeitaufwendige Erstellung der Kartenbasis ab.


13. SELBSTTEST UND FEHLERSUCHE
------------------------------

Bei einer neuen Version oder einem Fehler:

1. Selbsttest_Windows.bat starten.
2. Warten, bis der Test vollstaendig beendet ist.
3. Das Ergebnis muss 0 Fehler melden.
4. Bei einem Fehler Selbsttest_Ergebnis.txt aufbewahren und weitergeben.

Der Selbsttest prueft unter anderem PowerShell-Syntax, Vorlagen, Beispiele,
Terrainwerte, Overlays, Verkehrswege, Exportdateien und die Aktualitaet dieser
deutschen sowie der englischen Text-Bedienungsanleitung.

HF1 behebt den Startfehler der ersten geschuetzten BETA 1, bei dem Windows
PowerShell 5.1 ein unsichtbares UTF-8-BOM vor "Set-StrictMode" als Bestandteil
des Befehlsnamens behandelte. Das BOM wird nun beim Schutzbau entfernt und vom
Lader zusaetzlich abgefangen. Die Kartenlogik wurde dabei nicht veraendert.


14. NICHT MEHR ENTHALTENE FUNKTIONEN
------------------------------------

Die automatische Map-Screen-/OCR-Umwandlung wurde entfernt, weil die
Windows-Ortserkennung und die automatische Gelaendeerkennung nicht verlaesslich
genug waren. Auch die Skizzenfunktion bleibt vorerst entfernt, da sie nicht
sauber von der automatischen Erzeugung getrennt werden konnte.


15. BETA-TEST UND KERNSCHUTZ
----------------------------

BETA 1 HF1 ist ein geschuetztes Testpaket. Der eigentliche Kartenkern liegt nicht
als lesbares PowerShell-Skript bei. Beim Start wird seine Integritaet geprueft
und er wird nur im Arbeitsspeicher geladen. Werden gebundene Programmdateien
veraendert oder beschaedigt, verweigert der Kern den Start.

Vor einer oeffentlichen Veroeffentlichung soll das unveraenderte ZIP auf einem
zweiten Windows-11-PC und nach Moeglichkeit auf Windows 10 geprueft werden.
Windows Defender eingeschaltet lassen. Eine echte Virenfundmeldung nicht
umgehen, sondern mit Screenshot und Selbsttest_Ergebnis.txt melden.


16. DOKUMENTATIONSREGEL
-----------------------

BEDIENUNGSANLEITUNG_DE.txt und BEDIENUNGSANLEITUNG_EN.txt gehoeren
verbindlich zu jeder neuen oder geaenderten Version. Beide Dateien muessen
immer die jeweilige Programmversion tragen.
