EXPBG GM Optimizer

0.1.17

# Changelog

## 0.1.17 — 2026-09-18

- Fix a server script compile failure with large mod lists: `EBG_CacheCleanup.c(1159): Too many instructions per function` / `Incompatible parameter 's_BelongingsModels'`. The cleanup allow-lists are now built on first use instead of as static field initializers, so they no longer consume the engine's shared static-initializer budget.
- Verified with 223 installed Workshop addons plus EXPBG Ambient Civilians on a dedicated server: the same set that previously failed with 208 such errors now compiles and runs. Allow-list contents, cleanup and caching behaviour are unchanged.
- Another large mod list can still reach the engine's budget through other mods' static fields; this release removes the Optimizer's share of it.

## 0.1.16 — 2026-09-15

- New cache zones default GM overlays to Selected: radii appear only while that module is selected in Game Master.
- Existing saved overlay choices and the Off/All options are preserved. AI caching, cleanup and access rules are unchanged.
- Feedback: L.S.Lex.

## 0.1.15 — 2026-09-14

- Publish tagged releases through GitHub Actions using a native Windows Workbench runner; retain both Linux runners for portable CI.
- Generate the upload manifest from freshly packed files, with SHA256 validation and the existing Unlisted listing metadata.
- Retain persistent runner tools/login state and document the tested Linux graphics limitation.
- AI runtime behavior is unchanged from 0.1.14. This release makes no additional gameplay compatibility or performance claims.

## Repository migration — 2026-09-14

- Import the published 0.1.14 runtime unchanged into `addon/EXPBG_GM_Optimizer`.
- Separate operator/developer documentation, 33 native fixture source files, test resources and build/release tooling from addon resources.
- Add agent instructions, local configuration, repository/source-package CI and repeatable test matrices.
- Detect unindexed source before native tests; require an explicit successful counted test result and handle prepare-only reports.
- Give the regroup fixture a bounded 240-second window for initial native sleep, merging and a second safety wait; gameplay timers are unchanged.
- Preserve runtime version and existing Workshop item/visibility. No new Workshop upload is part of this migration.

## 0.1.14 — 2026-09-11

- Reconcile settled missing members of active groups so confirmed removed members no longer permanently block surviving AI from caching.
- Preserve unresolved ownership, prior player history, retained Simulation/Full recovery and missing original parent protections.
- Release removed-member cleanup registration without deleting detached equipment or resurrecting removed AI.
- Keep existing regroup work budgets; no added frame callback, timer or world search.

See [release verification](docs/releases/0.1.14-verification.md) for exact scope and [handover](docs/HANDOVER.md) for remaining limits. Earlier behavior is documented in the user guide; this changelog does not invent release-by-release history from incomplete notes.

0.1.16

New cache zones now show their visible zone barriers only while the module is selected in Game Master.

- Set **GM overlays → Off** to hide the barriers even while selected, including for screenshots.
- Existing saved settings are preserved; Off and All remain available.
- AI caching, cleanup and GM permission checks are unchanged.

Feedback: **L.S.Lex**.

Validation: native Windows compile/index/install passed with exit 0; repository and release guards passed. This release does not repeat full gameplay, JIP, CDF or performance testing. GitHub Actions publishes this version to the existing **Unlisted** Reforger Workshop item.

0.1.15

This release fixes the automated publishing pipeline. AI runtime behavior is unchanged from 0.1.14.

- Native Workbench build, packing and publication run through GitHub Actions on the dedicated Windows publisher. Both Linux runners continue portable CI.
- Upload metadata is generated from freshly packed files, with SHA256, item identity and Unlisted visibility checks.
- Runner setup, persistent state and the tested Linux graphics limitation are documented.

Validation: native Windows Actions build/pack check passed in run 34827404627; local 0.1.15 build passed with exit 0. Release guards cover incomplete packing, changed payload hashes and wrong identity/visibility.

Publication status must be checked in the release Actions run. This is not additional gameplay/JIP/CDF or performance certification; existing limits remain in docs/HANDOVER.md.

