AI Module Development

Give the full specification to your agent with your class, game version and intended behavior. It covers the .wa1 format, public module APIs, both runtimes, recommended patterns and complete examples. Requires client 20260913.120630 or later.

Full AI specification · llm.txt · JSON Schema · AI discovery index

Tip

Preserve your macro table, logic IDs and hotkeys. To update official assistance, replace only initialization code: the first preset macro stays intact and assisted macros append after it. Save, regenerate the addon and /reload out of combat.

Complete example	Purpose
blank.wa1	A blank template with 150 macros, 90 properties and 50 logic rows, retaining valid hotkeys.
static-macro.wa1	Static macro, property and timeout after successful submission.
dynamic-macro.wa1	Create a macro in game initialization and call it by name in desktop logic.
aura-library.wa1	Native auras, parameters and library references. Observation only; no key dispatch.
target-selection.wa1	Target selection macros and timers. Explicitly bind the logic before use.
official-assisted-demo.wa1	Preserves a preset macro and updates assisted macros out of combat. It does not automatically call the preset.
hud-basic.wa1	The module’s HUD script draws a health bar, combat label and icon; display only, no keys.
hud-demo.wa1	HUD showcase and stress test: every node kind, loop preset, enter / exit transition, tween and effect on one screen, plus a stress panel sized by the STRESS constant; runs without a game, display only.
hud-media.wa1	Textures and sounds: a spinning tinted aura texture, a ring cooldown with a shadowed countdown and a Jim countdown voice, a BigWigs Smooth-textured health bar with a spark that glows when low, a stop-motion sprite in combat, and a low-health label that plays an alarm when it appears; built-in texture / sound names only, display only.
target-range.wa1	Target-range HUD: each range property takes the hostile / friendly check spell IDs as parameters (leave empty to skip); the range checks pass through untouched (secret values can be displayed but not computed on) and the HUD reasons out the distance bracket; display only, no keys.

Format, Lua and import tests are not in-game acceptance. Dispatch does not prove a successful cast. Deployment checks documentation, contract sources and examples for consistency.