AELI - overlay (Wardogs engine) / source and runtime

BRAND UPDATE (2026-11-02) · Aeli v1.2.6
- Product name shown in the UI is now AELI: menu top bar, side-bar brand row and the
  console window title. The overlay window class/title keeps its disguise on purpose.
- Menu badge is the chosen Aeli mark (arch + crossbar + core dot, brand gradient), drawn
  with ImGui primitives (two cubic beziers + two lines + a dot). No bitmap asset needed.
- Version v1.2.6 is shown in the top bar (chip), the side-bar brand row, the Settings hint and
  the EXE File/ProductVersion resource (Usermode/App.rc).
- File names are unchanged on purpose: Wardogs.exe, Wardogs.ini, Wardogs-layout.ini.
  Renaming them would orphan saved settings and the packaging scripts.

ADVANCED AIM UPDATE (2026-11-01)
- 高级瞄准 page (menu > 战斗 > 高级瞄准), four tabs, all off by default:
  * 迫击炮 / SPH-2 自动瞄准: interpolates the supplied game tables
    (L81 132-684 m, SPH-2 780-2629 m) into mils, converts mils to elevation,
    and pushes the yaw/pitch error out as step-limited mouse movement.
    Target = nearest enemy in radius, or the map target point (exact inverse
    map->world transform). Out of range does nothing and says why.
  * 直升机机炮魔术弹: velocity lead from adjacent samples (transients > 600 m/s
    rejected), bullet-speed based prediction, soft step-limited aim.
  * 魔术子弹: same prediction in soft mode; hard mode writes the projectile
    origin transform, enabled only when a verified muzzle offset is set (0 = off).
  * 说明 tab documents what is verified and what still needs a live offset.
- 战斗模式 (default ~): snapshot the current ESP settings, then keep only enemy
  boxes; pressing it again restores exactly what you had. Persisted across runs.
- Weapon name + FontAwesome icon above the box, vehicle/item icons, all with
  their own toggles and hotkeys. Buildings is a placeholder switch (see below).
- New hotkeys, all rebindable: ~ combat, F1 corpses, F2 weapons, F3 vehicles,
  F4 items, F5 mortar, F12 names, mouse4 bullet, mouse5 heli cannon.
- Settings file version 12; colliding new hotkeys are cleared once so you can
  rebind them instead of two features fighting over one key.
- Still missing, on purpose (no guessed values): building actor class names,
  SPH-2 reload-state offset, muzzle transform offset, live cannon muzzle velocity.
  See 高级瞄准与战斗模式.md for the exact entry points.

MOTION STREAM UPDATE (2026-09-18)
Movement/camera/poses now refresh independently of names, inventory and discovery.
Enable Smooth ESP motion + Adaptive motion buffer. Start at 120 Hz / 25 ms minimum.
Adaptive buffering can add up to 250 ms of visual delay on a slow input stream.
Settings separates motion timing, discovery timing and read failures.
Read MOTION-STREAM.md for architecture, validation and live-test limitations.
BUILD.cmd builds Release x64 with VS 2022 C++ Build Tools and a Windows SDK.
Source-only ZIP: no EXE included; the build copies required DLLs/maps automatically.
Full-source ZIP: ready runtime is also included under bin/x64/Wardogs.

RUN
Extract the ZIP completely. Run bin\x64\Wardogs\Wardogs.exe as before.
Keep the entire runtime folder, including DLLs, info.db and assets/maps.
Target: WardogsClient-Win64-Shipping.exe. Requires the existing working DMA setup.
The previous working runtime DLLs are included unchanged.

VISUALS UPDATE
- Independent snapline maximum distance (default 50 m), inclusive at the limit.
- Indicator and snapline RGBA color pickers in ESP Settings; saved automatically.
- Show dead players toggle (off by default) also applies to radar/maps. The
  decoded vitality tags distinguish Dead from Critical and Alive. Corpses must
  still be present in the player data. Unknown life states are not guessed dead.
- Float box/corner geometry avoids integer-pixel stepping. Bone pose arrays are
  prefetched in a scatter batch rather than fetched individually per player.
- Smooth ESP motion uses timestamped camera/player interpolation. Default buffer
  25 ms, adjustable 0-60 ms. It is a visual delay, not movement prediction. Disable
  Smooth ESP motion for raw snapshots. Input continues to use fresh raw bones.
- Missing bones can reuse their last valid pose for up to 80 ms, moved with the
  current root. This expires independently for each bone. Missing actors, world
  changes, stale frames and teleports are not carried across. No smoothness
  guarantee is possible when live DMA updates stall; verify inside a match.

NEW FEATURES
- Automatic save after changes (300 ms debounce, about 1 second while editing),
  plus save on exit. Atomic replacement preserves the last good file if saving
  fails. The menu displays save status.
- Wardogs.ini beside the EXE stores settings, hotkeys, selected pages, map points
  and radar/debug position; Wardogs-layout.ini stores window layout. Keep both
  files when upgrading to retain preferences. Neither is bundled over your files.
- Player display range: 1 to 10,000 metres. Independent indicator range defaults
  to 50 metres. Vehicle display range is separate. Ctrl+click a slider to type.
- ESP master switch gates player, vehicle and indicator drawings.
- Team check uses faction identifiers and the full squad GUID. When enabled,
  friendly and unknown-team PLAYERS are hidden from ESP, radar and maps.
  Unknown-team VEHICLES remain yellow / marked '?' because they may be unoccupied.
- Skeleton supports reference name layouts, partial limbs and the supplied
  refactored bone indices with bounded, validated component-space transforms.
