用途:为《魔兽世界》正式服插件开发提供收藏类 API 参考,涵盖坐骑、宠物、宠物对战、玩具、猎人兽栏与传家宝。资料标注版本为 Patch 12.0.0(Build 65655),仅限正式服。
主要能力:C_MountJournal 提供坐骑列表、筛选、收藏、召唤与坐骑装备;C_PetJournal 管理宠物列表、筛选、排序、召唤、改名、笼装与放生;C_PetBattles 提供对战状态、宠物属性、技能使用、换宠、陷阱与投降;C_ToyBox/C_ToyBoxInfo 处理玩具列表、筛选、收藏与使用;C_StableInfo 管理猎人兽栏;C_Heirloom/C_HeirloomInfo 处理传家宝创建与升级。另列出 MOUNT_JOURNAL_USABILITY_CHANGED、NEW_PET_ADDED、PET_BATTLE_TURN_STARTED、TOYS_UPDATED、HEIRLOOMS_UPDATED 等事件。
使用方式:按命名空间调用对应函数,如 C_MountJournal.SummonByID(mountID)、C_PetJournal.SummonPetByGUID(petID)、C_PetBattles.UseAbility(abilityIndex)、UseToy(itemID)。
限制:坐骑有 mountID 与 spellID 之分,SummonByID 接收 mountID;显示索引随筛选变化,非 mountID;宠物对战函数仅在战斗中有效,需先检查 C_PetBattles.IsInBattle();UseToy 受冷却限制,需先查 C_ToyBox.IsToyUsable();召唤类函数需要硬件事件;宠物对战 owner 参数使用 Enum.BattlePetOwner.Ally(1) 与 Enemy(2);CreateHeirloom 需要相应货币,可先查 CanHeirloomUpgradeFromPending()。