mirror of
https://github.com/brues-code/ClassicAPI.git
synced 2026-11-16 16:10:36 +00:00
GameTooltip:GetItem() resolved the CGItem and built the suffixed link via
Item::Link::FromCGItem, but returned the base ItemStats name beside it --
so name and link disagreed ("Iridium Chain" vs "[Iridium Chain of the
Owl]"). The old comment claimed the engine didn't expose the dressed name
as a separate string; it does, via the same builder the link uses.
Extract that builder into a shared Item::Link::NameFromCGItem helper
(next to FromCGItem, wrapping FUN_ITEM_BUILD_INSTANCE_NAME) and use it in
both GetItem and C_Item.GetItemName so the returned name matches the link
and modern behavior. Verified in-game: GetItem() now returns "Iridium
Chain of the Owl" alongside its matching link.
Left the base-name reads that are correct as-is: itemID-only paths (mail,
cursor-by-id, GetItemInfo, equipment-set missing items) have no instance,
and the by-name *matching* in IsEquippedItem / bag lookups compares
against a caller string (a separate semantics question).
124 lines
4.5 KiB
C++
124 lines
4.5 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.
|
|
//
|
|
// You should have received a copy of the GNU General Public License along with
|
|
// ClassicAPI. If not, see <https://www.gnu.org/licenses/>.
|
|
|
|
#include "Link.h"
|
|
|
|
#include "Game.h"
|
|
#include "Offsets.h"
|
|
#include "item/Location.h"
|
|
#include "item/QualityColor.h"
|
|
|
|
#include <cstdint>
|
|
#include <cstdio>
|
|
|
|
namespace Item::Link {
|
|
|
|
namespace {
|
|
|
|
using BuildItemLink_t = const char *(__fastcall *)(const void *cgItem);
|
|
|
|
using BuildInstanceName_t = void(__thiscall *)(const void *cgItem, char *out,
|
|
unsigned outSize);
|
|
|
|
// Cached ItemStats record lookup. Same `_GetRecord` pattern the rest of
|
|
// the codebase uses; passes a noop NULL callback so no SMSG fires for
|
|
// uncached items — caller treats "not cached" as a clean failure.
|
|
using GetItemRecord_t = const uint8_t *(__thiscall *)(void *cache, uint32_t itemID,
|
|
const uint64_t *guid, void *callback,
|
|
void *userData, int dedupFlag);
|
|
|
|
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);
|
|
}
|
|
|
|
} // namespace
|
|
|
|
const char *FromCGItem(const uint8_t *cgItem) {
|
|
if (cgItem == nullptr)
|
|
return nullptr;
|
|
auto fn = reinterpret_cast<BuildItemLink_t>(Offsets::FUN_GAMETOOLTIP_BUILD_ITEM_LINK);
|
|
return fn(cgItem);
|
|
}
|
|
|
|
bool NameFromCGItem(const uint8_t *cgItem, char *out, size_t outSize) {
|
|
if (cgItem == nullptr || out == nullptr || outSize == 0)
|
|
return false;
|
|
out[0] = '\0';
|
|
auto fn = reinterpret_cast<BuildInstanceName_t>(
|
|
Offsets::FUN_ITEM_BUILD_INSTANCE_NAME);
|
|
fn(cgItem, out, static_cast<unsigned>(outSize));
|
|
return out[0] != '\0';
|
|
}
|
|
|
|
bool BasicFromItemID(uint32_t itemID, char *out, size_t outSize) {
|
|
if (out == nullptr || outSize == 0)
|
|
return false;
|
|
const uint8_t *record = PeekItemRecord(itemID);
|
|
if (record == nullptr)
|
|
return false;
|
|
const char *name = *reinterpret_cast<const char *const *>(
|
|
record + Offsets::OFF_ITEMSTATS_NAME);
|
|
if (name == nullptr || *name == '\0')
|
|
return false;
|
|
const uint32_t quality = *reinterpret_cast<const uint32_t *>(
|
|
record + Offsets::OFF_ITEMSTATS_QUALITY);
|
|
const int n = std::snprintf(out, outSize,
|
|
"%s|Hitem:%u:0:0:0|h[%s]|h|r",
|
|
Item::QualityColor::Prefix(static_cast<int>(quality)),
|
|
itemID, name);
|
|
return n > 0 && static_cast<size_t>(n) < outSize;
|
|
}
|
|
|
|
namespace {
|
|
|
|
// `C_Item.GetItemLink(itemLocation)` — returns the fully-decorated
|
|
// per-instance hyperlink for the item at the location, matching what
|
|
// `GetContainerItemLink(bag, slot)` or `GetInventoryItemLink("player",
|
|
// slot)` would return for the same slot. Enchant ID, random-suffix,
|
|
// and any other per-instance data the server attached to the CGItem
|
|
// are preserved.
|
|
//
|
|
// Accepts table form (`{equipmentSlotIndex=N}` or `{bagID=B,
|
|
// slotIndex=S}`) and GUID string form (the value
|
|
// `C_Item.GetItemGUID` returns). `Item::Location::Resolve` handles
|
|
// all three input shapes and returns a CGItem pointer for whichever
|
|
// matches; we forward that to `FromCGItem`, which calls the engine's
|
|
// own link builder. No Lua-stack-stomping, no engine Script dispatch.
|
|
int __fastcall Script_C_Item_GetItemLink(void *L) {
|
|
if (!Item::Location::IsLocationArg(L, 1)) {
|
|
Game::Lua::Error(L, "Usage: C_Item.GetItemLink(itemLocation)");
|
|
return 0;
|
|
}
|
|
|
|
const uint8_t *cgItem = Item::Location::Resolve(L, 1);
|
|
const char *link = FromCGItem(cgItem);
|
|
if (link == nullptr || *link == '\0')
|
|
return 0;
|
|
|
|
Game::Lua::PushString(L, link);
|
|
return 1;
|
|
}
|
|
|
|
void RegisterLuaFunctions() {
|
|
Game::Lua::RegisterTableFunction("C_Item", "GetItemLink", &Script_C_Item_GetItemLink);
|
|
}
|
|
|
|
const Game::ModuleAutoRegister _autoreg{&RegisterLuaFunctions};
|
|
|
|
} // namespace
|
|
|
|
} // namespace Item::Link
|