True Spy

True Spy

Know who's hunting you - before they reach you.

True Spy is enemy intelligence for World of Warcraft. It watches the combat log, nameplates, your target and your mouseover, scores every hostile player it sees, and turns that into something you can act on: a clean on-screen scanner for the heat of the moment, and a full Intel Center command screen for everything else.

Built to be fast and crisp - a modern take on classic enemy detection, not a cluttered clone. One lean window on screen; the deep tooling one click away.

---

The scanner (your on-screen window)

• Slim, compact list. Each contact is a threat-colored square and a class-colored name on the left, level and class right-aligned. That's it - readable at a glance in the middle of a fight.
• Header your way - a clean two-row header by default (a title/count bar, then a control bar with the list dropdown - Nearby, History, KOS, Reports, Deaths - the Intel Center icon and a clear). Prefer less? Switch to a slim one-row, auto, Minimal (no title - just the controls), or Legacy Spy layout in Options; auto never scrunches at any width.
• Threat-tinted rows - a subtle threat/class-colored bar behind each name so the list reads instantly.
• Legacy Spy look - a mode on the Header button (or /tspy spy) that turns the Nearby list into solid class-colored name bars running edge to edge - white name on the left, level and class on the right, with a slim header to match - the classic enemy-scanner style. Threat stays one hover away. Off by default; both looks ship, your choice.
• Make it match YOUR UI - an Accent color button (Red classic, Dark Blue, Slate, Green) recolors the window border and title; an opt-in grow upward checkbox stacks names from the bottom edge like the classic Spy; and Text size sits in Options (left-click bigger, right-click smaller). Threat and KOS colors stay meaningful no matter the accent.
• Sort the Nearby list by threat, level, class or most-recent, with optional column headers.
• Pin contacts to the top of Nearby and History (/tspy pin <name>).
• Minimap count badge - the spyglass shows the live nearby count, colored by the top threat present.
• Resize freely - drag the corner grip as small or large as you want - plus window opacity and lock.
• Auto-open threshold - let the window pop on its own only for the tiers you care about: Any / Caution+ / Serious+ / Deadly-only.

Detection and threat scoring

• Detects hostiles from the combat log, nameplates, target and mouseover.
• Threat score, 1-100, weighing level gap, class danger, KOS status and your personal win/loss history against that player.
• Stealth siren - a distinct alarm the moment a stealth ability goes off near you.
• Enemies seen only through the combat log (no level yet) show a clear ?? until you see them on a nameplate or target them.

Alerts you control

• Spoken audio alerts with custom phrases and player name / class variables.
• Threat-tiered sounds - a distinct alert for red-tier (70+) contacts, plus a first-contact-of-session chime. Every sound is chosen from a scrollable dropdown, not cycled one at a time.
• Per-name re-alert cooldown so you're not spammed by the same player (/tspy realert <seconds>).
• Quiet modes for battlegrounds and cities when you want the intel without the noise.
• Tactical Danger Radar - an ambient red screen-edge glow and a compact, movable heat meter that rise as high-threat enemies gather around you (LOW -> CAUTION -> SERIOUS -> DEADLY), so you feel a zone getting hot before you're jumped. Off by default; Options or /tspy radar.
• Hunter Arrow - opt-in: the moment an enemy player attacks you or has you targeted, the direction arrow locks onto them with name and distance and follows the fight (TomTom waypoint too, if installed). If they restealth or vanish, it holds their last known spot - perfect for hunting the ganker back. Off by default; Options or /tspy hunterarrow.
• Quiet by default - out of the box nothing pops or pings; the list just fills. Turn on alert sounds, spoken alerts, the stealth siren, the radar, or the window auto-open one at a time, exactly how you like it.

The Intel Center (full command screen)

One click from the scanner opens the command screen where everything is handled:

• Sortable, filterable, virtualized datatables: Nearby, History, KOS, Deaths, Reports - with saved filter presets and CSV / TSV export of any view.
• Bulk KOS - Ctrl+Shift-click to multi-select and flag rows at once.
• Backup and restore your entire intel database as a paste string (/tspy backup, /tspy restore), plus a history-retention slider.
• Analytics: a current-zone danger forecast, a busiest-hours activity sparkline, a contacts-per-day trend, and a death map whose skulls scale and fade by recency.
• Stats: nemesis and victim boards, wins/losses by class, deadliest zones and hours, and a per-login session log.
• Zone Map view with real map art, and a settings-profile manager you can save, load, share and auto-load per character.

On death and after the fight

• Killer dossier on death - when an enemy player kills you, their dossier opens automatically: your record against them, their opener, counter advice, and the KOS/note buttons right there.
• Session debrief - one compact card per login (minutes played, contacts, kills/deaths, new KOS, your most-seen enemy, hottest zone). /tspy debrief any time; it pops itself when you leave a battleground with something to report.
• After-action reports with damage breakdowns and the opener each enemy used.
• BG incoming announcer - several fresh contacts in one spot inside 15 seconds becomes ONE call-out to the battleground channel (off by default, throttled so it never spams).

Guild and sharing

• Guild-wide contact and KOS sync with a directional targeting arrow and TomTom support. One toggle controls both directions: sharing off means you send nothing and guildmates' broadcasts are ignored.
• Announce KOS sightings to guild chat (opt-in; Options or /tspy announceguild).
• KOS list export / import to trade lists with friends.

Housekeeping

• Database janitor - old intel rots away on a retention you control (/tspy keep <days>, default 45). KOS entries, players with notes, and anyone you have a win/loss record with never rot.
• UI localization on deDE, frFR, esES/esMX, ptBR and ruRU clients, with clean English fallback. Coverage grows each release.
• WeakAuras events: TSPY_CONTACT, TSPY_KOS, TSPY_DEATH - with a WeakAuras Kit of one-click starter auras (/tspy weakauras).
• Every window remembers its position and size.

Slash commands

/tspy opens Options. Also: debrief, pin <name>, realert <seconds>, announceguild, firstchime, radar, hunterarrow, bug, debugmode, whatsnew, weakauras, header <two|one|auto>, spy, keep <days>, backup, restore, mapcal, arrowcal.

How to Report Bugs

Something misbehaving? The addon writes your bug report for you:

1. Turn on Debug mode - Options, or /tspy debugmode. From that moment it records every detection, alert, arrow action, and error message. Lua errors are ALWAYS kept (the last 50), even before you turn Debug mode on.
2. Make the problem happen.
3. Type /tspy bug (or hit Report a Bug in Options). A window opens with a complete report already written: your game version and flavor, class, level, current settings, the recorded Lua errors, and the event log.
4. Press Ctrl+C and paste it in a comment or private message right here on this page.

That one paste usually tells us everything we need to fix your issue on the first try.

Works on

• Retail
• Mists of Pandaria Classic
• Classic Era & SoD
• Burning Crusade Classic

One download; each client loads the build made for it.