Skip to content
WoW Addon Lib that provides more robust spell range checking functionality.
Branch: master
Clone or download
Latest commit bc1ce0a Feb 23, 2019
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.docmeta
.pkgmeta
LibSpellRange-1.0.lua
LibSpellRange-1.0.toc
README.md
lib.xml

README.md

LibSpellRange-1.0

Background

Blizzard's IsSpellInRange API has always been very limited - you either must have the name of the spell, or its spell book ID. Checking directly by spellID is simply not possible. Now, since Mists of Pandaria, Blizzard changed the way that many talents and specialization spells work - instead of giving you a new spell when leaned, they replace existing spells. These replacement spells do not work with Blizzard's IsSpellInRange function whatsoever; this limitation is what prompted the creation of this lib.

Usage

LibSpellRange-1.0 exposes an enhanced version of IsSpellInRange that:

  • Allows ranged checking based on both spell name and spellID.
  • Works correctly with replacement spells that will not work using Blizzard's IsSpellInRange method alone.

SpellRange.IsSpellInRange(spell, unit) - Improved IsSpellInRange

Parameters

  • spell - Name or spellID of a spell that you wish to check the range of. The spell must be a spell that you have in your spellbook or your pet's spellbook.
  • unit - UnitID of the spell that you wish to check the range on.

Return value

Exact same returns as the built-in IsSpellInRange

Usage

-- Check spell range by spell name on unit "target"
local SpellRange = LibStub("SpellRange-1.0")
local inRange = SpellRange.IsSpellInRange("Stormstrike", "target")

-- Check spell range by spellID on unit "mouseover"
local SpellRange = LibStub("SpellRange-1.0")
local inRange = SpellRange.IsSpellInRange(17364, "mouseover")

SpellRange.SpellHasRange(spell) - Improved SpellHasRange

Parameters

  • spell - Name or spellID of a spell that you wish to check for a range. The spell must be a spell that you have in your spellbook or your pet's spellbook.

Return value

Exact same returns as the built-in SpellHasRange

Usage

-- Check if a spell has a range by spell name
local SpellRange = LibStub("SpellRange-1.0")
local hasRange = SpellRange.SpellHasRange("Stormstrike")

-- Check if a spell has a range by spellID
local SpellRange = LibStub("SpellRange-1.0")
local hasRange = SpellRange.SpellHasRange(17364)
You can’t perform that action at this time.