Patch 10.1.0/API changes

• A new Private Auras system has been added to display buffs and debuffs applied to units without exposing information about the aura to addons.
• A new addon link type has been added for local addon-only chat links.
• A new talentbuild link type has been added for inspecting loadouts.
• A new ScrollFrame template has been added as a replacement for various other templates which are now deprecated.
• A new set of TOC metadata fields have been added to control the display of an icon in the addon list.
• A new set of TOC metadata fields have been added to automatically register dropdown entries into the minimap Addon compartment.
• The addon list no longer displays addons out-of-order if their names contain UI escape sequences.
• The C_TooltipInfo APIs now return data with all data and line arguments surfaced, removing the need to call.
• The event now has an additional argument. This can be correlated with a field of the same name on tables returned by the C_TooltipInfo APIs to more accurately process data update events.

• TOC:
• Diffs: wow-ui-source, BlizzardInterfaceResources
• Official patch notes: Dragonflight: Embers of Neltharion Content Update Notes

A new private aura system has been added through which the UI can display buffs and debuffs active on units without exposing information on the auras to addons. This works as a separate system to the existing buff and debuff display and must be configured through a set of new APIs.

The following example configures a private aura anchor in the center of the screen for the first private aura applied to the player. A cooldown frame is configured to represent the duration, and the icon is displayed in the center of the frame. A textual duration will be displayed in a fontstring below the icon.

Multiple anchors for a single aura can be created by addons with their own independent settings. The function returns an ID which can be later supplied to to remove the aura display from the UI.

A sound alert can be configured to be played upon application of an aura. This works through spell IDs rather than aura indices. The function returns an ID which can be later supplied to to disable the sound effect being played.

Finally, a raid message style alert can be configured to display text when a private aura is applied. Unlike the previous APIs this is a global resource; individual addons cannot configure their own raid message displays for private auras.

The Addon compartment has been updated to support automatically registering dropdown entries for addons from TOC fields. The following TOC fields have been added.

The example below demonstrates the use of these TOC fields.

<font color="#4ec9b0">MyAddOn.toc <font color="#ecbc2a">## AddonCompartmentFunc: MyAddOn_OnAddonCompartmentClick MyAddOn.lua

• 1) Interface:
• 2) Title: My Addon
• 3) Notes: Does something neat
• 4) Author: Your Name
• 1) IconTexture: Interface\Icons\TEMP.blp

<font color="#4ec9b0">MyAddOn.lua

A new addon link type has been added to the chat frame infrastructure to better support addon-created chat links. This new link type is local-only and cannot be sent in chat messages. This serves as a replacement for garrmission links without needing to rely on their current implementation details to avoid taint.

A new ScrollFrame template named ScrollFrameTemplate has been added. This serves as a replacement for many old scrolling related templates that are now deprecated as of this patch. This template can be used as a simpler alternative to ScrollBox views, and automatically creates and configures a scrollbar for use with the frame. An Lua example can be found below to demonstrate the use of this new template.

For XML use cases, refer to the following example.

The following key values pairs can be assigned via XML to customize the creation of the scrollbar.

The following templates have been deprecated and will be removed in a future patch. Many of these can be replaced by ScrollFrameTemplate with minimal changes required.

• FauxScrollFrameTemplate
• FauxScrollFrameTemplateLight
• ListScrollFrameTemplate
• MinimalScrollBarTemplate
• MinimalScrollBarWithBorderTemplate
• MinimalScrollFrameTemplate
• UIPanelInputScrollFrameTemplate
• UIPanelScrollBarTemplate
• UIPanelScrollBarTemplateLightBorder
• UIPanelScrollBarTrimTemplate
• UIPanelScrollFrameCodeTemplate
• UIPanelScrollFrameTemplate
• UIPanelStretchableArtScrollBarTemplate

The ScrollFrame_OnLoad function was renamed to UIPanelScrollFrame_OnLoad, however the old function name was reused and now refers to an entirely new and different function. If you are having issues with multiple scrollbars appearing on a scroll frame, renaming these function calls may be a solution.

+ ret 2: <font color="#00b400">hideTimerInTooltip + arg 4: <font color="#00b400">ignoreZoneMapPositionData + arg 2: <font color="#00b400">glyphID + arg 3: <font color="#00b400">removedModifications + arg 4: <font color="#00b400">removedModifications # ret 1: <font color="#ecbc2a">vignettePosition, Nilable: true -> false + ret 2: <font color="#00b400">vignetteFacing

+ 2: <font color="#00b400">containsBindings + 1: <font color="#00b400">dataInstanceID

