mirror of
https://github.com/brues-code/ClassicAPI.git
synced 2026-11-16 16:10:36 +00:00
Adds the post-vanilla TargetScript selection functions 1.12.1 lacks: TargetDirectionEnemy(facing[,cone]) / TargetDirectionFriend TargetNearest([reverse]) TargetNearestEnemyPlayer([reverse]) / TargetNearestFriendPlayer GetPlayerFacing() All five targeting functions reuse the engine's own tab-target core: the visible-unit enumeration, the per-mode validity predicate FUN_00493e40 (reaction/attackability/alive, modes 1=enemy/2=friend), and the selection commit. The only new logic is a player-GUID filter for the *Player variants and the cone geometry for the direction variants. Cycle functions keep a frozen per-filter snapshot advanced within a ~1s window (no ping-pong). Target-setting routes through FUN_TARGET_BY_GUID (0x00489A40), which rejects a GUID that no longer resolves to a live unit rather than committing it — a stale snapshot GUID would otherwise leave "target" pointing at freed unit data and crash the next handler that reads it. GetPlayerFacing reads the CGUnit movement-block orientation at +0x9C4 (located by probing the player object across a known 180-degree turn); it's the facing source the direction-target functions need. Not backported (no vanilla equivalent): TargetPriorityHighlightStart/End, IsTargetLoose, TargetToggle. New offsets: FUN_TARGET_CANDIDATE_VALID (0x00493E40), FUN_SET_SELECTION_BY_GUID (0x00493540), VAR_CURRENT_SELECTION_GUID_LO/HI, OFF_UNIT_FACING (0x9C4).