- Weapon labels use the held item, falling back to the active item class.
- Vehicle discovery scans level actors in bounded batches; new vehicles may take
  several seconds to appear. Their positions refresh with each snapshot.
- 2D Radar: distance/size, heading-up, names and vehicles. Drag its title while the
  menu is open; it is click-through with the menu hidden.
- Maps / Artillery: offline Bakurani, Ozeti and Zestafona images; pan/zoom;
  locations, players and vehicles; saved artillery/target points; L81 Mortar
  and SPH-2 game table solutions, distance and azimuth. Select the actual map.
  Wheel zooms, right drag pans; Set artillery / Set target places points.
  Map coordinate units are 100 m. The game calculator interpolates only within
  supplied supported tables; terrain elevation and platform tilt are excluded.

DEFAULT HOTKEYS (rebind in Hotkeys; processed on the computer running the UI)
Home: show/hide menu
~: combat mode (skeleton/name/distance)   F1: corpses        F2: weapon name+icon
F3: vehicles                        F4: ground items   F5: mortar / SPH-2
F6: ESP    F7: radar    F8: skeleton    F9: indicators    F10: aim toggle
F12: player names    mouse4: magic bullet    mouse5: helicopter cannon
F11: hide/restore all overlay drawings and pause aim input
End: save and exit
Escape cancels key assignment; duplicate assignments are rejected.
Aim movement is paused while the menu is open so map interaction does not aim.

BUILD / EDIT
Requires Visual Studio 2022 C++ Build Tools (v143), Windows SDK and C++ workload.
Open Wardogs.sln, Release | x64, or:
  powershell -ExecutionPolicy Bypass -File .\build.ps1
Output: bin\x64\Wardogs\Wardogs.exe
COD.sln is a compatible entry point for the same converted project.
Map assets are copied beside the EXE automatically by the project.
Regenerate map data from supplied JSON: python generate-map-assets.py
Refresh offline mosaics (Python + Pillow + internet):
  python generate-map-assets.py --download
Package full source with hash verification: python package-source.py

VERIFICATION
  powershell -ExecutionPolicy Bypass -File .\test.ps1
Synthetic tests cover projection, health, names, class filtering, bones,
partial reads, faction/squad checks, controller fallback, weapons and vehicles.
Other tests cover radar/math, all map transforms, game table interpolation,
range rejection, restart persistence, autosave and failed atomic save recovery.
  bin\x64\Wardogs\Wardogs.exe --check-runtime
Checks native DLL loading without opening DMA hardware.
  bin\x64\Wardogs\Wardogs.exe --ui-test
Renders all seven pages and three maps into ui-test-output PNGs through a hidden
D3D11 window, without DMA, elevation or changing your saved settings.

LIMITS / DIAGNOSTICS
The user confirmed the previous runtime works; new live features still need an
in-match check with the matching game build and DMA device. Automated tests do
not validate live offsets or hardware throughput. Increasing range cannot reveal
entities the game has not replicated. Settings shows snapshot status, skeleton
and vehicle counts, and unknown-team counts.
No authoritative visibility field is available in the supplied reference;
Visible Check remains off by default. Enabling it blocks targeting.
Unreadable/stale snapshots and unsupported bone poses are not drawn.
Addresses and class indices are specific to the supplied dump version.

SOURCES
reference/wardogs: original supplied C# reference and MIT license.
reference/sdk-dump and reference/some-offsets.txt: additional user inputs.
assets/maps/SOURCES.txt: map tile source and regeneration details.
dependencies/FTDI-SOURCE.txt: native DLL provenance and hashes.
Wardogs-status-full-source.zip includes source, references, tests, assets,
build scripts and the ready runtime. Old ZIPs remain unchanged.

INDICATOR DISTANCE LABEL
The indicator arrow now shows the player's distance above it, rounded to whole
metres (for example 40m). Both arrow and label use the configured indicator range,
color and opacity. The label does not depend on the box Distance option.

PLAYER / VEHICLE STATUS (2026-09-18)
ESP: Show downed players, Downed label / color, Stance labels, Observed riders.
All controls and the downed color are autosaved. Downed visibility applies to
ESP, radar and map, independently of dead-player visibility. The status label
and box/skeleton/radar/map color identify downed players.
Stances use named animation flags (Standing / Crouched / Prone); ambiguous,
unreadable or unsupported instances show no stance. This is animation state,
not a guarantee of authoritative server stance. Dead actors have no stance label.
Riders are positively matched through replicated seat references. Counts cover
observed characters only and can be incomplete. Zero matches is shown as unknown,
never as an empty vehicle. Unsupported vehicle types remain unknown.
Extra details use an oldest-first budget of eight actors per capture, at most
10 updates/second per actor. Cached detail values expire after 500 ms and reset
on actor identity/world changes. Disabling the consumers disables these reads.
Fuel and reload status are NOT implemented: the supplied dump has function/type
definitions, but no verified read path for the current values. They are shown
as unavailable in the UI. No offsets or numeric values are guessed.
Live status correctness and DMA cost still require an in-match check.

PERFORMANCE
Settings shows draw FPS, average/P95 frame time, reader work time and data age.
Reader target defaults to 120 Hz (adjustable 30-240, saved automatically).
Actual DMA throughput may be lower. Rendering uses Present(0,0) independently.
Visual history uses indexed immutable samples and interpolates outside its lock.
Autosave comparison runs at most every 50 ms; writes keep the existing debounce.
Run benchmark.ps1 for synthetic interpolation CPU timings, or:
  bin\x64\Wardogs\Wardogs.exe --benchmark
The latter exercises hidden-window ESP/radar drawing with synthetic players.
It does not measure in-match FPS, DMA or desktop composition. See PERFORMANCE.md.

