VuhDo-Custom-Flag-Bouquet-Validators.md

@@ -19,10 +19,25 @@ Another example which returns true only if the unit is currently marked with a r
 return VUHDO_unitInfo["raidIcon"] == 4 and VUHDO_getUnitCustomDebuffs()[VUHDO_unitInfo["unit"]] and VUHDO_getUnitCustomDebuffs()[VUHDO_unitInfo["unit"]]["Penetrating Cold"] and true or false;
 ```
 
-One more example which returns true only if the unit has an active HoT Icon tracking 'Atonement':
+As of VuhDo v3.173, there is a new API that must be used to determine whether a unit has an active HoT Icon:
 
 ```lua
-return VUHDO_MY_HOTS and VUHDO_MY_HOTS[VUHDO_unitInfo["unit"]] and VUHDO_MY_HOTS[VUHDO_unitInfo["unit"]]["Atonement"] and true or false;
+VUHDO_hasUnitHot(<unit ID>, <spell name|spell ID>[, VUHDO_UNIT_HOT_TYPE_<MINE|OTHERS|BOTH|OTHERSHOTS>])
+```
+
+The third optional argument to `VUHDO_hasUnitHot` specifies the unit type who must be the source of the HoT aura:
+
+* `VUHDO_UNIT_HOT_TYPE_MINE` - HoTs cast by the player.
+* `VUHDO_UNIT_HOT_TYPE_OTHERS` - HoTs cast by other players.
+* `VUHDO_UNIT_HOT_TYPE_BOTH` - HoTs cast by either the player or other players.
+* `VUHDO_UNIT_HOT_TYPE_OTHERSHOT` - HoTs tracked via the special built-in `Other player's HoTs` bouquet.
+
+When omitted, the third argument defaults to `VUHDO_UNIT_HOT_TYPE_MINE`.
+
+One more example which returns true only if the unit has an active HoT Icon tracking 'Atonement' cast by the player:
+
+```lua
+return VUHDO_hasUnitHot(VUHDO_unitInfo["unit"], "Atonement") and true or false;
 ```
 
 More example bouquets using custom flags of various kinds can be found on [wago.io](https://wago.io/p/Ivaria).