Changes: API UnitReaction

Revision as of 21:38, 14 March 2011

For the paladin talent, see [Sanctuary].

A sanctuary is an area where PvP combat is disabled for all players, and turning on your PvP flag will have no effect until you leave the sanctuary. Sanctuaries were introduced in World of Warcraft: The Burning Crusade. Places like Nighthaven and Booty Bay are not sanctuaries; PvP combat is still possible there. Just because PvP combat is disabled, that does not mean that a sanctuary is a safe haven; for example, the monsters on the Stair of Destiny are not PvP NPCs and will attack players if aggroed.

Entering a sanctuary differs from the effect of manually turning off one's PvP flag, (or, on PvP servers, entering a friendly territory) in that PvP combat is immediately disabled; there is no five minute wait. Because of this, it is possible to evade PvP combat by entering a sanctuary, for example, if someone is attacked by another player on their way to the Dark Portal in the Blasted Lands, their attacker cannot continue attacking them if they cross the portal and enter the Stair of Destiny.

Known sanctuaries

The Stair of Destiny, Hellfire Peninsula
Shattrath City, Terokkar Forest
Acherus: The Ebon Hold, Eastern Plaguelands
Dalaran, Crystalsong Forest
Angrathar the Wrathgate, Dragonblight (via an the area-wide buff and only after having completed the Wrathgate questline)
Argent Tournament Grounds, Icecrown (via an the area-wide buff)
The Frozen Halls, Icecrown Citadel, Icecrown
The Maelstrom
Temple of Earth, Deepholm

@@ Line 1: / Line 1: @@
+{{for|the paladin talent|Sanctuary (paladin talent)}}
-{{wowapi}} __NOTOC__
-Determine the reaction of the specified unit to the other specified unit.
- reaction = UnitReaction("unit", "otherUnit");
+A '''sanctuary''' is an area where [[PvP]] combat is disabled for all players, and turning on your PvP flag will have no effect until you leave the sanctuary. Sanctuaries were introduced in ''[[World of Warcraft: The Burning Crusade]]''. Places like [[Nighthaven]] and [[Booty Bay]] are not sanctuaries; PvP combat is still possible there. Just because PvP combat is disabled, that does not mean that a sanctuary is a safe haven; for example, the monsters on the [[Stair of Destiny]] are not PvP NPCs and will attack players if aggroed.
-==Parameters==
-===Arguments===
-:;unit : String - The [[API TYPE UnitId|UnitId]] of the unit whose reaction is to be determined.
-:;otherUnit : String - The [[API TYPE UnitId|UnitId]] of the unit towards whom the reaction is to be measured.
-===Returns===
-:;reaction : Number - the level of the reaction of unit towards otherUnit - this is a number between 1 and 7. If the reaction is unknown then nil is returned.
-::# Exceptionally hostile
-::# Very Hostile
-::# Hostile
-::# Neutral
-::# Friendly
-::# Very Friendly
-::# Exceptionally friendly
+Entering a sanctuary differs from the effect of manually turning off one's PvP flag, (or, on PvP servers, entering a friendly territory) in that PvP combat is ''immediately'' disabled; there is no five minute wait. Because of this, it is possible to evade PvP combat by entering a sanctuary, for example, if someone is attacked by another player on their way to the [[Dark Portal]] in the [[Blasted Lands]], their attacker cannot continue attacking them if they cross the portal and enter the [[Stair of Destiny]].
-==Notes==
-* I'm not entirely sure what the actual levels of friendliness and hostility translate to. I'm 5 to myself!
-* I assume the levels are Faction-related (1 Hated, 2 Hostile, 3 Unfriendly, 4 Neutral, 5 Friendly, 6 Honored, 7 Revered, Exalted (still 7?))
-* I tested this on an npc that is part of a faction where I am exalted, but I only got 5 returned. The only values I've seen so far are 2 (for all red mobs), 4 (netural mobs) and 5 (friendly NPCs and members of my faction (including wildhammer NPCs as of 2.0.3 who are alliace tagged but neutral)).
+==Known sanctuaries==
-* This doesn't change when a mob becomes aggressive towards a player. I had to use the negative result of [[API UnitIsFriend]].
+*[[Stair of Destiny|The Stair of Destiny]], [[Hellfire Peninsula]] {{bc-inline}}
+*[[Shattrath City]], [[Terokkar Forest]] {{bc-inline}}
+*[[Acherus: The Ebon Hold]], [[Eastern Plaguelands]] {{wotlk-inline}}
+*[[Dalaran]], [[Crystalsong Forest]] {{wotlk-inline}}
+*[[Angrathar the Wrathgate]], [[Dragonblight]] {{wotlk-inline}} (via an the area-wide buff and only after having completed the Wrathgate questline)
+*[[Argent Tournament Grounds]], [[Icecrown]] {{wotlk-inline}} (via an the area-wide buff)
+*[[Frozen Halls|The Frozen Halls]], [[Icecrown Citadel]], [[Icecrown]] {{wotlk-inline}}
+*[[Maelstrom|The Maelstrom]] {{cata-inline}}
+*[[Temple of Earth]], [[Deepholm]] {{cata-inline}}
-* Does not work across continents (or zones?)! If you query UnitReaction for a raid (or party)-member across continents, it won't return the correct value (I guess it returns nil, but I have yet to confirm that). I think it only returns correct values for units that are in 'inspect-range'.
+{{Territory}}
-* In Blizzard Code, UnitReaction is only used between the player and a Non Player Controlled target.
+[[Category:Game terms]]
+[[pl:Sanctuary]]