B.l.T.C.H AI Framework

1.0.19

B.I.T.C.H AI Framework - Changelog
Version: Heli Patrol V1.5 REAPER Persistence Fix / Savegame V4
Datum: 2026-10-08

V1.5 - DOPPELTE HELIKOPTER NACH SAVEGAME-LOAD VERHINDERT
---------------------------------------------------------
- Serverlog ausgewertet: Die native Reforger-Persistence stellte sechs alte
  Patrouillenhelikopter wieder her, danach erzeugte der BTH-Manager dieselben
  sechs Slots ein zweites Mal.
- Dynamische Helikopter werden jetzt mit PersistenceSystem.StopTracking aus der
  nativen Entity-Persistence entfernt.
- Dasselbe gilt fuer Pilot, Bordschuetze, Runtime-Gruppe und REAPER-Wegpunkt.
- Lazy/zeitversetzte Registrierung wird durch mehrere sichere Nachpruefungen
  abgefangen.
- BTH_FrameworkPersistence V4 bleibt alleinige Quelle fuer Heli-Slotstatus,
  Position und dauerhafte Abschuesse.
- Endlosschleife von Slot 2 mit zerstoertem Heli beziehungsweise nicht
  einsetzbarem Piloten wird damit beseitigt.
- Einmalig neuer Spielstand erforderlich, um bereits gespeicherte doppelte
  Entity-Datensaetze zu entfernen.

V1.4 - REAPER-INTEGRATION
-------------------------
- REAPER-Flugwegpunkt und REAPER-USSR-Pilot integriert.
- Motorstart auf HelicopterControllerComponent.StartEngine umgestellt.
- Bodenstartsuche erweitert und schneller Flugauftrag eingefuehrt.
- Kein Distanz-Despawn und kein Ersatz nach echtem Abschuss.

1.0.18

1.0.17

1.0.16

1.0.15

B.I.T.C.H AI Framework - Changelog
Version: Heli Patrol V1.0 / Savegame V3
Datum: 2026-10-08

NEU
---
- Eigene GameMode-Component fuer gegnerische Kampfhelikopter-Patrouillen.
- Helikopter-, Piloten- und optionale Bordschuetzen-Prefabs direkt im Editor einstellbar.
- Feste Zahl von permanenten Patrouillen-Slots.
- Kartenweite, fortlaufende Flugabschnitte mit zufaelliger Hoehe und zufaelligen Zielen.
- Feuer-frei-Kampfmodus und einstellbare autonome Kampfdistanz.
- Gestaffelter Erstspawn, damit nicht alle Helikopter gleichzeitig erzeugt werden.
- Technische Spawnfehler duerfen erneut versucht werden.

PERMANENZ
---------
- Kein Entfernung-Despawn.
- Kein normaler Respawn und kein Ersatzspawn nach Abschuss.
- Ein verschwundener oder zerstoerter, zuvor erfolgreich erzeugter Helikopter-Slot
  wird dauerhaft als verloren markiert.
- Wracks und eventuell ueberlebende Besatzung werden nicht vom Manager geloescht.
- Bei Stillstand wird nur ein neues Flugziel vergeben; kein Teleport und kein Ersatz.

SAVEGAME V3
-----------
- Der vorhandene B.I.T.C.H-Serializer wurde von V2 auf V3 erweitert.
- Slot-ID, erfolgreicher Erstspawn, dauerhafter Verlust und letzte Position werden gespeichert.
- Lebende Helikopter werden nach einem Serverneustart an ihrer letzten Position wieder aufgebaut.
- Dauerhaft zerstoerte Helikopter bleiben nach einem Serverneustart zerstoert.
- Alte Savegames der Versionen V1 und V2 bleiben kompatibel.

BESTEHENDES FRAMEWORK
---------------------
- AI Director V10.1 Schnellspawn bleibt enthalten.
- CounterAttack- und bisheriger Savegame-Fortschritt bleiben unveraendert erhalten.

1.0.14

B.I.T.C.H AI Director V10.1 – Schnellspawn
==========================================

