Add power-related conditionals and note

Document new power conditionals (myenergy, mymana, myrage, energy, mana, rage) with examples and table entries. Add a note explaining that mana/rage/energy read specific power slots for other units (cross-form behavior and potential stale/empty reads when a slot isn't the unit's primary power).
Brues
2026-07-27 21:23:09 -05:00
parent 3528349a8f
commit 38fedea4b3
+8
@@ -44,11 +44,14 @@ These always evaluate against the player. Cannot be redirected with `@unit`.
| `mycc` | Player has CC effect | ✅ | ✅ | `[mycc:stun/silence]` `[nomycc]` | | | | `mycc` | Player has CC effect | ✅ | ✅ | `[mycc:stun/silence]` `[nomycc]` | | |
| `mydebuff` | Player has debuff (with time/stacks) | ✅ | ✅ | `[mydebuff:Curse_of_Agony]` | | | | `mydebuff` | Player has debuff (with time/stacks) | ✅ | ✅ | `[mydebuff:Curse_of_Agony]` | | |
| `mydebuffcapped` | Player debuff bar full (16) | ✅ | — | `[nomydebuffcapped]` | v2.20 | | | `mydebuffcapped` | Player debuff bar full (16) | ✅ | — | `[nomydebuffcapped]` | v2.20 | |
| `myenergy` | Player energy % (specific slot) | — | ✅ | `[myenergy:>50]` | | |
| `myhp` | Player HP % | — | ✅ | `[myhp:<30]` `[myhp:>20&<50]` | | | | `myhp` | Player HP % | — | ✅ | `[myhp:<30]` `[myhp:>20&<50]` | | |
| `myhplost` | Player HP deficit (max - current) | — | ✅ | `[myhplost:>500]` | | | | `myhplost` | Player HP deficit (max - current) | — | ✅ | `[myhplost:>500]` | | |
| `mylevel` | Player level | — | ✅ | `[mylevel:=60]` | | | | `mylevel` | Player level | — | ✅ | `[mylevel:=60]` | | |
| `mymana` | Player mana % (specific slot, cross-form) | — | ✅ | `[mymana:>30]` | | |
| `mypower` | Player mana/rage/energy % | — | ✅ | `[mypower:>50]` | | | | `mypower` | Player mana/rage/energy % | — | ✅ | `[mypower:>50]` | | |
| `mypowerlost` | Player power deficit | — | ✅ | `[mypowerlost:>200]` | | | | `mypowerlost` | Player power deficit | — | ✅ | `[mypowerlost:>200]` | | |
| `myrage` | Player rage % (specific slot, cross-form) | — | ✅ | `[myrage:>=50]` | | |
| `myrawhp` | Player raw HP value | — | ✅ | `[myrawhp:>1000]` | | | | `myrawhp` | Player raw HP value | — | ✅ | `[myrawhp:>1000]` | | |
| `myrawpower` | Player raw power value | — | ✅ | `[myrawpower:>=40]` | | | | `myrawpower` | Player raw power value | — | ✅ | `[myrawpower:>=40]` | | |
| `nextslamclip` / `nonextslamclip` | Instant now will/won't cause next Slam to clip | ✅ | — | `[nonextslamclip]` | | SP_SwingTimer | | `nextslamclip` / `nonextslamclip` | Instant now will/won't cause next Slam to clip | ✅ | — | `[nonextslamclip]` | | SP_SwingTimer |
@@ -79,6 +82,8 @@ These always evaluate against the player. Cannot be redirected with `@unit`.
These default to checking the current target. Most can be redirected with `@unit` (e.g., `[@focus,hp:<30]`, `[@mouseover,exists]`). These default to checking the current target. Most can be redirected with `@unit` (e.g., `[@focus,hp:<30]`, `[@mouseover,exists]`).
> **Note on `mana`/`rage`/`energy` for other units:** these read a *specific* power slot rather than the unit's primary power, so they work regardless of form (a druid's mana in Cat Form, etc.). For units other than the player, vanilla only broadcasts the unit's *active* power, so a non-primary slot may read stale/empty — a unit with no such pool fails the check. The reliable case is reading the slot that *is* that unit's primary power (e.g. `[@target,mana:<15]` on a caster to catch it near OOM).
| Conditional | Description | No | Multi | Example | NP | Addon | | Conditional | Description | No | Multi | Example | NP | Addon |
|-------------|-------------|:--:|:-----:|---------|:--:|-------| |-------------|-------------|:--:|:-----:|---------|:--:|-------|
| `alive` | Unit is alive | ✅ | — | `[alive]` | | | | `alive` | Unit is alive | ✅ | — | `[alive]` | | |
@@ -99,6 +104,7 @@ These default to checking the current target. Most can be redirected with `@unit
| `dispellable` | Target has any dispellable debuff | ✅ | — | `[dispellable]` | | | | `dispellable` | Target has any dispellable debuff | ✅ | — | `[dispellable]` | | |
| `dispellablebuff` | Target has any dispellable buff (offensive) | ✅ | — | `[harm,dispellablebuff]` | | | | `dispellablebuff` | Target has any dispellable buff (offensive) | ✅ | — | `[harm,dispellablebuff]` | | |
| `distance` | Distance in yards / count within range | ✅ | ✅ | `[distance:<40]` `[distance:30>1]` `[distance:30:facing>1]` | | UnitXP_SP3 | | `distance` | Distance in yards / count within range | ✅ | ✅ | `[distance:<40]` `[distance:30>1]` `[distance:30:facing>1]` | | UnitXP_SP3 |
| `energy` | Target energy % (specific slot) | — | ✅ | `[@target,energy:<30]` | | |
| `exists` | Unit exists | ✅ | — | `[@mouseover,exists]` | | | | `exists` | Unit exists | ✅ | — | `[@mouseover,exists]` | | |
| `facing` | Facing target / count facing | ✅ | ✅ | `[facing]` `[facing:>2]` `[facing:meleerange>1]` | | UnitXP_SP3 | | `facing` | Facing target / count facing | ✅ | ✅ | `[facing]` `[facing:>2]` `[facing:meleerange>1]` | | UnitXP_SP3 |
| `harm` | Unit is hostile | ✅ | — | `[harm]` | | | | `harm` | Unit is hostile | ✅ | — | `[harm]` | | |
@@ -114,6 +120,7 @@ These default to checking the current target. Most can be redirected with `@unit
| `level` | Target level (skull = 63) | — | ✅ | `[level:>60]` | | | | `level` | Target level (skull = 63) | — | ✅ | `[level:>60]` | | |
| `magic` | Target has a Magic debuff | ✅ | — | `[magic]` `[@focus,magic]` | | | | `magic` | Target has a Magic debuff | ✅ | — | `[magic]` `[@focus,magic]` | | |
| `magicbuff` | Target has a dispellable Magic buff (offensive) | ✅ | — | `[harm,magicbuff]` | | | | `magicbuff` | Target has a dispellable Magic buff (offensive) | ✅ | — | `[harm,magicbuff]` | | |
| `mana` | Target mana % (specific slot) | — | ✅ | `[@target,mana:<15]` | | |
| `meleerange` | In melee range / count in melee | ✅ | ✅ | `[meleerange]` `[meleerange:>1]` `[meleerange:facing>1]` | | UnitXP_SP3 | | `meleerange` | In melee range / count in melee | ✅ | ✅ | `[meleerange]` `[meleerange:>1]` `[meleerange:facing>1]` | | UnitXP_SP3 |
| `member` | Target is in party or raid | ✅ | — | `[member]` | | | | `member` | Target is in party or raid | ✅ | — | `[member]` | | |
| `multiscan` | Scan enemies by priority, soft-cast | — | ✅ | `[multiscan:nearest]` `[multiscan:skull]` | | UnitXP_SP3 | | `multiscan` | Scan enemies by priority, soft-cast | — | ✅ | `[multiscan:nearest]` `[multiscan:skull]` | | UnitXP_SP3 |
@@ -126,6 +133,7 @@ These default to checking the current target. Most can be redirected with `@unit
| `power` | Target mana/rage/energy % | — | ✅ | `[power:<30]` | | | | `power` | Target mana/rage/energy % | — | ✅ | `[power:<30]` | | |
| `powerlost` | Target power deficit | — | ✅ | `[powerlost:>100]` | | | | `powerlost` | Target power deficit | — | ✅ | `[powerlost:>100]` | | |
| `powertype` | Target power type | ✅ | ✅ | `[powertype:mana/rage]` | | | | `powertype` | Target power type | ✅ | ✅ | `[powertype:mana/rage]` | | |
| `rage` | Target rage % (specific slot) | — | ✅ | `[@target,rage:<10]` | | |
| `raid` | Unit is in your raid | ✅ | ✅ | `[raid]` `[raid:mouseover]` | | | | `raid` | Unit is in your raid | ✅ | ✅ | `[raid]` `[raid:mouseover]` | | |
| `rawhp` | Target raw HP value | — | ✅ | `[rawhp:>5000]` | | | | `rawhp` | Target raw HP value | — | ✅ | `[rawhp:>5000]` | | |
| `rawpower` | Target raw power value | — | ✅ | `[rawpower:>500]` | | | | `rawpower` | Target raw power value | — | ✅ | `[rawpower:>500]` | | |