// This file is part of ClassicAPI. // // ClassicAPI is free software: you can redistribute it and/or modify it under the terms // of the GNU Lesser General Public License as published by the Free Software Foundation, either // version 3 of the License, or (at your option) any later version. // // ClassicAPI is distributed in the hope that it will be useful, but WITHOUT ANY // WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR // PURPOSE. See the GNU Lesser General Public License for more details. // // You should have received a copy of the GNU Lesser General Public License along with // ClassicAPI. If not, see . #include "Game.h" #include "Offsets.h" #include #include namespace Unit::Identity { using ResolveUnitToken_t = void *(__fastcall *)(const char *token); // `UnitGUID(unit)` — returns the unit's 64-bit GUID formatted as a // hex string `"0xHHHHHHHHLLLLLLLL"` (16 hex digits, hi dword first). // // 1.12 GUIDs are plain 64-bit integers — no type-prefix system like // modern WoW's `"Player-1234-..."` / `"Creature-0-..."` shapes. Vanilla // addons that tracked units across events used this `"0x..."` format, // and 3.3.5's `Script_UnitGUID` (at `0x0060E630` in the Frostmourne // client) emits the same shape after a much longer code path that // special-cases sentinel GUID values introduced post-2.x. // // Returns `nil` if: // - the unit token is invalid / not currently resolvable // - the resolved unit's GUID slot is NULL or both halves are zero // (matches 3.3.5's all-zero → nil at `0x0060E68C`). static int __fastcall Script_UnitGUID(void *L) { if (!Game::Lua::IsString(L, 1)) { Game::Lua::Error(L, "Usage: UnitGUID(\"unit\")"); return 0; } const char *token = Game::Lua::ToString(L, 1); if (token == nullptr) return 0; auto resolve = reinterpret_cast(Offsets::FUN_RESOLVE_UNIT_TOKEN); auto *unit = static_cast(resolve(token)); if (unit == nullptr) return 0; auto *guidPtr = *reinterpret_cast( unit + Offsets::OFF_UNIT_GUID_PTR); if (guidPtr == nullptr) return 0; const uint32_t lo = *reinterpret_cast(guidPtr + 0); const uint32_t hi = *reinterpret_cast(guidPtr + 4); if (lo == 0 && hi == 0) return 0; char buf[24]; // "0x" + 16 hex digits + null = 19 bytes minimum std::snprintf(buf, sizeof(buf), "0x%08X%08X", hi, lo); Game::Lua::PushString(L, buf); return 1; } static void RegisterLuaFunctions() { Game::Lua::RegisterGlobalFunction("UnitGUID", &Script_UnitGUID); } static const Game::ModuleAutoRegister _autoreg{&RegisterLuaFunctions}; } // namespace Unit::Identity