Macro Workshop · Nanami

Macro editor

Checks as you type: length, line length, and whether each command and condition is supported. Use the buttons on the right to insert common pieces.

Macro text

0 / 1023 chars 0 bytes 0 lines

Display

Commands

Conditions

Target units

AI macro helper

Describe what you want in a sentence; the AI writes a macro that follows this realm’s macro rules and explains each line. It can also review the macro in the editor. Always check spell names against your spellbook.

Log in to use the AI helper (20 requests per account every 24 hours). Log in

What should the macro do?

Templates

Common macros. Load one into the editor and adapt it. Spell names must match your spellbook.

Reference

Getting started

Type /macro in game, create a macro and pick the question-mark icon.
Paste the macro text; start with #showtooltip.
Drag the macro to an action bar. The button shows the icon, cooldown and tooltip of whatever it will cast right now.

#showtooltip /cast [@mouseover,help,nodead][help,nodead][@player] Flash Heal

This heals the friendly unit under your mouse (unit frames count), otherwise your friendly target, otherwise yourself.

Syntax

[conditions] action runs only when the conditions hold. Commas mean “and”: [harm,nodead].
Several bracket groups mean “or”: [@mouseover,help][help]; the first group that holds wins.
Semicolons separate clauses: /cast [harm] Shadow Bolt; Heal. A clause without brackets always holds.
Empty brackets [] always hold — handy as a fallback.
Prefix no negates: nocombat, nodead, noform.
Arguments follow a colon, alternatives use slashes: [mod:shift/ctrl], [stance:1/2].
Choose the unit with @unit or target=unit, e.g. [@focus,harm].
! before a spell keeps it on if already active: /cast !Auto Shot, /cast !Cat Form.
Ranks are optional (highest by default): Shadow Bolt(Rank 3).

#showtooltip and #show

#showtooltip shows the icon, cooldown, count and tooltip of the spell or item on the button.
#show does the same without replacing the tooltip.
You may name what to show, with conditions: #showtooltip [mod:shift] Chain Heal; Lesser Healing Wave. Otherwise the first /cast or /use is used.
The icon only changes when the macro uses the question-mark icon.
With nampower installed, buttons also turn red out of range and blue without enough mana.

Commands

Command	Chinese alias	What it does
/cast	/施放 /法术	Casts a spell; falls back to an item with that name.
/use	/使用	Uses an item: by name, bag and slot (e.g. 0 1) or equipment slot (13/14 trinkets); falls back to a spell.
/castsequence	/施放序列	Casts the next spell in the list each press; reset=seconds/target/combat/shift/alt/ctrl restarts it.
/castrandom	/随机施放	Casts a random spell from a comma list.
/userandom	/随机使用	Uses a random item from a comma list.
/stopmacro	/停止宏	Stops the rest of the macro when its conditions hold.
/stopcasting	/停止施法	Stops your current cast.
/startattack	/开始攻击	Starts auto-attack without toggling it off.
/stopattack	/停止攻击	Stops auto-attack.
/cancelaura	/取消光环	Removes one of your buffs.
/cancelform	/取消形态	Leaves your current form.
/equip	/装备 /eq	Equips an item from your bags.
/equipslot	/装备到	Equips into a slot, e.g. /equipslot 13 Trinket.
/target /assist	/目标 /协助	Support conditions: /target [@mouseover,exists].
/cleartarget	/清除目标	Clears your target.
/focus /clearfocus	/焦点 /清除焦点	Sets or clears your focus for [@focus].
/click	/点击	Clicks a UI button, e.g. /click ActionButton1.
/petattack /petfollow	/宠物攻击 /宠物跟随	Pet attack or follow; also /petstay /petpassive /petdefensive /petaggressive.
/nmacro	/宏系统	Status; /nmacro off, on, or force.

Conditions

Condition	Meaning
exists	The unit exists
help / harm	The unit is friendly / attackable
dead	The unit is dead
party / raid	The unit is in your party / raid
combat	You are in combat
mod[:shift/ctrl/alt]	A modifier key is held (any, if none given)
stance / form[:n]	In stance/form n; 0 means none
stealth	Stealthed (incl. Shadowmeld and Prowl)
pet[:名字/种类]	You have a pet, optionally by name or family
group[:party/raid]	You are in a party / raid
button:n	Clicked with mouse button n (1 left, 2 right)
actionbar:n	Action bar page n is active
equipped:类型	An item type is equipped, e.g. equipped:Shields
channeling[:技能]	You are channeling
known:技能	The spell is in your spellbook
mounted	You are mounted
swimming / indoors / outdoors	Swimming / indoors / outdoors (needs SuperWoW 2.x; otherwise the group fails with a chat notice)

Every condition can be negated with no. Conditions for things 1.12 lacks (flying, spec, vehicle) are not supported.

Units

player, target, mouseover (world units and unit frames), focus, pet, party1–party4, raid1–raid40, targettarget, pettarget.

Length and long macros

Up to 1023 characters per macro (the original limit is 255). Keep each line under 255.
Macros over 255 bytes keep their first lines in the game’s macro and the full text in your local WTF saved data.
The full text is saved through Turtle’s built-in Turtle_General addon; keep it enabled or long macros only last for the session.
Like stock macros, they live on your PC: back up WTF if you change computers.

Dependencies and compatibility

No addon needed: it lives in patch-9 of both the standard and HD clients; just update via the launcher.
SuperWoW (shipped by the launcher) lets @unit casts skip retargeting and provides mounted/swimming/indoors and focus. Without it the macro briefly retargets.
nampower adds out-of-range and out-of-mana button colors.
/focus uses Nanami-UI’s focus frame when present, otherwise SuperWoW.
With SuperMacro, Roid-Macros or similar installed, the system steps aside; /nmacro force overrides that.
/nmacro off restores stock macro behavior; /nmacro on turns it back on.

FAQ

Icon doesn’t change? Use the question-mark macro icon.
#showtooltip shows up in chat? Your client doesn’t have the 9.30 patch-9 yet — update through the launcher.
“Unsupported macro condition”? Check the spelling, or it is a later-expansion condition such as flying. The editor flags these.
Nothing is cast? The spell name must match your spellbook exactly; try /cast Name in chat first.
No loops or timers: a macro runs once per key press by design.