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:

1. Enable Spy

2. Log in once (or /reload)

3. Run: /kos importspy

4. (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.