Adds IntelliSense features for World of Warcraft API to VS Code. This is a third party extension for LuaLS with annotations.
- Includes the WoW Lua 5.1 environment
- Loads the official Blizzard API documentation
- Parses Warcraft Wiki API documentation
Enum
andConstants
tableLE_
Lua Enums
Shows completion for GlobalStrings at >3 uppercase letters to declutter fuzzy search.
The AddOn namespace needs to be annotated with @class in each file. This way the language server knows about the shared table and also allows you to mutate it.
file1.lua
---@class ns
local ns = select(2, ...)
ns.foo = "hello"
file2.lua
---@class ns
local ns = select(2, ...)
ns.bar = "world"
If you intend to use deprecated APIs for Classic, the warning and strikethrough can be removed by disabling its diagnostic.
More documentation is available on the project wiki.
The extension reflects the state of the wiki, so if you create/update the wiki pages, it will be updated in the extension on the next release. Otherwise feel free to create an issue with the false errors.
For example UnitLevel would be documented like so.
{{wowapi}}
Returns the level of the unit.
level = UnitLevel(unit)
==Arguments==
:;unit:{{apitype|string}} : [[UnitToken]]
==Returns==
:;level:{{apitype|number}}
Alternatively, the script will look for a commented block for API pages not documented in Blizzard_APIDocumentationGenerated.
<!-- luals
---@param unit UnitToken
---@return number level
function UnitLevel(unit) end
-->
Refer to SETUP.md if you want to run the Lua scripts which generate the documentation.
- Blizzard Entertainment
- Townlong Yak - Foxlit
- Wago Tools - QartemisT
- Warcraft Wiki - Kaydeethree
- WoWInterface
- Wowprogramming - jnwhiteh
- WoW.tools - Marlamin
- Annotations: Kozoaku, Oppzippy, Snakybo, Torhal, Wutname
- FrameXML: funkydude, Gethe, Tekkub
- LuaLS: Sumneko
- VS Code extension: ChrisKader, DakJaniels, thatnerdjosh, Yuyuli
- Wiki: DahkCeles, Foxlit, Iriel, Xelnath
- Algalon: Ghost
- Amazing people: Andols, Cidan, Ferronn, Meorawr, Nevcairiel
- BlizzardInterfaceResources: Resike
- DeadlyBossMods: Tandanu, MysticalOS
- IntelliJ-IDEA-Lua-IDE-WoW-API: Ellypse
- WeakAuras: Buds, Stanzilla