EnemyCityInvaderAlert alerts you when players of your own faction are in an enemy city. For example, if you are an Alliance, and five Alliance are invading Orgrimmar, then it will tell you that five Alliance are in Orgrimmar. Then, maybe you can go and join them.
Here's how it works if you're Alliance. After 90 seconds have passed, EnemyCityInvaderAlert sends a /who command to see which Alliance players are in all the Horde cities, and it intercepts the results. The EnemyCityInvaderAlert window (which can be resized/moved to your liking) will show how many of your own faction is in the enemy city. So if you're Alliance, and there's an Alliance rogue stealthing around in Orgrimmar, it'll tell you. When you mouseover the EnemyCityInvaderAlert window, a tooltip will list the players in the enemy cities. It will refresh itself every 90 seconds. See the screenshots for examples of this.
QUICK START: When you log in, you should see the EnemyCityInvaderAlert frame on your screen (probably the upper-left corner of your screen). Move your mouse over it, and then the tooltip has all the directions for moving and resizing that frame. (END OF QUICK START SECTION)
If you're Alliance, the following Horde places are checked for Alliance invaders once per 90 seconds: (For places with an asterisk (*) next to them, EnemyCityInvaderAlert will only count players who are there two consecutive "checks" in a row. This helps to avoid listing players who are simply flying through the zone on a flying taxi such as a griphon.)
Orgrimmar, Undercity, Thunder Bluff, Silvermoon City, Durotar(*), Mulgore(*)
If you're Horde, then the following Alliance places are checked for Horde invaders:
Ironforge, Stormwind, Darnassus, Exodar, Deeprun Tram, Westfall(*), Duskwood(*), Dun Morogh(*)
(Note: Elwynn Forest(*) is not checked yet; I will test this for a future version.)
There are some caveats to EnemyCityInvaderAlert:
- Blizzard only allows the /who command to be used once about every five seconds. Therefore, if you use /who less than seven seconds after EnemyCityInvaderAlert has used it or after you used another /who, EnemyCityInvaderAlert will "hold" your /who command until the seven seconds have passed. Once the seven seconds have passed, EnemyCityInvaderAlert will run your /who command.
- For this reason, if you have another addon that hooks /who or any of the Who functions, then the two addons could interfere with each other.
- For certain zones, a player must be in that zone for two checks (one check, and then another check after 90 seconds) in a row, so that EnemyCityInvaderAlert can reasonably guess that that player is not just flying through on a griphon.
- For Alliance, the Ratchet-to-Azshara flight path goes over the side entrance to Orgrimmar very briefly. If EnemyCityInvaderAlert happens to do a check at the precise moment somebody is flying over that entrance, it'll incorrectly show that player as being in Orgrimmar.
- On rare occasions on my system, EnemyCityInvaderAlert has shown when GMs are in enemy cities! If this happens (and it's very rare), you will see the GM next to their name.