Maintenance script: UI Lua API import (WAR 1.4.8)

2026-10-16T19:42:37Z

UI Lua API import (WAR 1.4.8)

New page

{{LuaApi|group=Career}}
Returns the player's career advances (abilities, mastery points, renown and tome rewards) with their costs, requirements and purchase counts.

<pre>
advances = GameData.Player.GetAdvanceData()
</pre>

== Arguments ==
None.

== Returns ==
;advances : <code>table</code> – Array of advance tables, indexed from 1.

Each advance table has these fields:
{| class="wikitable"
! Key !! Type !! Meaning
|-
| <code>advanceName</code> || <code>wstring</code> || Name of the advance. The stock UI shows it for advances without <code>abilityInfo</code>.
|-
| <code>advanceType</code> || <code>number</code> || Type of the advance. Advances of type 2 have an <code>abilityInfo</code> table.
|-
| <code>advanceValue</code> || <code>number</code> || –
|-
| <code>advanceID</code> || <code>number</code> || Advance id. The stock UI looks up its description with <code>GetStringFromTable("PackageDescriptions", advanceID)</code>.
|-
| <code>advanceIcon</code> || <code>number</code> || Icon id for [[API:GetIconData|GetIconData]].
|-
| <code>category</code> || <code>number</code> || Career advance category, 0–19. Compared with <code>GameData.CareerCategory</code> values.
|-
| <code>tier</code> || <code>number</code> || Tier inside the category, 0–4.
|-
| <code>packageId</code> || <code>number</code> || Package id. Passed to [[API:BuyCareerPackage|BuyCareerPackage]] together with <code>tier</code> and <code>category</code>.
|-
| <code>timesPurchased</code> || <code>number</code> || How many times the advance has been bought.
|-
| <code>maximumPurchaseCount</code> || <code>number</code> || –
|-
| <code>minimumRank</code> || <code>number</code> || Required character rank. The stock UI compares it with <code>GameData.Player.level</code>.
|-
| <code>minimumRenown</code> || <code>number</code> || Required renown rank. The stock UI compares it with <code>GameData.Player.Renown.curRank</code>.
|-
| <code>minimumCategoryPoints</code> || <code>number</code> || –
|-
| <code>cashCost</code> || <code>number</code> || Price in money. The stock UI shows it with <code>MoneyFrame.FormatMoney</code>.
|-
| <code>pointCost</code> || <code>number</code> || Point cost. The stock renown training window shows it as the renown point cost.
|-
| <code>requiredTomeEntryID</code> || <code>number</code> || –
|-
| <code>requiredActionCounterID</code> || <code>number</code> || –
|-
| <code>requiredActionCounterCount</code> || <code>number</code> || –
|-
| <code>dependencies</code> || <code>table</code> || Table of number keys to number values. The stock UI reads each pair as a required package and the amount needed (<code>InteractionUtils.GetDependentPackage</code>).
|-
| <code>abilityInfo</code> || <code>table</code> || Only for advances of type 2. An [[API:GetAbilityData#Ability data table|ability data table]] for the ability the advance grants, plus the field <code>isPurchased</code> (<code>boolean</code>), which the stock UI treats as "the player already has this ability" (<code>InteractionUtils.HasAbilityFilter</code>).
|}

== Details ==
* Advances are listed category by category (0 to 19), and inside each category tier by tier (0 to 4).
* <code>isPurchased</code> is <code>true</code> when the client finds the ability among the player's abilities.
* <code>abilityInfo</code> does not contain the <code>isActive</code> field that [[API:GetAbilityData|GetAbilityData]] adds.
* A new table is built on every call. The stock training windows call it when they refresh and keep the result.

== Errors ==
None.

== Example ==
From <code>ea_interactionwindow/source/interactioncoretraining.lua</code>:
<pre>
EA_Window_InteractionCoreTraining.advanceData = GameData.Player.GetAdvanceData()
</pre>

Choosing the label text, from the same file:
<pre>
if (advanceData.abilityInfo == nil)
then
LabelSetText( labelFrame, GetStringFormatFromTable("TrainingStrings", StringTables.Training.LABEL_CORE_TRAINING_ABILITY_NAME_FORMAT, {advanceData.advanceName}) )
else
LabelSetText( labelFrame, GetStringFormatFromTable("TrainingStrings", StringTables.Training.LABEL_CORE_TRAINING_ABILITY_NAME_FORMAT, {advanceData.abilityInfo.name}) )
</pre>

== See also ==
* [[API:BuyCareerPackage|BuyCareerPackage]]
* [[API:GameData.Player.GetAdvancePointsAvailable|GameData.Player.GetAdvancePointsAvailable]]
* [[API:GameData.Player.GetAdvancePointsSpent|GameData.Player.GetAdvancePointsSpent]]
* [[API:GetAbilityData|GetAbilityData]]

API:GameData.Player.GetAdvanceData - Revision history

Maintenance script: UI Lua API import (WAR 1.4.8)