wowlua-lsA smarter language server for WoW addons

Deep type inference, nil safety, and first-class WoW API support. Built for addon developers who want their tools to actually understand their code.

Get Started

Why wowlua-ls?

Real type inference

Understands setmetatable, __index chains, builder patterns, and correlated returns without you annotating everything. Your OOP patterns just work.

Nil safety that isn't annoying

Tracks nil through multi-return values, if/else branches, early exits, and assert() calls. Narrowing is automatic and correlated — guard one value, siblings follow.

55+ diagnostics

From basic type mismatches to flavor-specific API availability, undeclared field injection, and unused locals. Each one suppressible per-line or per-project.

WoW API out of the box

Ships with complete retail + classic API stubs from Ketho's vscode-wow-api. Hover any WoW function for its signature. Configure target flavors to catch API mismatches.

Cross-file intelligence

Addon namespace resolution, class inheritance across files, defclass factories, and metatable chains — all resolved workspace-wide with parallel scanning.

LuaLS-compatible annotations

Uses the same annotation syntax you already know. Migrate incrementally — your existing annotations work, and wowlua-ls adds powerful features on top.