0.1.14

0.1.14: Fixed active AI groups remaining blocked after a member disappears without a recorded death. Stable native roster checks retire confirmed absent members without respawning them. Full Cache snapshots, player history and unresolved recovery remain protected. Detached gear is left intact. 62 targeted native checks passed; no new per-frame checks or timers.

0.1.13

0.1.13: Expanded feature guide, CDF save/import instructions, verified test scope and performance evidence. Runtime unchanged from 0.1.12. 722 initial native assertions plus 51 final CDF import checks. Known intermittent far-LOD fire-mode hold remains; experimental fix withheld pending wake verification. No unverified CPU/FPS savings claimed.

0.1.12

Fix cache-module-only settings leaking global weather/DriveBy attributes. Enroll eligible existing AI after native save loading while preserving player and ownership exclusions. Allow stable nonbleeding wounds to recache; new damage and active combat retain safety delays. Add supported fixed MG/turret occupants with verified original-seat restoration or on-foot return when that static gun is unavailable; vehicles and helicopters remain excluded. Clarify whole-zone proximity and CDF save preparation. Full still respawns only surviving prefab slots with default kit and health.

0.1.11

0.1.11 - Civilian enrollment, performance and save fixes
Repairs stable AI regrouping within one cache module, including additions to Full-cached groups. Preserves player exclusions, casualty records and cleanup ownership. Guards managed groups against stale empty-group deletion.
Avoids unnecessary restores for harmless settings, reduces repeated roster/geometry/cleanup searches, limits cleanup work, summarizes repeated logs, and separates cached/pending/recovery diagnostics.
Preserves waypoint cycle intent in CDF/native saves and fixes native casualty counts after Full wake and mission reload. Eligible regenerated corpse visuals no longer block verified survivors; unknown or protected items remain excluded.
Targeted native/CDF reload, installed-mod and genuine wake-casualty checks passed. One 96-AI profile reduced registration from 2125 to 270 ms; this is not an FPS guarantee.
Limits: two-client/JIP, Linux and large-scale stress coverage are incomplete; an empty-group save edge case remains untested. Original native exit crash attribution remains open. Restore all AI and pause before mission saving remains required. Full Cache restores survivor prefab defaults, not custom inventories.

0.1.10

0.1.10 - CDF waypoint save order
Fixed waypoint order when preparing cached AI for a CDF mission save. Full member removal can shuffle the editor hierarchy; save preparation now exposes the actual waypoint queue while preserving the native leader-first rule. No CDF dependency or new polling loop was added. Existing restore-and-pause preparation remains required.
Verified a fresh CDF dedicated-server export/import with six Full AI, six Simulation AI, four Defend/Move waypoints and three independent modules. Both groups retained waypoint types, order, positions and current waypoint, then recached automatically. Prepared writer/read checks 25+43 and CDF/native settings regression 32 passed. Full Cache still restores prefab-default equipment. Arbitrary scripted waypoints and exhaustive multiplayer/JIP coverage are not certified.

0.1.9

0.1.9 - CDF and native saved-module resume
Fixed CDF/standard session attribute restoration on the server. Saved configuration and enabled choices survive loading, including modules temporarily paused to prepare a save. Enabled modules resume automatically after settings and native load binding finish; disabled modules remain off. One-shot actions are excluded from session serialization. Enrollment waits while settings are pending or the module is paused.
Verified CDF and native disk saves with distinct writer/reader dedicated-server processes: three modules, two six-AI squads, mixed Full/Sim modes, independent activation and display settings, and automatic recaching without manual re-enable or resave. Existing save preparation remains required. Native caching safety delays still apply. This is targeted save/load testing, not a new complete multiplayer certification.

0.1.8

