The Spy addon scans the combat log for actions performed by enemy players and announces their presence when they are detected. By warning you about nearby enemy players you can prepare for possible PvP combat. If an enemy player is detected Spy will attempt to determine their class, race and level based on the ability that was used. It will then sound an alert and add the enemy player to the Nearby List. Spy can be configured to announce enemy player encounters and share data with other Spy users in your party, raid or guild.
The Spy Window
The Spy window will initially appear under your character portrait, but can be moved by dragging the title bar. The title bar contains the following buttons:
- Stats: Opens the Statistics Window which shows a list of all enemies encountered
- Clear: Manually clears all enemy players that have currently been detected.Holding the Control key down while clicking this button will turn Spy off / on while leaving the window displayed.Holding the Shift key down while clicking this button will turn off / on all audio alerts.
- Left/Right: Used to navigates between the Nearby, Last Hour, Ignore and Kill On Sight lists..
- Close: Hides the Spy window. Spy is configured by default to show itself again when the next enemy player is detected. Alternatively you can type /spy show to manually show the Spy Window.
The Nearby List
As enemy players are detected they will be added to the Nearby list. Hovering over entries in the list will display a tooltip with the enemy player's details, including the last seen time and location. Right-clicking on them will displays a drop down menu which will allow you to:
- Remove the enemy player from the Nearby ist.
- Add/remove the enemy player to/from your Ignore or Kill On Sight list.
- Announce the enemy player's details to a chat channel of your choice.
- Set multiple Kill On Sight reasons, if the player is on your Kill On Sight list.
If enemy players remain undetected they will be removed from the Nearby list after a configurable amount of time. The Nearby list will always sort by the time each enemy player was initially detected, with enemy players who are on the Kill On Sight list or actively performing actions being placed at the top of the list. Spy is configured by default to switch back to the Nearby list when the next enemy player is detected.
The Kill On Sight List
The Kill On Sight list is for enemy players you especially want to know about. When enemy players on your Kill On Sight list are detected a warning will be displayed and an alarm will sound. You can use the drop down menu to add/remove enemy players to/from the Kill On Sight list, or hold the Shift key down while clicking an entry in the list to add/remove enemy players.
The Ignore List
The Ignore list is where you can place enemy players you have deemed harmless. Spy will not generate any alerts for enemy players on your Ignore list. You can use the drop down menu to add/remove enemy players to/from the Ignore list, or hold the Control key down while clicking on an entry in the list to add/remove enemy players.
The Last Hour List
The Last Hour list displays enemy players that have been detected in the last hour. It will always be sorted by the time each enemy player was initially detected, with those most recently detected appearing at the top of the list.
The Statistics Window
The Statistics window contains a list of all enemy encounters. By default it is sorted by the last time an enemy was detected. It can be also sorted by name, level, guild, wins and losses. The Statistics window also provides the capability to search for a specific enemy by name or guild and has filters to show enemies that are marked as Kill on Sight, with a Win/Loss or entered Reasons.
Additional Information
For more information see the tooltips associated with each option in the Interface Addons Spy configuration menu and the README file. To see a list of slash commands type: /spy
Localizations
Currently enUS, deDE, koKR, ptBR, zhCN and zhTW.
Contact me on this site if you are able to provide translations for other languages.
Authors
Created by Immolation from Cho'gall (US).
Updated by Slipjack.
Comments and Suggestions
Comments and suggestions are welcome. To report issues or ask for new features, use this site:
https://www.curseforge.com/wow/addons/spy/issues
Hi there i em having a problem where spy does not show up on my screen at all was working for about 3 days but no where to be found deleted reinstalled but no where to find also downloaded the newest version still nothing. any ideas? spy doesnt have a mini map button like other does it? just the original bar that starts under your name.
In reply to llgunnerll1:
Use the command
/spy reset
To position the Spy window in the center of the screen.
In reply to Slipjack:
it worked thank you!
In reply to Slipjack:
This works for the current session, but as soon as I logout and back in, it doesn't work again. For now I've rolled back to the prior version, and restored my save file from that version. I do see the changes you made to the code around location, but haven't had time to dig into what's going on there (as the X/Y values that get written to the save file don't make sense, and it's why you can't just roll back, you have to roll back to the prior save file as well).
In reply to zaph0n:
Try the command
/spy show
It might be there just hidden. Check your settings and turn off any functions that automatically hide Spy.
In reply to Slipjack:
I have checked that. As I said, if I revert both the addon and save file to 3.6.21 these issues go away. But when I update to 3.6.22 the addon will show up if I do a /spy reset for the one session. As soon as I logout, it updates the save files with CRAZY x/y coordinates (things like -60000). I'll update it on another PC, reset it, show it, put it where it belongs, and logout and paste the save file coordinate block.
In reply to zaph0n:
So I put 3.6.22 on my laptop, initially the window loaded up fine, as my settings for coordinates were as follows.
["Position"] = {
["y"] = 394.5000915527344,
["x"] = 470.6667785644531,
["w"] = 300.0000305175781,
["h"] = 35.00000762939453,
},
Then I ran /reload ui a few times, I noticed that the values kept increasing further and further negative on each reload. This is the settings now after about 5 or 6 /reload ui calls
["Position"] = {
["y"] = -3927.999755859375,
["x"] = -5946.000244140625,
["w"] = 300.0002136230469,
["h"] = 34.99996948242188,
},
Each /reload ui decreases the y value by just over 600 and the x value by just over 900. So the next reload will be in the y range of -4500 and x range of -6800. Looking at the diff between 3.6.21 and 3.6.22 you're doing some math on the X/Y values each time based on the UI scale which I have set at 0.64 according to Config.wtf. I'm guessing this math is wrong, as it appears to be taking the input values and applying the rules each time, hence why they keep decreasing over and over in my case.
In reply to zaph0n:
Looking further into it, I'm not quite sure what you're trying to do in SaveMainWindowPosition() and RestoreMainWindowPosition(). Specifically on the lines where you take the xOfs and yOfs and do some math subtracting off the width/height times the UI scale divided by 2. In my case, this along with the additional division by the uis again causes me to lose the 900 and 600 each time respectively. Example, going into with my window in the right place (ignoring decimals), I have the following values
xOfs = 620
yOfs = 377
efs = 0.64
uis = 0.64
GetScreenWidth() = 2133
GetScreenHeight() = 1200
xOfs = xOfs * efs - GetScreenWidth() * uis / 2
yOfs = yOfs * efs - GetScreenHeight() * uis / 2
so
xOfs = 620 * 0.64 - 2133 * 0.64 / 2 which is (620 * 0.64) - (2133 * 0.64 / 2) which is (396.8) - (682.56) = -285.76
You then before saving it into the Position.x value divide by uis so -285.76 / 0.64 = -446.5, a net loss of 1066.50
On the restore function you take in the value, multiply by uis and divide by efs (which are both the same, so cancels out)... And then even though you grabbed the CENTER of the windows position in SaveMainWindowPosition() (not once adjusting it for width/height), you then use the saved position to set the upper left point. So even if the math worked above, it would still move a bit down and right each time on restore.
As I said, not sure what you're trying to do here with this math, but it's wrong. And hence why the window keeps moving further and further off the screen for me.
In reply to llgunnerll1:
Ok good. Going to add a function so that doesn't happen unless you want it to.
Please correct for the message of the player in the local defense in Russian
In reply to landate1:
What is the correct translation?
In reply to Slipjack:
"ОборонаЛокальный" or "3.ОборонаЛокальный"
Hi, Slipjack..
Spy is the most necessary addon in this brutal era. Thank you for made great addon.
I customize "title-industrial.tga" files(I changed it transparent image), so there are no background title image.
But I can`t remove that dark gray transparent line.... it really bothering me ;(
(I'm using ResizeSpy option)
I know the line came from enemy list background, so I try to find background's SetAlpha option in *.lua files but i can`t. (I'm Lua noob)
Could you tell me how do i remove that background? or make transparent?
*English is not my first language, but I hope you understand my comments and please help me. Thanks.
In reply to yelst:
Glad you like the addon. The background is set to the default "UI-Tooltip-Background" image. I am not sure if you can change the transparency of the tooltip background. If not - then it might be easier to create your own transparent background image like you did with the other file and point to that file.
in reply to Slipjack:
I found "UI-Tooltip-Background" part in Widgets.lua and changed it.
Then, It works perfectly!!!
Thank you sooooooo much, Slipjack..
In reply to yelst:
Happy that you got it working the way you want.
Is there a way to scan for enemies who are flagged for PVP? The addon seems to scan for ALL enemies of the opposing faction.
In reply to Graberl:
There was an option to do that but it was proven to not work as intended. Once we find a way to get it working again (if it is even possible) , it will be added as an option again.
In reply to Slipjack:
Cool, thanks. Other than that, the addon is really lightweight and useful.
Add a way to manually add KoS without putting it in the settings file? I have a post-it with names...