Änderungen
----------
- Erstspawn und Savegame-Wiederaufbau laufen deutlich schneller.
- Zwei native KI-Gruppen dürfen kontrolliert gleichzeitig aufgebaut werden.
- Der Direktor aktualisiert Spawn und Restore jede Sekunde statt alle zwei Sekunden.
- Pro Tick werden bis zu acht Spawn-Aufträge vorgemerkt.
- Infanterie-Mitglieder erscheinen mit 150 ms Abstand, Fahrzeugbesatzungen mit 200 ms Abstand.
- Pausen zwischen Gruppen und Fahrzeugstufen wurden verkürzt.
- Restore wird nach einer stabilen Prüfung bestätigt; fehlende Mitglieder werden weiterhin nachgefordert.
- Leere oder überlastete Gruppen erhalten weiterhin kontrollierte Wiederholungsversuche.
- Der Direktor startet nach 8 statt 20 Sekunden.
- Savegame-Format und vorhandene Spielstände bleiben kompatibel.

Sicherheitsgrenze
-----------------
Es werden standardmäßig höchstens zwei native Gruppen gleichzeitig aufgebaut. Dadurch entsteht kein ungebremster Spawn-Burst und der V10.0-Schutz gegen leere oder unvollständige Gruppen bleibt erhalten.

Erwartete Wirkung
-----------------
Bei normalen Gruppenstärken sollte der komplette Aufbau ungefähr zwei- bis viermal schneller werden. Die genaue Dauer hängt von Gruppenstärke, Serverlast, Prefabs und Navmesh-Streaming ab.

1.0.13

B.I.T.C.H AI Framework - Savegame V10.0
========================================
Aenderungen seit Savegame V2.2 / AIDirektor V9.9.1
Stand: 08.10.2026

KI-GRUPPEN UND SPAWN-STEUERUNG
------------------------------
- Normale und wiederhergestellte KI-Gruppen gelten erst nach stabiler Fertigstellung als bereit.
- Das Queue-Gate wartet jetzt auf den eigenen finalen Gruppenstatus und verlaesst sich nicht mehr allein auf die unzuverlaessige Engine-Anzeige der Member-Queue.
- Die naechste Gruppe beginnt erst, nachdem die vorherige Gruppe fertig verarbeitet wurde.
- Das Zeitfenster fuer Erstbesetzung und offene Startgruppen wurde auf 300 Sekunden erweitert.
- Dadurch werden langsam aufgebaute Gruppen unter hoher Serverlast nicht vorzeitig uebersprungen.

LEERE ODER UNVOLLSTAENDIGE GRUPPEN
---------------------------------
- Fehlende Gruppenmitglieder werden innerhalb derselben bestehenden Gruppe erneut angefordert.
- Bereits erschienene Gegner werden beim Nachladen nicht geloescht oder neu gespawnt.
- Eine leer gebliebene Gruppe erhaelt bis zu drei kontrollierte Nachladeversuche.
- Bleibt ein konkreter Prefab-Slot dauerhaft leer, wird er einmalig sauber uebersprungen.
- Verbrauchte Infanterie- und Fahrzeugtickets werden bei einem dauerhaft unbrauchbaren Slot erstattet.
- Der sichtbare Endloskreislauf aus Einspawnen, Loeschen und erneutem Einspawnen wird verhindert.

FAHRZEUGE UND BESATZUNGEN
-------------------------
- Spaeter eintreffende Fahrzeugbesatzungen werden fortlaufend in ihr Fahrzeug eingesetzt.
- Bereits sitzende Besatzungsmitglieder werden dabei nicht erneut verarbeitet.
- Fahrzeuggruppen werden erst nach stabiler Besatzung als fertig behandelt.
- Wiederhergestellte Fahrzeuge behalten die gespeicherte Restbesatzung.

SAVEGAME UND RESTORE
--------------------
- Fehlende Mitglieder einer gespeicherten Gruppe werden bis zur gespeicherten Reststaerke nachgeladen.
- Restore-Versuchszaehler werden nach erfolgreicher Wiederherstellung oder einem kompletten Neuversuch sauber zurueckgesetzt.
- Gefallene Gegner bleiben weiterhin gefallen.
- Laufende Kampfphase, Wellenfortschritt, Restgruppen sowie Infanterie- und Fahrzeugbudget bleiben erhalten.
- Laufende Gegenangriffe und verbliebene Garnisonen bleiben weiterhin gespeichert.

