wow-api-spells-abilities

name wow-api-spells-abilities description Complete reference for WoW Retail Spell, SpellBook, ActionBar, Cooldown, Totem, and Shapeshifting APIs. Covers C_Spell info/cooldown/usability/range, C_SpellBook navigation/slot queries, C_ActionBar slot management/state/overrides, C_SpellActivationOverlay procs, C_SpellDiminish DR tracking, C_CooldownViewer, C_AssistedCombat rotation helpers, totem queries, shapeshift forms, casting/channeling functions, flyouts, spell confirmation, and global spell category functions. Use when working with spells, abilities, action bars, cooldowns, casting, totems, shapeshift forms, spell procs, or diminishing returns. Spell & Ability API (Retail — Patch 12.0.0) Comprehensive reference for all Spell, SpellBook, ActionBar, Cooldown, Totem, Shapeshifting, and related APIs. Covers spell information, cooldowns, usability, range checking, spellbook navigation, action bar slot management, spell procs, diminishing returns, assisted combat, and global spell functions. Source of truth: https://warcraft.wiki.gg/wiki/World_of_Warcraft_API#Spell SpellBook: https://warcraft.wiki.gg/wiki/World_of_Warcraft_API#SpellBook ActionBar: https://warcraft.wiki.gg/wiki/World_of_Warcraft_API#ActionBar Current as of: Patch 12.0.0 (Build 65655) — January 28, 2026 Scope: Retail only. No deprecated or removed functions. Scope This skill covers these API systems: C_Spell — Core spell information, cooldowns, charges, usability, range, type checks C_SpellBook — Spellbook navigation, skill lines, slot queries, spell lookup C_ActionBar — Action bar slot management, state queries, bar pages, overrides C_SpellActivationOverlay — Spell proc/activation glow detection C_SpellDiminish — Diminishing returns tracking for crowd control C_CooldownViewer — Cooldown viewer categories and layout C_AssistedCombat — Assisted combat (rotation helper) integration Totem — Totem query functions (GetTotemInfo, DestroyTotem) Shapeshifting — Form/stance functions (GetShapeshiftForm, GetShapeshiftFormInfo) Global Spell Functions — CastSpellByName, CastSpellByID, SpellIsTargeting, etc. When to Use This Skill Use this skill when you need to: Query spell info: name, description, icon, subtext, link, power cost Check spell cooldowns, charges, or GCD state Determine if a spell is usable, in range, or on cooldown Navigate the spellbook: enumerate skill lines, find spell slots, check known spells Manage action bars: query action type, usability, cooldown, texture for a slot Detect action bar pages, bonus bars, override bars, vehicle bars Check for spell procs / activation overlays (glowing buttons) Track diminishing returns on crowd control effects Query totem state, duration, or destroy totems Check or cast shapeshift forms and stances Cast spells programmatically (protected functions) Handle spell targeting (SpellIsTargeting, SpellTargetUnit, SpellStopCasting) Use the assisted combat (rotation helper) system Work with flyout menus and multi-cast totem spells Reference Files Reference Contents SPELLS-CORE.md C_Spell — spell info, cooldowns, charges, usability, range, type checks SPELLBOOK.md C_SpellBook — spellbook navigation, skill lines, slot queries ACTIONBAR.md C_ActionBar — action bar slots, state, pages, overrides, pet/vehicle bars COOLDOWNS-CASTING.md Cooldowns, casting functions, spell targeting, procs, DR, assisted combat TOTEM-SHAPESHIFT.md Totem functions, shapeshifting/stances, global spell casting functions C_Spell — Core Spell API (Quick Reference) The C_Spell namespace provides direct access to spell data by spellIdentifier — which can be a spellID (number) or spellName (string). Wiki: https://warcraft.wiki.gg/wiki/World_of_Warcraft_API#Spell Key Functions Function Returns Description C_Spell.GetSpellInfo(spellIdentifier) spellInfo table Primary spell data (name, icon, castTime, etc.) C_Spell.GetSpellName(spellIdentifier) name Localized spell name C_Spell.GetSpellDescription(spellIdentifier) description Tooltip description text C_Spell.GetSpellTexture(spellIdentifier) iconID, originalIconID Spell icon texture C_Spell.GetSpellSubtext(spellIdentifier) subtext Rank or specialization label C_Spell.GetSpellLink(spellIdentifier [, glyphID]) spellLink Clickable hyperlink C_Spell.DoesSpellExist(spellIdentifier) spellExists Validates a spell ID/name C_Spell.GetSpellIDForSpellIdentifier(spellIdentifier) spellID Resolves spell name → ID C_Spell.GetBaseSpell(spellIdentifier [, spec]) baseSpellID Unwraps overrides to base spell C_Spell.GetOverrideSpell(spellIdentifier [, spec [, onlyKnown [, ignoreOverrideID]]]) overrideSpellID Gets current override for a spell Cooldowns & Charges Function Returns Description C_Spell.GetSpellCooldown(spellIdentifier) spellCooldownInfo Start time, duration, enabled, modRate C_Spell.GetSpellCooldownDuration(spellIdentifier) duration Remaining cooldown in seconds C_Spell.GetSpellCharges(spellIdentifier) chargeInfo Charges, maxCharges, start, duration C_Spell.GetSpellChargeDuration(spellIdentifier) duration Charge recharge duration C_Spell.GetSpellLossOfControlCooldown(spellIdentifier) startTime, duration LoC lockout timing C_Spell.GetSpellLossOfControlCooldownDuration(spellIdentifier) duration Remaining LoC duration Usability & Range Function Returns Description C_Spell.IsSpellUsable(spellIdentifier) isUsable, insufficientPower Can be cast now? C_Spell.IsSpellInRange(spellIdentifier [, targetUnit]) inRange Target in range? C_Spell.SpellHasRange(spellIdentifier) hasRange Does the spell have range? C_Spell.IsSpellDisabled(spellIdentifier) disabled Is spell disabled? C_Spell.GetSpellCastCount(spellIdentifier) castCount Number of available casts Type Checks Function Returns Description C_Spell.IsSpellPassive(spellIdentifier) isPassive Passive ability? C_Spell.IsSpellHarmful(spellIdentifier) isHarmful Offensive spell? C_Spell.IsSpellHelpful(spellIdentifier) isHelpful Beneficial spell? C_Spell.IsAutoAttackSpell(spellIdentifier) isAutoAttack Auto-attack? C_Spell.IsAutoRepeatSpell(spellIdentifier) isAutoRepeat Auto-repeat (e.g., Auto Shot)? C_Spell.IsRangedAutoAttackSpell(spellIdentifier) isRangedAutoAttack Ranged auto-attack? C_Spell.IsCurrentSpell(spellIdentifier) isCurrentSpell Currently being cast? C_Spell.IsConsumableSpell(spellIdentifier) consumable Consumes a resource on use? C_Spell.IsPressHoldReleaseSpell(spellIdentifier) isPressHoldRelease Empowered spell? C_Spell.IsClassTalentSpell(spellIdentifier) isClassTalent From the talent tree? C_Spell.IsPvPTalentSpell(spellIdentifier) isPvPTalent PvP talent? C_Spell.IsSpellCrowdControl(spellIdentifier) isCrowdControl CC effect? C_Spell.IsSpellImportant(spellIdentifier) isImportant Marked as important? C_Spell.IsPriorityAura(spellID) isHighPriority High-priority display aura? C_Spell.IsSelfBuff(spellID) hasSelfEffectsOnly Only affects self? C_Spell.IsExternalDefensive(spellID) isExternalDefensive External defensive? Power Cost & Data Function Returns Description C_Spell.GetSpellPowerCost(spellIdentifier) powerCosts table Resources required to cast C_Spell.GetSpellLevelLearned(spellIdentifier) levelLearned Level at which spell is learned C_Spell.GetSpellSkillLineAbilityRank(spellIdentifier) rank Rank for profession recipes C_Spell.GetSpellMaxCumulativeAuraApplications(spellID) cumulativeAura Max stacks C_Spell.GetAuraStatChanges(spellID) healthChange, powerTypeChanges Stat effects of an aura C_Spell.GetDeadlyDebuffInfo(spellIdentifier) deadlyDebuffInfo Deadly debuff display data C_Spell.GetSpellQueueWindow() result Spell queue window (ms) Spell Manipulation Function Returns Description C_Spell.CancelSpellByID(spellID) — Cancel a channeled/cast spell C_Spell.PickupSpell(spellIdentifier) — Attach spell to cursor C_Spell.RequestLoadSpellData(spellIdentifier) — Request async spell data load C_Spell.IsSpellDataCached(spellIdentifier) isCached Is data ready for query? C_Spell.EnableSpellRangeCheck(spellIdentifier, enable) — Enable/disable range checking C_Spell.SetSpellAutoCastEnabled(spellIdentifier, enabled) — Toggle pet spell autocast C_Spell.ToggleSpellAutoCast(spellIdentifier) — Toggle pet spell autocast C_Spell.GetSpellAutoCast(spellIdentifier) autoCastAllowed, autoCastEnabled Autocast state Visibility & Display Function Returns Description C_Spell.GetVisibilityInfo(spellID, visibilityType) hasCustom, alwaysShowMine, showForMySpec Aura display visibility rules C_Spell.GetSpellDisplayCount(spellIdentifier [, maxDisplayCount [, replacementString]]) displayCount Display count for stacking Targeting & Trade Function Returns Description C_Spell.TargetSpellIsEnchanting() isEnchanting Current targeting spell is enchant? C_Spell.TargetSpellJumpsUpgradeTrack() jumpsUpgradeTrack Upgrade track jump? C_Spell.TargetSpellReplacesBonusTree() result Replaces bonus loot tree? C_Spell.GetSpellTradeSkillLink(spellIdentifier) spellLink Trade skill recipe link C_SpellBook — Spellbook Navigation (Quick Reference) The C_SpellBook namespace manages the spellbook UI, skill lines, and per-slot queries. Functions take (spellBookItemSlotIndex, spellBookItemSpellBank) where spellBank is Enum.SpellBookSpellBank.Player or Enum.SpellBookSpellBank.Pet . Wiki: https://warcraft.wiki.gg/wiki/World_of_Warcraft_API#SpellBook Key Functions Function Returns Description C_SpellBook.GetNumSpellBookSkillLines() numSkillLines Number of spellbook tabs C_SpellBook.GetSpellBookSkillLineInfo(skillLineIndex) skillLineInfo Tab name, icon, offset, count C_SpellBook.GetSpellBookItemInfo(slot, bank) spellBookItemInfo Detailed spell/flyout info for a slot C_SpellBook.GetSpellBookItemType(slot, bank) itemType, actionID, spellID Type: SPELL, FLYOUT, FUTURESPELL, PETACTION C_SpellBook.GetSpellBookItemName(slot, bank) name, subName Localized name of slot C_SpellBook.GetSpellBookItemTexture(slot, bank) iconID Icon for slot C_SpellBook.GetSpellBookItemDescription(slot, bank) description Tooltip text C_SpellBook.GetSpellBookItemLink(slot, bank [, glyphID]) spellLink Hyperlink C_SpellBook.GetSpellBookItemLevelLearned(slot, bank) levelLearned Level learned C_SpellBook.FindSpellBookSlotForSpell(spellIdentifier [, includeHidden [, includeFlyouts [, includeFutureSpells [, includeOffSpec]]]]) slotIndex, bank Find slot for a spell C_SpellBook.IsSpellKnown(spellID [, spellBank]) isKnown Does the player know the spell? C_SpellBook.IsSpellInSpellBook(spellID [, spellBank [, includeOverrides]]) isInSpellBook Is it in the spellbook? C_SpellBook.IsSpellKnownOrInSpellBook(spellID [, spellBank [, includeOverrides]]) isKnownOrInSpellBook Known OR in spellbook? Slot Usability & State | Function | Returns | Description |