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.
184 lines
7.4 KiB
C++
184 lines
7.4 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.
|
|
|
|
// `C_Item.GetItemSetID(itemLocation)` /
|
|
// `C_Item.GetItemSetIDByID(itemInfo)` /
|
|
// `C_Item.GetItemSetInfo(setID)` — modern set-membership and set-
|
|
// info accessors. The first two surface the 16th return of modern
|
|
// retail's `GetItemInfo` (the item's setID, or nil for non-set items);
|
|
// the third reads `ItemSet.dbc` to describe the set itself.
|
|
//
|
|
// Vanilla 1.12 ships `GetItemSetInfo(setID)` but exposes no way to
|
|
// ask "what set does this item belong to" without scanning every
|
|
// set's `ItemID[17]` array. The `ItemStats_C` cache has it
|
|
// (`m_itemSet` at `+0x1C0`); we read it directly.
|
|
|
|
#include "Game.h"
|
|
#include "Offsets.h"
|
|
#include "dbc/Lookup.h"
|
|
#include "item/Arg.h"
|
|
#include "item/Data.h"
|
|
#include "item/ID.h"
|
|
#include "item/Location.h"
|
|
|
|
#include <cstdint>
|
|
|
|
namespace Item::Set {
|
|
|
|
namespace {
|
|
|
|
using GetItemRecord_t = const uint8_t *(__thiscall *)(void *cache, uint32_t itemID,
|
|
const uint64_t *guid, void *callback,
|
|
void *userData, int unused);
|
|
|
|
const uint8_t *PeekItemRecord(uint32_t itemID) {
|
|
auto fn = reinterpret_cast<GetItemRecord_t>(Offsets::FUN_DBCACHE_ITEMSTATS_GET_RECORD);
|
|
auto *cache = reinterpret_cast<void *>(Offsets::VAR_ITEMDB_CACHE);
|
|
const uint64_t zeroGuid = 0;
|
|
return fn(cache, itemID, &zeroGuid, nullptr, nullptr, 0);
|
|
}
|
|
|
|
int PushSetIDForItemID(void *L, int itemID) {
|
|
if (itemID <= 0)
|
|
return 0;
|
|
const uint8_t *record = PeekItemRecord(static_cast<uint32_t>(itemID));
|
|
if (record == nullptr) {
|
|
Item::Data::WarmCache(static_cast<uint32_t>(itemID));
|
|
return 0;
|
|
}
|
|
const uint32_t setID = *reinterpret_cast<const uint32_t *>(
|
|
record + Offsets::OFF_ITEMSTATS_ITEM_SET);
|
|
if (setID == 0)
|
|
return 0; // item isn't part of a set
|
|
Game::Lua::PushNumber(L, static_cast<double>(setID));
|
|
return 1;
|
|
}
|
|
|
|
// Reads the locale-clamped name from an ItemSet.dbc record. ItemSet
|
|
// has only 8 locale slots (vs Spell.dbc's 9), so clamp the global
|
|
// locale index before indexing.
|
|
const char *ReadSetName(const uint8_t *record) {
|
|
int locale = *reinterpret_cast<const int *>(
|
|
static_cast<uintptr_t>(Offsets::VAR_LOCALE_INDEX));
|
|
if (locale < 0 || locale >= Offsets::ITEMSET_LOCALE_COUNT)
|
|
locale = 0;
|
|
auto *names = reinterpret_cast<const char *const *>(
|
|
record + Offsets::OFF_ITEMSET_NAMES);
|
|
return names[locale];
|
|
}
|
|
|
|
} // namespace
|
|
|
|
// `C_Item.GetItemSetID(itemLocation)` — returns the `ItemSet.dbc` ID
|
|
// the item at `itemLocation` belongs to, or nil if it's not part of
|
|
// a set, the slot is empty, or the item isn't in the engine's cache.
|
|
static int __fastcall Script_C_Item_GetItemSetID(void *L) {
|
|
if (!Item::Location::IsLocationArg(L, 1)) {
|
|
Game::Lua::Error(L, "Usage: C_Item.GetItemSetID(itemLocation)");
|
|
return 0;
|
|
}
|
|
return PushSetIDForItemID(L, Item::ID::FromCGItem(Item::Location::Resolve(L, 1)));
|
|
}
|
|
|
|
// `C_Item.GetItemSetIDByID(itemInfo)` — same as above but takes an
|
|
// itemID / `"item:NNN..."` link / numeric-string directly. Returns nil
|
|
// for uncached items and warms the engine's item cache so a follow-up
|
|
// call after `GET_ITEM_INFO_RECEIVED` resolves.
|
|
static int __fastcall Script_C_Item_GetItemSetIDByID(void *L) {
|
|
return PushSetIDForItemID(L, Item::Arg::ResolveItemID(L, 1));
|
|
}
|
|
|
|
// `C_Item.GetItemSetInfo(setID)` — returns a table describing the
|
|
// ItemSet.dbc row, or nil if `setID` doesn't resolve.
|
|
//
|
|
// setID number, echo of input
|
|
// name string, localized set name
|
|
// requiredSkill number, skill line ID (0 if none)
|
|
// requiredSkillRank number (0 if none)
|
|
// items array of itemIDs in the set (empty slots filtered)
|
|
// bonuses array of `{ spellID = N, threshold = M }`
|
|
// tables, one per non-empty bonus slot
|
|
static int __fastcall Script_C_Item_GetItemSetInfo(void *L) {
|
|
if (!Game::Lua::IsNumber(L, 1))
|
|
return 0;
|
|
const int setID = static_cast<int>(Game::Lua::ToNumber(L, 1));
|
|
if (setID <= 0)
|
|
return 0;
|
|
const uint8_t *record = DBC::Record(Offsets::VAR_ITEMSET_RECORDS,
|
|
Offsets::VAR_ITEMSET_COUNT,
|
|
static_cast<uint32_t>(setID));
|
|
if (record == nullptr)
|
|
return 0;
|
|
|
|
Game::Lua::SetTop(L, 0);
|
|
Game::Lua::NewTable(L);
|
|
Game::Lua::SetFieldNumber(L, "setID", static_cast<double>(setID));
|
|
|
|
const char *name = ReadSetName(record);
|
|
Game::Lua::SetFieldString(L, "name", (name != nullptr) ? name : "");
|
|
|
|
Game::Lua::SetFieldNumber(L, "requiredSkill", static_cast<double>(
|
|
*reinterpret_cast<const uint32_t *>(
|
|
record + Offsets::OFF_ITEMSET_REQUIRED_SKILL)));
|
|
Game::Lua::SetFieldNumber(L, "requiredSkillRank", static_cast<double>(
|
|
*reinterpret_cast<const uint32_t *>(
|
|
record + Offsets::OFF_ITEMSET_REQUIRED_SKILL_RANK)));
|
|
|
|
// items: array of non-zero itemIDs (skip empty slots so callers
|
|
// can iterate via `ipairs` without holes).
|
|
Game::Lua::PushString(L, "items");
|
|
Game::Lua::NewTable(L);
|
|
auto *items = reinterpret_cast<const uint32_t *>(
|
|
record + Offsets::OFF_ITEMSET_ITEM_IDS);
|
|
int nextItemKey = 1;
|
|
for (int i = 0; i < Offsets::ITEMSET_MAX_ITEMS; ++i) {
|
|
if (items[i] == 0)
|
|
continue;
|
|
Game::Lua::PushNumber(L, static_cast<double>(nextItemKey++));
|
|
Game::Lua::PushNumber(L, static_cast<double>(items[i]));
|
|
Game::Lua::SetTable(L, -3);
|
|
}
|
|
Game::Lua::SetTable(L, -3); // outer["items"] = innerTable
|
|
|
|
// bonuses: array of {spellID, threshold} pairs.
|
|
Game::Lua::PushString(L, "bonuses");
|
|
Game::Lua::NewTable(L);
|
|
auto *spells = reinterpret_cast<const uint32_t *>(
|
|
record + Offsets::OFF_ITEMSET_SPELL_IDS);
|
|
auto *thresholds = reinterpret_cast<const uint32_t *>(
|
|
record + Offsets::OFF_ITEMSET_THRESHOLDS);
|
|
int nextBonusKey = 1;
|
|
for (int i = 0; i < Offsets::ITEMSET_MAX_BONUSES; ++i) {
|
|
if (spells[i] == 0)
|
|
continue;
|
|
Game::Lua::PushNumber(L, static_cast<double>(nextBonusKey++));
|
|
Game::Lua::NewTable(L);
|
|
Game::Lua::SetFieldNumber(L, "spellID", static_cast<double>(spells[i]));
|
|
Game::Lua::SetFieldNumber(L, "threshold", static_cast<double>(thresholds[i]));
|
|
Game::Lua::SetTable(L, -3); // bonuses[N] = {spellID, threshold}
|
|
}
|
|
Game::Lua::SetTable(L, -3); // outer["bonuses"] = innerTable
|
|
|
|
return 1;
|
|
}
|
|
|
|
static void RegisterLuaFunctions() {
|
|
Game::Lua::RegisterTableFunction("C_Item", "GetItemSetID",
|
|
&Script_C_Item_GetItemSetID);
|
|
Game::Lua::RegisterTableFunction("C_Item", "GetItemSetIDByID",
|
|
&Script_C_Item_GetItemSetIDByID);
|
|
Game::Lua::RegisterTableFunction("C_Item", "GetItemSetInfo",
|
|
&Script_C_Item_GetItemSetInfo);
|
|
}
|
|
|
|
static const Game::ModuleAutoRegister _autoreg{&RegisterLuaFunctions};
|
|
|
|
} // namespace Item::Set
|