BESTAETIGTE SERVERTESTS
-----------------------
- Frischer Speicherstand erfolgreich erstellt und erneut geladen.
- Laufender Kampf mit 3 Gegnern korrekt wiederhergestellt.
- Spaetere Wiederherstellung mit exakt 11 gespeicherten Gegnern erfolgreich.
- Fahrzeug und Fahrzeugbesatzung erfolgreich wiederhergestellt.
- Despawn speichert Reststaerke und laufende Phase korrekt.
- Automatische Speicherung etwa alle 5 Minuten erfolgreich.
- Abschalt-Speicherung savepoint019 erfolgreich.
- savepoint019 beim folgenden Serverstart erfolgreich geladen.
- Zwei laufende Einsatzorte wurden nach dem Neustart korrekt erkannt.
- Keine leeren Gruppen, keine AIDirektor-Fehler und kein notwendiges RESTORE-NACHLADEN in den geprueften Serverlaeufen.

HINWEISE
--------
- Convoy BAD-ROUTE-RESPAWN ist die vorgesehene Selbstkorrektur bei einer unbrauchbaren Fahrzeugroute.
- Die protokollierten GM-Ausnahmen stammen aus TAOPlayerController beim Beenden einer Besitzuebernahme und nicht aus der Savegame-Persistenz.
- Support-Station-, Faction- und EditorComponent-Meldungen stammen aus anderen Prefabs beziehungsweise Mods.

1.0.12

1.0.11

1.0.10

B.I.T.C.H AI Framework - Savegame V2.1
======================================

- AIDirektor V9.9 verhindert ueberlappende native Gruppen-Warteschlangen.
- Die naechste Gruppe startet erst, wenn Reforger die Mitglieder der vorherigen Gruppe abgearbeitet hat.
- Gruppen mit noch aktiver Member-Queue werden nicht mehr irrtuemlich geloescht und neu gespawnt.
- Das Initialisierungs-Zeitlimit wird auf mindestens 120 Sekunden abgesichert.
- Der sichtbare Ein-/Ausspawn-Kreislauf bei hoher Serverlast ist damit behoben.

- Laufende AIDirektor-Kaempfe werden jetzt ueber Serverneustarts gespeichert.
- Gefallene Gegner bleiben gefallen; nur die gespeicherte Reststaerke wird restauriert.
- Aktuelle Kampfphase, abgeschlossene Wellen und offene Verstaerkungen bleiben erhalten.
- Das verbleibende globale Infanterie- und Fahrzeugbudget wird gespeichert.
- Laufende OPFOR-Gegenangriffe werden mit ihrer Reststaerke fortgesetzt.
- USSR-Restgarnisonen erfolgreicher Gegenangriffe bleiben gespeichert.
- Erbeutete US/BLUFOR-Fahrzeuge werden nicht als gegnerische Kopie restauriert.
- Bestehende V1-Savegames bleiben kompatibel.
- Keine neue GameMode-Komponente und keine Aenderung der SystemsConfig erforderlich.

1.0.9

B.I.T.C.H AI Framework - Savegame V2
====================================

- Laufende AIDirektor-Kaempfe werden jetzt ueber Serverneustarts gespeichert.
- Gefallene Gegner bleiben gefallen; nur die gespeicherte Reststaerke wird restauriert.
- Aktuelle Kampfphase, abgeschlossene Wellen und offene Verstaerkungen bleiben erhalten.
- Das verbleibende globale Infanterie- und Fahrzeugbudget wird gespeichert.
- Laufende OPFOR-Gegenangriffe werden mit ihrer Reststaerke fortgesetzt.
- USSR-Restgarnisonen erfolgreicher Gegenangriffe bleiben gespeichert.
- Erbeutete US/BLUFOR-Fahrzeuge werden nicht als gegnerische Kopie restauriert.
- Bestehende V1-Savegames bleiben kompatibel.
- Keine neue GameMode-Komponente und keine Aenderung der SystemsConfig erforderlich.

