Consolidate shared game offsets and accessor functions
Extract duplicated WoW 1.12.1 addresses and game accessor functions into shared modules (src/offsets.zig, src/wow.zig), replacing 5+ copies of getObjectByGUID, isInBattleground, isValidPtr, etc. - src/offsets.zig: shared address constants (object manager, descriptor fields, map/zone, core function addresses, D3D9/GX) - src/wow.zig: shared accessor functions (pointer validation, object manager traversal, field reads, unit helpers, battleground detection, game function wrappers, raid target cache) - Update 10 modules to import from shared instead of inline constants - Remove outline/wow.zig (promoted to src/wow.zig) - Trim outline/offsets.zig and markers/offsets.zig to module-specific only
This commit is contained in:
MarcelineVQ
+276
@@ -0,0 +1,276 @@
|
||||
//! Shared game memory access wrappers for WoW 1.12.1.
|
||||
//!
|
||||
//! Provides safe read helpers for the object manager, unit descriptors,
|
||||
//! corpse fields, raid targets, map queries, and calling-convention
|
||||
//! wrappers for game functions.
|
||||
|
||||
const std = @import("std");
|
||||
const hook = @import("zhook");
|
||||
const o = @import("offsets.zig");
|
||||
|
||||
// Re-export ObjectType so consumers can use wow.ObjectType
|
||||
pub const ObjectType = enum(u32) {
|
||||
null_obj = 0,
|
||||
item = 1,
|
||||
container = 2,
|
||||
unit = 3,
|
||||
player = 4,
|
||||
game_object = 5,
|
||||
dynamic_object = 6,
|
||||
corpse = 7,
|
||||
_,
|
||||
};
|
||||
|
||||
pub const Vec3 = struct {
|
||||
x: f32,
|
||||
y: f32,
|
||||
z: f32,
|
||||
};
|
||||
|
||||
// =============================================================================
|
||||
// Pointer validation
|
||||
// =============================================================================
|
||||
|
||||
const WINAPI = std.builtin.CallingConvention.winapi;
|
||||
|
||||
extern "kernel32" fn IsBadReadPtr(
|
||||
lp: ?*const anyopaque,
|
||||
ucb: usize,
|
||||
) callconv(WINAPI) i32;
|
||||
|
||||
/// Quick sanity check — reject null, low-address, and kernel-space pointers.
|
||||
pub fn isValidPtr(addr: u32) bool {
|
||||
return addr >= 0x10000 and addr < 0x7F000000;
|
||||
}
|
||||
|
||||
/// Page-level read check via Windows API.
|
||||
pub fn isReadablePtr(addr: u32, size: usize) bool {
|
||||
if (addr < 0x10000 or addr >= 0x7F000000) return false;
|
||||
return IsBadReadPtr(@ptrFromInt(addr), size) == 0;
|
||||
}
|
||||
|
||||
// =============================================================================
|
||||
// Object manager traversal
|
||||
// =============================================================================
|
||||
|
||||
pub fn isInGame() bool {
|
||||
return hook.readMem(u32, o.IS_IN_WORLD) != 0;
|
||||
}
|
||||
|
||||
pub fn objectFirst() u32 {
|
||||
const obj_mgr = hook.readMem(u32, o.OBJECT_MANAGER_PTR);
|
||||
if (obj_mgr == 0) return 0;
|
||||
return hook.readMem(u32, obj_mgr + o.OBJECT_LIST_OFFSET);
|
||||
}
|
||||
|
||||
pub fn objectNext(current: u32) u32 {
|
||||
if (current == 0 or (current & 1) != 0) return 0;
|
||||
const obj_mgr = hook.readMem(u32, o.OBJECT_MANAGER_PTR);
|
||||
if (obj_mgr == 0) return 0;
|
||||
const base = hook.readMem(u32, obj_mgr + o.OBJECT_NEXT_OFFSET);
|
||||
const next = hook.readMem(u32, base + current + 4);
|
||||
if (next == 0 or (next & 1) != 0) return 0;
|
||||
return next;
|
||||
}
|
||||
|
||||
// =============================================================================
|
||||
// Object field reads
|
||||
// =============================================================================
|
||||
|
||||
pub fn getObjectType(obj: u32) ObjectType {
|
||||
if (!isValidPtr(obj)) return .null_obj;
|
||||
return @enumFromInt(hook.readMem(u32, obj + o.OBJECT_TYPE_OFFSET));
|
||||
}
|
||||
|
||||
pub fn getObjectTypeRaw(obj: u32) u32 {
|
||||
if (!isValidPtr(obj)) return 0;
|
||||
return hook.readMem(u32, obj + o.OBJECT_TYPE_OFFSET);
|
||||
}
|
||||
|
||||
pub fn readGUID(addr: u32) u64 {
|
||||
const lo = hook.readMem(u32, addr);
|
||||
const hi = hook.readMem(u32, addr + 4);
|
||||
return (@as(u64, hi) << 32) | lo;
|
||||
}
|
||||
|
||||
pub fn getObjectGUID(obj: u32) u64 {
|
||||
if (!isValidPtr(obj)) return 0;
|
||||
return readGUID(obj + o.OBJECT_GUID_OFFSET);
|
||||
}
|
||||
|
||||
/// Read the descriptor/m_data pointer (at obj + 0x08).
|
||||
pub fn getDescriptor(obj: u32) u32 {
|
||||
if (!isValidPtr(obj)) return 0;
|
||||
return hook.readMem(u32, obj + o.OBJECT_DATA_OFFSET);
|
||||
}
|
||||
|
||||
/// Read the unit descriptor pointer (at obj + 0x110).
|
||||
pub fn getUnitDescriptor(obj: u32) u32 {
|
||||
if (!isValidPtr(obj)) return 0;
|
||||
return hook.readMem(u32, obj + o.UNIT_DESCRIPTOR_OFFSET);
|
||||
}
|
||||
|
||||
pub fn getObjectEntry(obj: u32) u32 {
|
||||
const desc = getDescriptor(obj);
|
||||
if (!isValidPtr(desc)) return 0;
|
||||
return hook.readMem(u32, desc + o.DESC_ENTRY);
|
||||
}
|
||||
|
||||
pub fn getNpcFlags(obj: u32) u32 {
|
||||
const desc = getDescriptor(obj);
|
||||
if (!isValidPtr(desc)) return 0;
|
||||
return hook.readMem(u32, desc + o.DESC_NPC_FLAGS);
|
||||
}
|
||||
|
||||
// =============================================================================
|
||||
// Unit helpers
|
||||
// =============================================================================
|
||||
|
||||
pub fn isUnitDead(unit: u32) bool {
|
||||
if (!isValidPtr(unit)) return false;
|
||||
const desc = hook.readMem(u32, unit + o.UNIT_DESCRIPTOR_OFFSET);
|
||||
if (!isValidPtr(desc)) return false;
|
||||
const flags = hook.readMem(u32, desc + o.UNIT_FLAGS_OFFSET);
|
||||
return (flags & o.UNIT_FLAG_DEAD) != 0;
|
||||
}
|
||||
|
||||
pub fn getUnitPosition(unit: u32) Vec3 {
|
||||
if (unit == 0) return .{ .x = 0, .y = 0, .z = 0 };
|
||||
const movement = hook.readMem(u32, unit + o.UNIT_MOVEMENT_OFFSET);
|
||||
if (movement == 0 or movement < 0x10000) return .{ .x = 0, .y = 0, .z = 0 };
|
||||
return .{
|
||||
.x = hook.readMem(f32, movement + o.MOVEMENT_POS_X),
|
||||
.y = hook.readMem(f32, movement + o.MOVEMENT_POS_Y),
|
||||
.z = hook.readMem(f32, movement + o.MOVEMENT_POS_Z),
|
||||
};
|
||||
}
|
||||
|
||||
// =============================================================================
|
||||
// Corpse helpers
|
||||
// =============================================================================
|
||||
|
||||
pub fn isSkeletonCorpse(obj: u32) bool {
|
||||
if (!isValidPtr(obj)) return false;
|
||||
const desc = hook.readMem(u32, obj + o.OBJECT_DATA_OFFSET);
|
||||
if (!isValidPtr(desc)) return false;
|
||||
const flags = hook.readMem(u32, desc + o.CORPSE_FIELD_FLAGS);
|
||||
return (flags & o.CORPSE_FLAG_BONE) != 0;
|
||||
}
|
||||
|
||||
pub fn getCorpseOwnerGUID(obj: u32) u64 {
|
||||
if (!isValidPtr(obj)) return 0;
|
||||
const desc = hook.readMem(u32, obj + o.OBJECT_DATA_OFFSET);
|
||||
if (!isValidPtr(desc)) return 0;
|
||||
return readGUID(desc + o.CORPSE_FIELD_OWNER);
|
||||
}
|
||||
|
||||
// =============================================================================
|
||||
// Map / Battleground detection
|
||||
// =============================================================================
|
||||
|
||||
/// Check if the current map is a battleground by reading Map.dbc mapType.
|
||||
pub fn isInBattleground() bool {
|
||||
const obj_mgr = hook.readMem(u32, o.OBJECT_MANAGER_PTR);
|
||||
if (obj_mgr == 0) return false;
|
||||
const map_id = hook.readMem(u32, obj_mgr + o.OBJMGR_MAP_ID_OFFSET);
|
||||
const dbc_max = hook.readMem(u32, o.MAP_DBC_MAX);
|
||||
if (map_id > dbc_max) return false;
|
||||
const table_base = hook.readMem(u32, o.MAP_DBC_DATA);
|
||||
if (table_base == 0) return false;
|
||||
const row = hook.readMem(u32, table_base + map_id * 4);
|
||||
if (row == 0) return false;
|
||||
const map_type = hook.readMem(u32, row + o.MAP_DBC_MAP_TYPE_OFFSET);
|
||||
return map_type == o.MAP_TYPE_BATTLEGROUND;
|
||||
}
|
||||
|
||||
// =============================================================================
|
||||
// Game function wrappers
|
||||
// =============================================================================
|
||||
|
||||
/// UnitGUID("player") / UnitGUID("target") → 64-bit GUID.
|
||||
pub fn unitGUID(unit_id: [*:0]const u8) u64 {
|
||||
return hook.call(fn ([*:0]const u8) callconv(hook.cc.fastcall) u64, o.FN_UNIT_GUID, .{unit_id});
|
||||
}
|
||||
|
||||
/// Resolve a GUID → object pointer via the object manager hash table.
|
||||
pub fn getObjectByGUID(guid: u64) u32 {
|
||||
if (guid == 0) return 0;
|
||||
const lo: u32 = @truncate(guid);
|
||||
const hi: u32 = @truncate(guid >> 32);
|
||||
return hook.call(fn (u32, u32) callconv(hook.cc.stdcall) u32, o.FN_GET_OBJECT_BY_GUID, .{ lo, hi });
|
||||
}
|
||||
|
||||
/// Split-GUID variant for callers that already have lo/hi parts.
|
||||
pub fn getObjectByGUIDSplit(guid_lo: u32, guid_hi: u32) u32 {
|
||||
if (guid_lo == 0 and guid_hi == 0) return 0;
|
||||
return hook.call(fn (u32, u32) callconv(hook.cc.stdcall) u32, o.FN_GET_OBJECT_BY_GUID, .{ guid_lo, guid_hi });
|
||||
}
|
||||
|
||||
/// ClntObjMgrGetActivePlayer → local player GUID.
|
||||
pub fn getPlayerGUID() u64 {
|
||||
return hook.call(fn () callconv(hook.cc.fastcall) u64, o.FN_GET_PLAYER_GUID, .{});
|
||||
}
|
||||
|
||||
/// Get the local player's object pointer.
|
||||
pub fn getLocalPlayer() u32 {
|
||||
const guid = unitGUID("player");
|
||||
if (guid == 0) return 0;
|
||||
return getObjectByGUID(guid);
|
||||
}
|
||||
|
||||
/// Get the current target's GUID.
|
||||
pub fn getTargetGUID() u64 {
|
||||
return unitGUID("target");
|
||||
}
|
||||
|
||||
/// Check if a unit is friendly to the local player.
|
||||
pub fn isUnitFriendly(unit: u32, local_player: u32) bool {
|
||||
if (unit == 0 or local_player == 0) return false;
|
||||
const reaction = hook.call(fn (u32, u32) callconv(hook.cc.thiscall) i32, o.FN_UNIT_REACTION, .{ local_player, unit });
|
||||
return reaction >= 4;
|
||||
}
|
||||
|
||||
// =============================================================================
|
||||
// Model owner resolution
|
||||
// =============================================================================
|
||||
|
||||
const MODEL_OWNER_DIRECT: usize = 0x28;
|
||||
const MODEL_OWNER_CALLBACK: usize = 0x3C0;
|
||||
|
||||
pub fn resolveModelOwner(model: u32) u32 {
|
||||
if (!isReadablePtr(model, MODEL_OWNER_CALLBACK + 4)) return 0;
|
||||
|
||||
const candidate_cb = hook.readMem(u32, model + MODEL_OWNER_CALLBACK);
|
||||
if (candidate_cb != 0 and isReadablePtr(candidate_cb, 0x40)) {
|
||||
const guid_lo = hook.readMem(u32, candidate_cb + o.OBJECT_GUID_OFFSET);
|
||||
if (guid_lo != 0 and guid_lo < 0x10000000) return candidate_cb;
|
||||
}
|
||||
|
||||
const candidate_dir = hook.readMem(u32, model + MODEL_OWNER_DIRECT);
|
||||
if (candidate_dir != 0 and isReadablePtr(candidate_dir, 0x40)) {
|
||||
const guid_lo = hook.readMem(u32, candidate_dir + o.OBJECT_GUID_OFFSET);
|
||||
if (guid_lo != 0 and guid_lo < 0x10000000) return candidate_dir;
|
||||
}
|
||||
|
||||
return 0;
|
||||
}
|
||||
|
||||
// =============================================================================
|
||||
// Raid target cache
|
||||
// =============================================================================
|
||||
|
||||
var cached_raid_targets: [8]u64 = .{0} ** 8;
|
||||
|
||||
pub fn cacheRaidTargets() void {
|
||||
for (0..8) |i| {
|
||||
cached_raid_targets[i] = readGUID(@intCast(o.RAID_TARGET_ARRAY + i * 8));
|
||||
}
|
||||
}
|
||||
|
||||
pub fn getRaidMarkForGUID(guid: u64) u8 {
|
||||
if (guid == 0) return 0;
|
||||
for (cached_raid_targets, 0..) |rt, i| {
|
||||
if (rt == guid) return @intCast(i + 1);
|
||||
}
|
||||
return 0;
|
||||
}
|
||||
Reference in New Issue
Block a user