ESOTU UI API Patch Notes (Version 100012)
These patch notes highlight the larger changes to the ESOTU API. For the full, updated API, please take a look at the newest version of the ESOTU UI documentation.
Combat and Effect API ChangesBefore:
- No information on effects that last less than 30 seconds.
After:
- Addons will now receive information on effects shorter than 30 seconds as long as they affect the player or were cast by the player.
Before:
- The EFFECT_CHANGED event was unit tag based, which means it was only sent if a unit tag existed for the unit with the effect on them. This means that if a player cast an effect on a target and then looked away, the addon would not receive updates about that effect. It also means it was difficult to track which unit the effect was cast on if the player casts the same effect on multiple targets.
After:
- The EFFECT_CHANGED event now includes a unit name field and will always be sent, even if no unit tag exists. The event will continue to be sent for each applicable unit tag if unit tags do exist.
Before:
- COMBAT_EVENT was stripped of most of its information if it failed a filtering check. These filtering rules were complex and hard to account for.
After:
- COMBAT_EVENT is sent for all ability casts if the source or target is the player or their pet.
Additionally:
- Added GetAbilityIcon(abilityId) – icon.
- Added abilityId to EVENT_COMBAT_EVENT and EVENT_EFFECT_CHANGED.
- Added a unique numerical target id to EVENT_EFFECT_CHANGED to separate units with the same name. This unique id persist as long as the client knows about the unit.
- Added unique numerical source and target ids to EVENT_COMBAT_EVENT. This unique id persist as long as the client knows about the unit.
Currency
Changed the API for currencies (gold, alliance points, tel var stones) to allow for more generic handling. The vast majority of existing functions for dealing with currencies (e.g. GetCurrentMoney(), GetAlliancePoints()) have been left intact. However, we have added new functions like GetCarriedCurrenyAmount which takes a currency type. We have also added functions to deal with Tel Var stones for Imperial City.
Added:
- GetCarriedCurrencyAmount(currencyType) – amount.
- GetBankedCurrencyAmount(currencyType) – amount.
- DepositCurrencyIntoBank(currencyType, amount).
- WithdrawCurrencyFromBank(currencyType, amount).
- DepositCurrencyIntoGuildBank(currencyType, amount).
- WithdrawCurrencyFromGuildBank(currencyType, amount).
- GetGuildBankedCurrencyAmount (currencyType) – amount.
- GetBankedTelvarStones() – amount.
- DepositTelvarStonesIntoBank(amount).
- WithdrawTelvarStonesFromBank(amount).
- LootCurrency(currencyType)
- GetLootCurrency(currencyType) – unownedCurrency, ownedCurrency.
Changed:
- GetStoreEntryInfo no longer supplies a currency id, icon, or name. These are now derived from the currency type.
- GetStoreCurrencyTypes no longer returns usesBattleTokens or usesItems, and now also returns usesTelvarStones.
Removed:
- GetItemCurrencyQuantity was removed because item currencies were removed.
Display Names
Added display names to a number of functions and events that previously only had character names.
Imperial City
Added support for the Imperial City. Includes new functions for dealing with Tel Var stones. Use GetImperialCityCollectibleId() with IsCollectibleUnlocked(collectibleId) to determine if the player has access to Imperial City.
Added:
- GetTelvarStoneBankingFee() – bankingFee.
- GetTelvarStoneMinimumDeposit() – minDeposit.
- GetTelvarStoneMultiplierThresholdIndex() – the index of the current threshold.
- GetTelvarStoneThresholdAmount(thresholdIndex) – minimum amount of stones to get at that threshold.
- GetTelvarStoneMultiplier(thresholdIndex) – multiplier on stone gains.
- IsMaxTelvarStoneMultiplierThreshold(thresholdIndex) – isAtMaxThreshold.
- DoesCurrentZoneHaveTelvarStoneBehavior() – telvarBehaviorEnabled.
- GetCampaignRulesetImperialAccessRule(rulesetId) – accessRuleType.
- GetNumTelvarStonesLost() – returns the number of stones lost on the most recent death.
Champion
Moved a lot of the pending point maintenance for Champion into the client to allow client systems a better view of what is happening. Mostly, the Champion class in Lua has had the implementations of its pending points management functions changed to calling client functions instead.
Added:
- GetNumPendingChampionPoints(disciplineIndex, skillIndex) – numPendingPoints.
- SetNumPendingChampionPoints(disciplineIndex, skillIndex, numPendingPoints).
- HasAvailableChampionPointsInAttribute(attribute) – hasPoints.
- WillChampionSkillBeUnlocked(disciplineIndex, skillIndex) – willBeUnlocked.
- SetChampionIsInRespecMode(isInRespecMode) .
- IsChampionInRespecMode() – isInRespecMode.
- IsChampionRespecNeeded() – returns true if the pending point allocation would require a respect to achieve.
- SpendPendingChampionPoints().
Cooldowns
Improved the cooldown control to allow more flexibility.
Added:
- SetRadialCooldownClockwise(clockwise).
- SetRadialCooldownGradient(startAlpha, angularDistance) which fades the cooldown over angularDistance radians from startAlpha to abs(1 – startAlpha).
- SetRadialCooldownOriginAngle(originAngle).
- SetDesaturation(desaturation) which applies to all cooldown types.
- New cooldown type CD_TYPE_VERTICAL_REVEAL which reveals the texture instead of stretching it.
Register for Event Filters
Added the ability to filter out event calls in the client before they reach Lua. This provides a small performance benefit over using a conditional in the callback. It is useful for events that are fired very frequently (such as EVENT_COMBAT_EVENT). Either use EVENT_MANAGER:AddFilterForEvent(namespace, event, filterType, …) or control:AddFilterForEvent(event, filterType, …). These are the event filter types and their parameters:
- REGISTER_FILTER_ABILITY_ID - abilityId
- REGISTER_FILTER_COMBAT_RESULT - combatResult
- REGISTER_FILTER_IS_ERROR
- REGISTER_FILTER_IS_IN_GAMEPAD_PREFERRED_MODE
- REGISTER_FILTER_POWER_TYPE – powerType.
- REGISTER_FILTER_UNIT_TAG – unitTag.
- REGISTER_FILTER_UNIT_TAG_PREFIX – unitTagPrefix.
- REGISTER_FILTER_VIBRATION_FILTER – filter cutoff.
Scripted Events
Added a more complete and consistent API for scripted events.
Added:
- GetNumScriptedEventInvites() – numInvites.
- GetScriptedEventInviteIdFromIndex(eventIndex) – eventId.
- GetScriptedEventInviteInfo(eventId) – isValid, eventName, inviterName, questName, timeRemainingMS.
- GetScriptedEventInviteTimeRemainingMS(eventId) – timeRemainingMS.
- AcceptWorldEventInvite(eventId)
- DeclineWorldEventInvite(eventId)
- RemoveScriptedEventInviteForQuest(questName)
- EVENT_SCRIPTED_WORLD_EVENT_INVITE_REMOVED.
Mouse Buttons
Added a new enumeration for mouse buttons called MOUSE_BUTTON_INDEX so you no longer have to use the numbers directly:
- MOUSE_BUTTON_INDEX_INVALID
- MOUSE_BUTTON_INDEX_LEFT
- MOUSE_BUTTON_INDEX_RIGHT
- MOUSE_BUTTON_INDEX_MIDDLE
- MOUSE_BUTTON_INDEX_4
- MOUSE_BUTTON_INDEX_5
- MOUSE_BUTTON_INDEX_LEFT_AND_RIGHT
GuildAdded:
- GetGuildInfo(guildId) – numMembers, numOnlineMembers, leaderName.
- GetGuildMemberIndexFromDisplayName (displayName) – member index.
MiscellaneousFunctions
- Added:
- GetUnitDisplayName(unitTag) – displayName.
- InsertNamedActionLayerAbove(layerName, existingLayerName).
- HasActivatableSwapWeaponsEquipped() – canSwapWeaponSets which returns if the player has two set that they can swap between (doesn’t have only one weapon set filled).
- Some more information to GetItemLinkOnUseAbilityInfo, GetItemLinkTraitOnUseAbilityInfo, and GetItemLinkTraitInfo to handle items whose on use effects scale over a level range.
- GetAvAKeepsHeld(campaignId, alliance) – keepsHeld.
- IsItemLinkBook(itemLink) – isBook.
- GetRecallCurrency(nodeIndex) – currencyType for handling recalling to nodes that have Tel Var stone costs.
- IsWerewolfSkillLine(skillType, skillLineIndex) – isWerewolfSkillLine.
- GetCollectibleUnlockStateById(collectibleId) – unlockState.
- GetCollectibleName(collectibleId) – name.
- IsCollectibleUnlocked(collectibleId) – isUnlocked.
- GetAchievementRewardCollectible(achievementId) – hasRewardOfType, collectibleId.
- GetMaxVeteranRank().
- AnimationObjectTranslate ::GetAnchorIndex() – anchorIndex.
- AnimationTimeline:: GetPlaybackLoopsRemaining() – loopsRemaining.
- AnimationTimeline:: SetPlaybackLoopCount(maxLoopCount).
- LabelControl::SetMaxLineCount(maxLineCount).
- LabelControl::GetNumLines() – numLines.
- Changed:
- GetClassInfo(classId) now also returns gamepad icons.
- HasAnyJunk(bagId) to also take a boolean flag to control whether stolen items are included.
- Added return to GetAlchemyItemTraits(reagentBagId, reagentSlotIndex) for cancelling traits.
- Added returns to GetEmoteInfo(emoteIndex) for display name and is shown in gamepad UI.
Events
- Added:
- EVENT_ACTION_SLOT_ABILITY_USED
- EVENT_BANKED_TELVAR_STONES_UPDATE
- EVENT_GROUP_INVITE_ACCEPT_RESPONSE_TIMEOUT
- EVENT_HIGH_FALL_DAMAGE
- EVENT_JUSTICE_BEING_ARRESTED
- EVENT_LOW_FALL_DAMAGE
- EVENT_PLAYER_REINCARNATED
- EVENT_PLAYER_STUNNED_STATE_CHANGED
- EVENT_RIDING_SKILL_IMPROVEMENT
- EVENT_SPAM_WARNING
- EVENT_TELVAR_STONE_UPDATE
- EVENT_ALL_GUI_SCREENS_RESIZED
- EVENT_ALL_GUI_SCREENS_RESIZE_STARTED
- Changed:
- EVENT_END_CRAFTING_STATION_INTERACT to now pass the crafting skill of the interaction that just ended.
- EVENT_SCREEN_RESIZED to return the name of the gui that just finished resizing.
Script Handlers
- Added:
- OnTextureLoaded which is fired when a texture control has loaded its file into memory.
Jessica FolsomLead Community Manager - ZeniMax Online StudiosFacebook |
Twitter |
Twitch |
Tumblr |
Instagram |
YouTube |
Support