C_ClassTalents.InitializeViewLoadout

Main Menu
WoW API Lua API FrameXML Widget API Widget scripts XML schema Events CVars Macro commands Combat Log Escape sequences Hyperlinks API changes HOWTOs wowuidev

Flavors
war within  mainline
Links
Blizzard Docs  Townlong Yak  Offline /api  GitHub Search
Info
Added in 10.1.0

Prepares the Constants.TraitConsts.VIEW_TRAIT_CONFIG_ID configID, with spec and level information.

C_ClassTalents.InitializeViewLoadout(specID, level)

Arguments

specID

number - SpecializationID e.g. PlayerUtil.GetCurrentSpecID()

level

number

Details

This API, is used by Blizzard, to power their inspect UI, when clicking on a talent link ingame. Using this API yourself, can disrupt that usage, so if you're using this API to build some kind of cache, it's encouraged to do this during initial loading.

Can be used in conjunction with C_ClassTalents.ViewLoadout to build a cache of talent information, useful if you want to for example create an addon with some kind of talent picker. LibTalentTree-1.0 provides enriched information, based on this API.

For example, to create a list of talent spellIDs for a given spec, you can run the following code:

function GetSpellIDListBySpecID(specID)
    C_ClassTalents.InitializeViewLoadout(specID, 10) -- the level doesn't really matter for this usage
    C_ClassTalents.ViewLoadout({}) -- it's required to call ViewLoadout, even if it's with an empty table, as the API will not work as expected otherwise

    local list = {}

    local configID = Constants.TraitConsts.VIEW_TRAIT_CONFIG_ID

    local configInfo = C_Traits.GetConfigInfo(configID)
    if configInfo == nil then return end

    for _, treeID in ipairs(configInfo.treeIDs) do -- in the context of talent trees, there is only 1 treeID
        local nodes = C_Traits.GetTreeNodes(treeID)
        for i, nodeID in ipairs(nodes) do
            local nodeInfo = C_Traits.GetNodeInfo(configID, nodeID)
            for _, entryID in ipairs(nodeInfo.entryIDs) do -- each node can have multiple entries (e.g. choice nodes have 2)
                local entryInfo = C_Traits.GetEntryInfo(configID, entryID)
                if entryInfo and entryInfo.definitionID then
                    local definitionInfo = C_Traits.GetDefinitionInfo(entryInfo.definitionID)
                    if definitionInfo.spellID then
                        table.insert(list, definitionInfo.spellID)
                    end
                end
            end
        end
    end
    return list
end