0.1.8 - Survivor-only prefab Full Cache and remote GM controls
Full Cache now respawns each surviving AI's original unit prefab with default kit. Dead units stay dead. Custom gear, ammo and damage reset; the group, waypoints and positions are retained. Removes item-serializer and mission-persistence requirements for Full Cache. Vehicle/player and unsafe-operation protections remain.
New zones start disabled; enabling resumes a paused zone. Simplified actions, All GM radii by default, and a clearer top-left public debug panel. Cache-only attribute selections filter unrelated Drive By settings. Fixed compatibility with the installed EXPBG AI weapon-lock field.
Validation: 45 native checks passed, zero failures, with 121 configured mods and one local diagnostic client. Includes eight AI minus five confirmed deaths, two Full sleep/wake cycles, Sim sleep/wake, module independence and public HUD toggles. Production authentication and exhaustive JIP/multi-client testing are not claimed.

0.1.7

0.1.7 - Public debug metrics
Debug testing On in any module now shows one persistent panel to every player and late joiner. Displays server/client FPS and frame interval, engine allocations, client ping/loss, managed cache totals, pending work/recovery and rotating module settings. All modules contribute to totals and coalesced server logs. Updates once per second with bounded display/network size. All Debug toggles Off, or deletion of the last requesting module, removes the panel.
Mixed Simulation/Full and per-group/whole-zone module settings remain independent. GM radius-marker authorization is unchanged. CPU/GPU utilization and bandwidth are not available through the panel; engine allocations are not total process RAM. This update does not claim to resolve the previously documented native inventory-transfer stress error or certify universal mod/JIP compatibility.

0.1.6

0.1.6 - Simulation scheduling update
Removed permanent refreshes of unchanged sleeping characters. Inventory and identity events apply changes, with one debounced follow-up for deferred attachments. Cleanup uses immediate ownership events and a 60-second safety scan; blocked casualty inventories retry on relevant changes or after 60 seconds. Native garbage timers resume correctly when protection is disabled. All zones share group discovery.
Native source checks: 20 sleep/wake cycles and a separate 86-check inventory/casualty regression passed. One other scripted loaded-container stress run encountered an unresolved native replication error and disconnect assertion; this update is not a universal mod/JIP certification or engine assertion fix. Unsupported RHS device states retain safe refusal.

0.1.5

0.1.5: Reduce Simulation Cache attachment traversal cost with a temporary entity lookup and avoid redundant visibility writes. Existing 100 ms ownership, attachment, physics and restoration checks remain. Full Cache behavior is unchanged. Native source validation passed 20 repeated sleep/wake cycles and nine hierarchy controls. This is a maintenance optimization, not a universal FPS or mod-compatibility guarantee.

0.1.4

Fix Simulation caching waking a squad because its own suspended squadmate has a queued PhysicsContact. Preserve player, noncontact, foreign-group and external-LOD safety checks. Native retained-contact and negative-control regressions passed. AI in vehicles or helicopters continue to keep their whole group uncached. No new settings or dependencies.

0.1.3

0.1.3: Fix Full Cache verification when native AI perception target ages advance during restoration, preserving strict target identity, equipment and ownership checks. Fix exact RHS AK74N Dovetail mount remapping and an unresolved-mapping failure branch. Add bounded native parser validation. Both modes exclude whole groups while any member occupies a vehicle or helicopter. Stationary car/helicopter passengers, post-exit cache/wake, Soviet six-member roster and two-client Full JIP/four activation combinations passed with the installed EXPBG/RHS/GME set. Unsupported mod state still refuses safely. Performance measurements remain separate; no universal compatibility claim.

0.1.2

Fix stale squadmate PhysicsContact events preventing cache eligibility after native distance LOD deactivates AI. The exception is limited to living, never-player members of the same group at automatic maximum LOD. Player and non-contact dangers, health checks and active-operation protections remain enforced. Includes the 0.1.1 closed-GM JIP stability fix.

0.1.1

0.1.1 - Game Master stability fix

Prevents a native player-possession callback from accessing a cleared editor map after Game Master closes. Open-editor updates still use the native callback, and reopening rebuilds the player maps normally.

No changes to AI cache modes, activation settings, equipment restoration or cleanup scope.

0.1.0