mirror of
https://github.com/brues-code/ClassicAPI.git
synced 2026-11-16 16:10:36 +00:00
The repo was internally inconsistent: the LICENSE file is GPL v3 but every src/ header carried the LGPL v3 notice and the README said "LGPL v3 or later". LGPL was also the wrong fit — this is an injected mod plus a bundled addon, not a library other code links against, so LGPL's linking exception buys nothing. It's also required: src/voicechat/Tts.cpp is ported from awesome_wotlk's VoiceChat.cpp, which is GPL v3, and a derivative of GPL code cannot be relicensed under more permissive terms. Dependencies stay compatible — MinHook (BSD-2) and the nampower-mirrored packet shapes (BSD) are GPL-compatible, and SAPI is covered by the system-library exception. Swept "GNU Lesser General Public License" -> "GNU General Public License" across all 257 src/ headers and changed the README license line to match the GPL v3 LICENSE file. Comment-only; no build impact.
110 lines
3.9 KiB
C++
110 lines
3.9 KiB
C++
// This file is part of ClassicAPI.
|
|
//
|
|
// ClassicAPI is free software: you can redistribute it and/or modify it under the terms
|
|
// of the GNU 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 General Public License for more details.
|
|
|
|
#include "Game.h"
|
|
#include "Offsets.h"
|
|
#include "dbc/Lookup.h"
|
|
#include "unit/Identity.h"
|
|
|
|
#include <cstdint>
|
|
|
|
namespace Unit::RaceBase {
|
|
|
|
namespace {
|
|
|
|
using ResolveUnitToken_t = void *(__fastcall *)(const char *token);
|
|
|
|
// `UnitRaceBase(unit) → (raceFile, raceID)` — returns the locale-
|
|
// independent race token (`"Human"`, `"Orc"`, `"Dwarf"`, `"NightElf"`,
|
|
// `"Scourge"`, `"Tauren"`, `"Gnome"`, `"Troll"`) plus the numeric
|
|
// raceID (1..8 in vanilla), or `(nil, nil)` if the unit can't be
|
|
// resolved.
|
|
//
|
|
// Sibling to `UnitClassBase` — same descriptor-byte + DBC.Filename
|
|
// chain, just reading `UNIT_FIELD_BYTES_0` byte 0 (race) instead of
|
|
// byte 1 (class) and looking up `ChrRaces.dbc::Filename` at `+0x3C`
|
|
// (locale-independent string, distinct from the localized `Name[9]`
|
|
// at `+0x44` that `UnitRace` already returns).
|
|
//
|
|
// Race byte is broadcast in UpdateField data, so this works for any
|
|
// synced unit token (player, target, party / raid, mouseover,
|
|
// inspect targets — anything FUN_RESOLVE_UNIT_TOKEN handles).
|
|
//
|
|
// Returns `(nil, nil)` for unresolvable units (empty target /
|
|
// party slot, unloaded descriptor), unit-byte 0 (uninitialized /
|
|
// NPC), or out-of-range race bytes (no matching ChrRaces.dbc row).
|
|
int __fastcall Script_UnitRaceBase(void *L) {
|
|
if (!Game::Lua::IsString(L, 1)) {
|
|
Game::Lua::Error(L, "Usage: UnitRaceBase(\"unit\")");
|
|
return 0;
|
|
}
|
|
const char *token = Game::Lua::ToString(L, 1);
|
|
if (token == nullptr) {
|
|
Game::Lua::PushNil(L);
|
|
Game::Lua::PushNil(L);
|
|
return 2;
|
|
}
|
|
|
|
// Mirror Script_UnitRace: the literal "player" token reads the
|
|
// login-time race byte global (populated at character-enter, before
|
|
// the in-world descriptor exists), so this resolves at addon-load
|
|
// instead of returning nil until the player object spawns. All other
|
|
// tokens go through the unit descriptor.
|
|
uint8_t raceByte;
|
|
if (Unit::Identity::IsPlayerToken(token)) {
|
|
raceByte = *reinterpret_cast<const uint8_t *>(Offsets::VAR_PLAYER_RACE_BYTE);
|
|
} else {
|
|
auto resolve = reinterpret_cast<ResolveUnitToken_t>(Offsets::FUN_RESOLVE_UNIT_TOKEN);
|
|
auto *unit = static_cast<const uint8_t *>(resolve(token));
|
|
if (unit == nullptr) {
|
|
Game::Lua::PushNil(L);
|
|
Game::Lua::PushNil(L);
|
|
return 2;
|
|
}
|
|
auto *desc = *reinterpret_cast<const uint8_t *const *>(
|
|
unit + Offsets::OFF_UNIT_DESCRIPTOR);
|
|
if (desc == nullptr) {
|
|
Game::Lua::PushNil(L);
|
|
Game::Lua::PushNil(L);
|
|
return 2;
|
|
}
|
|
raceByte = *(desc + Offsets::OFF_UNIT_DESCRIPTOR_RACE_BYTE);
|
|
}
|
|
if (raceByte == 0) {
|
|
Game::Lua::PushNil(L);
|
|
Game::Lua::PushNil(L);
|
|
return 2;
|
|
}
|
|
|
|
const char *raceFile = DBC::StringField(
|
|
Offsets::VAR_CHRRACES_RECORDS,
|
|
Offsets::VAR_CHRRACES_COUNT,
|
|
raceByte,
|
|
Offsets::OFF_CHRRACES_FILENAME);
|
|
if (raceFile == nullptr) {
|
|
Game::Lua::PushNil(L);
|
|
Game::Lua::PushNil(L);
|
|
return 2;
|
|
}
|
|
Game::Lua::PushString(L, raceFile);
|
|
Game::Lua::PushNumber(L, static_cast<double>(raceByte));
|
|
return 2;
|
|
}
|
|
|
|
void RegisterLuaFunctions() {
|
|
Game::Lua::RegisterGlobalFunction("UnitRaceBase", &Script_UnitRaceBase);
|
|
}
|
|
|
|
const Game::ModuleAutoRegister _autoreg{&RegisterLuaFunctions};
|
|
|
|
} // namespace
|
|
|
|
} // namespace Unit::RaceBase
|