1.0.8

B.I.T.C.H AI Framework – Savegame Update
DE:
• AI-Direktor-Fortschritt wird jetzt dauerhaft gespeichert.
• Gesicherte Einsatzorte bleiben nach einem Serverneustart gesichert.
• Eingenommene US/NATO-Basen werden nicht mehr auf USSR zurückgesetzt.
• An bereits gesicherten Basen erscheinen nach einem Neustart keine normalen Verteidiger erneut.
• Ziele und Status der beiden Gegenangriff-Stufen werden gespeichert.
• Vollständig in das vorhandene Conflict-Savegame integriert.
• Keine Änderungen am GameMode oder an der Server-Konfiguration erforderlich.
EN:
• AI Director progress is now saved permanently.
• Secured encounter locations remain secured after a server restart.
• Captured US/NATO bases are no longer reset to USSR.
• Standard defenders no longer respawn at previously secured bases after a restart.
• Targets and completion states of both counterattack stages are now saved.
• Fully integrated into the existing Conflict savegame system.
• No GameMode or server configuration changes required.

1.0.7

DE: Savegame-Fix: Eroberte US/NATO-Basen bleiben nach einem Serverneustart erhalten. Der AI-Direktor behandelt geladene US/NATO-Basen als bereits gesichert und erzeugt dort keine neuen Standardgegner.
EN: Savegame fix: Captured US/NATO bases now remain captured after a server restart. The AI Director treats restored US/NATO bases as secured and no longer respawns standard enemies there.

1.0.6

1.0.5

1.0.4

1.0.3

1.0.2

Version 1.0.2 – 06.10.2026
B.I.T.C.H AI Framework | Amogus
DEUTSCH
• Scripts für die Wiederverwendung in einer separaten Framework-Mod vorbereitet.
• Alle elf Scriptdateien einheitlich mit B.I.T.C.H-Präfix und Autorenhinweis versehen.
• AiDirektor auf Conflict-Basen ausgerichtet; feste Ortslisten entfernt.
• Automatischen AiDirektor-Scan anhand der tatsächlichen World-Bounds ergänzt.
• HQ-Suche in BaseBlock von festen Scanradien auf konfigurierte Entity-Namen umgestellt.
• World-Bounds-Suche für Convoy und CounterAttack integriert.
• Festen Convoy-Suchfallback entfernt und Prüfung ungültiger Bounds verbessert.
• Konfigurierte Fahrzeug-Navmesh-Namen in AiDirektor und Convoy werden respektiert.
• HQ-Namen im IEDSpawner konfigurierbar gemacht.
• CounterAttack-Fortschrittsschwellen auf 7–9 / 10–12 abgesichert.
• Alte CounterAttack-Testmindestmengen entfernt; konfigurierte Mengen einschließlich 0 werden berücksichtigt.
• Bestehende Kampf-, Capture-, Spawn- und Streaming-Logik ansonsten beibehalten.
Serverstart und erste Laufzeitabläufe bestätigt. Vollständige CounterAttack-/Restore-Tests stehen noch aus. Keine vollständige Persistenz über Serverneustarts enthalten.
ENGLISH
• Prepared scripts for reuse in a separate framework mod.
• Standardised all eleven script filenames with the B.I.T.C.H prefix and author credit.
• Restricted AI Director encounters to Conflict bases and removed fixed location lists.
• Added automatic AI Director scanning based on actual world bounds.
• Replaced fixed-radius BaseBlock HQ searches with configured entity-name lookups.
• Integrated world-bounds scanning for convoys and counterattacks.
• Removed the fixed convoy scan fallback and improved invalid-bounds handling.
• Preserved explicitly configured vehicle navmesh names in the AI Director and Convoy Manager.
• Made IED Spawner HQ names configurable.
• Enforced production counterattack thresholds of 7–9 / 10–12 bases.
• Removed old counterattack test minimums; configured quantities now support 0.
• Otherwise retained existing combat, capture, spawn and streaming logic.
Server startup and initial runtime behaviour confirmed. Full counterattack/restore testing remains pending. Full persistence across server restarts is not included.

1.0.1

1.0.0