Automated updating of API pages at this location, to reflect patch changes, has ceased from 10.1.7 onwards. |
This function is protected.
|
CastSpellByName(spellName{, onSelf});
Arguments
- name
- String - Name of the spell to cast. Rank is optional, if omitted, highest possible is picked automatically.
- onSelf
- Boolean - Should the spell be cast on the player (vs target)? If no target exists and the onSelf evaluates to false, cursor is switched to casting mode.
Example
CastSpellByName("Flash Heal(Rank 2)"); -- Cast Flash Heal (Rank 2) on target. CastSpellByName("Flash Heal"); -- Cast Flash Heal (Highest rank) on target. CastSpellByName("Flash Heal",1); -- Cast Flash Heal (Highest rank) on self.
Notes
To cast spells that contains parentheses in the spell name, such as "Create Healthstone (Major)" and "Faerie Fire (Feral)", it's necessary to either specify rank or add () to the end of the spell name, like:
CastSpellByName("Faerie Fire (Feral)()");
You might encounter difficulties when using this on a localized version of WoW.
- See the Unicode part of the Localization HOWTO for more details about editing a source file containing localized strings.
- This problem does only appear when working with Lua source files. When you're using macros, inside the WoW client, it should work in unicode directly.
- You can still use this function outside of secure code to open trade skill windows.