KillOnSight

KillOnSight is a comprehensive PvP awareness and threat-detection addon for World of Warcraft, designed to provide early warnings, visual clarity, and reliable tracking of hostile players — without UI clutter or performance overhead.

It supports Retail and all Classic-era clients.

Core Feature Overview

KillOnSight combines nearby detection, stealth awareness, KoS / Guild tracking, enemy statistics, and attacker history into a single, clean interface.

🧭 Nearby Enemy Detection

Real-time detection of hostile players in your vicinity (TBC version has classic style distance)
Nearby window with clean, minimal layout
Automatically grows and shrinks based on active entries
Sorted by last seen, newest activity always prioritized
Class-colored names with optional KoS / Guild indicators
Inline stealth icon when an enemy is detected via stealth
Hidden/stealth icon clears immediately when the player becomes visible
Inactive players dim/fade automatically
Scrollable only when the list exceeds visible space
Automatically disabled and cleared in sanctuary/safe zones

⚔️ Kill-on-Sight (KoS) & Guild Targets

Mark individual players as Kill-on-Sight
Mark entire guilds as Guild KoS

KoS and Guild targets are visually distinguished in:

Nearby window
Target frames

Dragon icons shown on target frames:

Silver for KoS
Gold for Guild KoS

🕵️ Stealth Detection

Detects stealth-capable enemies using combat log analysis:
Rogue: Stealth, Vanish
Druid: Prowl
Works even if the enemy was already present in the Nearby list
Displays a stealth icon inline next to the enemy name
Optional Spy-style center-screen warning banner
Optional stealth detection sound
Optional chat notification
Stealth indicators clear instantly when the enemy becomes visible
All stealth options apply live (no reload required)

🔔 Alerts & Notifications

Center-screen alert banners (Spy-style)
Configurable fade-in, hold, and fade-out timing
Optional screen flash
Optional chat notifications

Fully independent sound toggles for:

KoS & Guild KoS alerts
Nearby detection
Stealth detection
Battleground sound mute option (KoS/Guild/Nearby/Stealth)

No sound options are coupled — disable exactly what you want.

📊 Enemy Statistics

Persistent stats per enemy player:
Times seen
Wins / losses
Last seen timestamp
Class information and colors reliably populated
Old/legacy entries automatically cleaned up
Efficient list rendering (virtualized rows for performance)
Notes in KoS GUI

🗡️ Attackers Tracking

Dedicated Attackers tab
Only records players who actually attacked you
Damage events
Missed attacks
Hostile debuffs and CC
Clean separation from Nearby detection
Attackers list is not polluted by passive sightings

🆕 New Feature: Import KoS from Spy (Classic / TBC / Wrath / MoP)

KillOnSight now supports importing your existing Kill-on-Sight list from Spy.

If you’ve used Spy in the past, you can migrate your KoS list into KillOnSight in seconds — no manual re-adding required.

How it works:

Enable Spy
Log in once (or /reload)
Run: /kos importspy
(Optional) Disable Spy afterwards

Notes:

Only KoS entries are imported
Existing KillOnSight entries are not duplicated
Imported notes/reasons from Spy are stored safely and do not affect gameplay
KillOnSight behavior and detection logic remain unchanged
You will see chat output when imported , No Spy KoS entries → no chat output

This makes switching from Spy to KillOnSight seamless while preserving your PvP history.

🧠 Smart Data Management

Stats Pruning policy enabled by default
Prevents SavedVariables bloat
Incremental, low-cost pruning
Safe across upgrades

Slash commands available:

/kos statsprune on
/kos statsprune off
/kos statsprune now
/kos statsprune status
/kos statsprune maxentries N
/kos statsprune maxdays N

⚙️ Configuration & UI

In-game configuration panel
Scrollable options UI (no overlap)
Clear section headings:
KoS / Guild
Nearby
Stealth Detection
Changes apply live where possible
Minimap icon with tooltip and click support

🆕 Import KoS from VanosKoS

Download offline importer KillOnSight-VanosKoS-Importer.zip from here: VanasKoS Importer
Instructions on how to use are in the README
All your KoS lists can be imported offline since VanosKoS no longer works

🌍 Localization

KillOnSight includes complete translations for all supported locales.

Supported languages:

🇺🇸 English (enUS)
🇩🇪 German (deDE)
🇫🇷 French (frFR)
🇪🇸 Spanish (esES)
🇲🇽 Spanish – Latin America (esMX)
🇧🇷 Portuguese – Brazil (ptBR)
🇵🇹 Portuguese – Portugal (ptPT)
🇮🇹 Italian (itIT)
🇷🇺 Russian (ruRU)
🇵🇱 Polish (plPL)
🇰🇷 Korean (koKR)
🇨🇳 Chinese – Simplified (zhCN)
🇹🇼 Chinese – Traditional (zhTW)
🇯🇵 Japanese (jaJP)

All locale files contain the full key set — no missing strings, no fallback errors.

🧩 Supported Game Versions

Retail (Mainline)
Classic Era / Anniversary
Burning Crusade Classic
Wrath of the Lich King Classic
Mists of Pandaria Classic

⚙️ Slash Commands

/kos            – Open main UI
/kos add        – Add a player to KoS
/kos remove     – Remove a player from KoS
/kos clear      – Clear KoS list
/kos prune      – Pruning controls
/kos help       – Show full command list

Performance & Safety

No protected API calls
Combat-safe logic
Throttled detection paths
No excessive OnUpdate usage

⚠️ Retail 12.0.x (Midnight) API Restrictions – Important Notes

World of Warcraft Retail 12.0.x (Midnight / pre-expansion) introduced significant API restrictions that affect what addons are allowed to detect and automate.
As a result, some KillOnSight some features that existed in earlier versions are no longer technically possible on Retail.

What changed

Blizzard removed or restricted several APIs that addons previously relied on, including:

Unfiltered combat log access
Indirect detection of unseen or stealthed players
Certain protected targeting behaviors during combat

These changes are enforced at the client level and cannot be bypassed by addons.

What this means for KillOnSight on 12.0.x

❌ Stealth detection

KillOnSight cannot detect stealthed players on Retail 12.0.x
This is not a bug — the required combat log signals no longer exist
Stealth-related options have been fully removed from the UI to avoid confusion

✅ Nearby list now reflects visible enemies only

Players appear in the Nearby list based on:
Nameplates
Target / mouseover interaction
Disabled in BG's

There is no “radar” or hidden detection in Arena or Battleground and limited detection outside.

🆕 Import KoS from Spy (Midnight Only)

Download offline importer KillOnSight-Spy-Importer.zip from here: Spy Importer
Instructions on how to use are in the README
All your KoS lists can be imported offline since spy no longer loads on Midnight

Summary

KillOnSight has been updated for Retail 12.0.x to:

Respect Blizzard’s new API limits
Remove non-functional or misleading features
Focus on reliable, visible-enemy tracking and usability

If you remember features from older versions that are no longer present, this is due to Blizzard API changes, not addon abandonment or bugs.

Kill on Sight