Enum.BattlepetDeletedReason + <font color="#00b400">TradingPost = 6 Enum.CraftingReagentType # <font color="#ff6767">Optional -> <font color="#00b400">Modifying = 0 + <font color="#00b400">Automatic = 3 Enum.CurrencySource + <font color="#00b400">AccountHwmUpdate = 61 Enum.Cursormode + <font color="#00b400">QuestLegendaryCursor = 28 + <font color="#00b400">QuestLegendaryTurninCursor = 29 + <font color="#00b400">QuestLegendaryErrorCursor = 61 + <font color="#00b400">QuestLegendaryTurninErrorCursor = 62 Enum.EditModeAccountSetting # <font color="#ff6767">ShowBuffFrame -> <font color="#00b400">ShowBuffsAndDebuffs = 10 # <font color="#ff6767">ShowDebuffFrame -> <font color="#00b400">DeprecatedShowDebuffFrame = 11 # <font color="#ff6767">ShowReputationBar -> <font color="#00b400">ShowStatusTrackingBar2 = 20 + <font color="#00b400">EnableAdvancedOptions = 23 + <font color="#00b400">ShowPetFrame = 24 Enum.EditModeCastBarSetting + <font color="#00b400">ShowCastTime = 2 Enum.EditModeLayoutType + <font color="#00b400">Override = 3 Enum.EditModeMicroMenuSetting + <font color="#00b400">EyeSize = 3 Enum.EditModeMinimapSetting + <font color="#00b400">Size = 2 Enum.EditModeObjectiveTrackerSetting + <font color="#00b400">Opacity = 1 Enum.EditModeStatusTrackingBarSystemIndices # <font color="#ff6767">ExperienceBar -> <font color="#00b400">StatusTrackingBar1 = 1 # <font color="#ff6767">ReputationBar -> <font color="#00b400">StatusTrackingBar2 = 2 Enum.EditModeUnitFrameSystemIndices + <font color="#00b400">Pet = 8 Enum.InventoryType # <font color="#ff6767">IndexEquipablespellMobilityType -> <font color="#00b400">IndexEquipablespellWeaponType = 34 Enum.PointsModifierSourceType + <font color="#00b400">CreatureHealthMod = 64 Enum.PowerType + <font color="#00b400">AlternateQuest = 23 + <font color="#00b400">AlternateEncounter = 24 + <font color="#00b400">AlternateMount = 25 Enum.TooltipDataLineType + <font color="#00b400">Separator = 30 Enum.UIMapFlag + <font color="#00b400">AlwaysAllowTaxiPathing = 0x20000 Enum.UIWidgetVisualizationType + <font color="#00b400">WorldLootObject = 26 + <font color="#00b400">ItemDisplay = 27 Enum.VignetteType + <font color="#00b400">FyrakkFlight = 4 Enum.WidgetEnabledState # <font color="#ff6767">Enabled -> <font color="#00b400">Yellow = 1 # <font color="#ff6767">Gold -> <font color="#00b400">Artifact = 5

Constants.TraitConsts + <font color="#00b400">VIEW_TRAIT_CONFIG_ID = -3

AreaPOIInfo + 13: <font color="#00b400">addPaddingAboveWidgets CharCustomizationChoice + 7: <font color="#00b400">soundKit CraftingReagentSlotSchematic + 9: <font color="#00b400">required GenericWidgetDisplayFrameInfo + 6: <font color="#00b400">extraButtonText + 7: <font color="#00b400">closeButtonText ItemUpgradeCurrencyCost + 3: <font color="#00b400">discountInfo ItemUpgradeItemCost + 3: <font color="#00b400">discountInfo ItemUpgradeItemInfo + 5: <font color="#00b400">highWatermarkSlot + 8: <font color="#00b400">minItemLevel + 9: <font color="#00b400">maxItemLevel + 11: <font color="#00b400">customUpgradeString + 12: <font color="#00b400">upgradeCostTypesForSeason MatchPVPStatColumn + 5: <font color="#00b400">tooltipTitle PVPScoreInfo + 17: <font color="#00b400">postmatchMMR PartyPoseInfo + 8: <font color="#00b400">uiTextureKit + 9: <font color="#00b400">titleText PerksActivitiesInfo + 3: <font color="#00b400">secondsRemaining PerksActivityInfo + 7: <font color="#00b400">supersedes + 8: <font color="#00b400">uiPriority ProfessionInfo + 3: <font color="#00b400">sourceCounter QuestInfo + 23: <font color="#00b400">isLegendarySort StatusBarWidgetVisualizationInfo + 17: <font color="#00b400">textEnabledState + 18: <font color="#00b400">textFontType + 19: <font color="#00b400">textSizeType TaxiNodeInfo + 9: <font color="#00b400">isMapLayerTransition UIWidgetSpellInfo # 5: <font color="#ecbc2a">iconSizeType, Type: SpellDisplayIconSizeType -> WidgetIconSizeType UiMapDetails # 5: <font color="#ecbc2a">flags, Type: number -> UIMapFlag VignetteInfo + 16: <font color="#00b400">addPaddingAboveWidgets