Get an Epic Experience with Premium


Achievements Login to Add Favorites
  • World of Warcraft
  • 537,483 Monthly Downloads
  • Supports: 5.4.8
  • 19,939,767 Total Downloads
  • Updated 07/10/2014
  • Created 06/06/2009
  • 9,522 Favorites
  • Project Site
  • Comments
  • Release Type: Release
  • License: GNU General Public License version 3 (GPLv3)
  • Newest File:
Support development! **

About _NPCScan

_NPCScan tracks seldom-seen rare mobs by proximity alone, making the old “/targetexact …” macros obsolete. It has the same range as those targeting macros, but you won't have to mash any buttons. Just go about your business and let _NPCScan alert you when it finds something.

V5.x Changes
  • Due to changes in how the addon stores data, some settings might get reset when updating.
  • The default alert is suppressed while on flight paths by default. If a mob is found, the whisper sound effect will play and the mob & location will be placed in the chat log. You can turn this off from the settings.
  • _NPCScan now includes all rare mobs in the game.
  • The "One of Many", "Timeless Champion" & "Champions of Lei Shen" Achievements have been added.
  • Rare Mobs and Tameable Mobs have their own tabs now.
  • Custom mobs have been added for the Ghostly Pandaren Fisherman & Craftsman.
  • Individual mobs can be removed from their tabs to stop tracking them.

If you have a question check the FAQ, or a problem create a ticket

If you have a question/comment about _NPCScan.Overlay please post it in it's comment section.



NPCScan now tracks "vignettes". These are the little skulls appear on the minimap, that denote rare mobs. This is a beta feature and is disabled by default. Enabling this feature will alert you to a rare that's within minimap range, without any worries about having to clear your cache. When you get an alert you will be shown a target button similar to the standard mob alert, letting you know that a vignette mob was detected. Clicking on the target button will try and target the mob. Once a mob is targeted, the target button will update to reflect the mob found.

Known Issues: Currently there is no way to detect what mob the vignette represents. Because of this there is no way to filter out and ignore individual mobs. The vignette tracking will ignore achievement mobs groups that have their tracking turned of via unchecking their tab. Also the targeting button might have some issues if there are more than one vignette mobs in target range and may not work 100% of the time.

The Cache

This addon doesn't use nameplates or mouseover units to find rares. Instead, it checks your creature cache for the moment a rare mob is found. There is one catch to this technique however: Once a mob is “found”, _NPCScan won't be able to find it again until your cache is clearedf you find a rare mob's corpse—Dirkee for example—you would have to clear your cache before _NPCScan would find Dirkee again. Thankfully, clearing your cache is a safe and simple matter.

Clearing Your Cache

To clear your cache, follow these straightforward steps:

  1. Exit World of Warcraft
  2. Delete the “Cache” sub-directory inside your World of Warcraft folder.  For example on a standard Windows XP installation, you would delete the folder “C:\Program Files\World of Warcraft\Cache”.
  • Advanced users can delete “C:\Program Files\World of Warcraft\Cache\WDB\enUS\creaturecache.wdb” specifically to improve log-in times, where enUS is your language code.

Note: Windows Vista and Windows 7 users see this info if your cache isn't in the location above.

That's it. Log in after you've done that and you'd be able to find Dirkee a second time. It's completely safe because WoW will recreate your Cache folder after you log in again.

Cache Warning

If a rare mob is already cached when you log in, _NPCScan will print a warning message with the names of those mobs. If you see this message but still want to find the listed NPCs again, it's time to clear your cache by following the above procedure; Otherwise, you can quit searching for those mobs using the Search options window detailed below. You can suppress this log-in message using the main options pane, as well.

“Found” Alert

When a rare mob is found, _NPCScan alerts you by playing a loud and distinctive sound, making your screen pulse red, and displaying an animated Targeting Button. To get a feel for what this alert looks and sounds like, try the “Test Found Alert” button in the addon's main Interface Options panel. (See the Options section below.)

Targeting Button

When clicked, the targeting button tries to target the most-recently-found mob.  You can also bind a key to hit this button. If the default button position isn't to your liking, you can move it while holding your CTRL key.

Note: The button cannot be shown during combat. In the unlikely case that you do find a rare while fighting, the button will appear after you leave combat. You will still hear the alert however, and the name of the mob will appear in your chat log.


_NPCScan's main options window can be accessed from the Interface Options menu. This panel includes a “Test Found Alert” button, various ways to customize the alert sound, and an option to suppress cache warning messages on log-in. New sounds can be added to the alert sound dropdown menu by installing SharedMedia-type addons.

Search List

The list of mobs that _NPCScan searches for can be modified easily through the Interface Options panel, however it comes pre-configured with most rare Outlands and Northrend mobs.; To access the mob list, type “/npcscan”. Grayed out NPCs in a list aren't being searched for, either because they're cached or not needed for their achievement.

The first tab available lists Custom NPCs that you can enter or remove manually. NPCs that are already cached show a red “X” in the first column. You can add or remove Custom NPCs with the [+] and [-] buttons at the bottom right.

All other tabs control achievements like Bloody Rareand Frostbitten. These tabs show an additional column on the right with green check marks for completed achievement mobs. You may enable or disable tracking each achievement with its tab's checkbox.

To remove non custom mobs from a tab, click on the mob that you want to remove and then click on the "Remove" button. This will remove the selected mob from the current tab and add it to the Ignore List Tab. If you ever want to restore a Ignored Mob, select it from the "Ignore List" tab, click the "Remove" button and it should be added back to its original tab.

The “Search for completed Achievement NPCs” checkbox at the top left of the pane allows you to keep looking for mobs you no longer need for achievements.

Finding NPC IDs

A mob's NPC ID is its unique identification number, and it can be found on sites like WowHead or WowDB For example, search for the mob “Dirkee” on WowHead and go to the mob's page.  That page's URL will look like

32500 is Dirkee's NPC ID.


The only problem mobs for _NPCScan are tamable beasts & Battle Pets. Whenever you run across the tamed version, _NPCScan gets tricked into thinking that mob is nearby. In order to prevent those false positives, _NPCScan only shows alerts for tamable mobs in their original zones That is, if you spot Loque'nahak in Dalaran instead of Sholazar Basin where it usually patrols, _NPCScan would ignore it. When one of these tamable mob false-alarms happens, you'll see a message in your chat window explaining why it got ignored.

Since this makes tamable mobs are so difficult to track, I suggest you fly to the tamable mob's zone first, clear your cache, and then search for it.; Any time you pass through a populated area like Dalaran, you risk filling your cache with popular rare pets.

For Battle Pets there is no way for it to determine if a mob is a spawn or someone's pet. Many Battle Pet addons and just opening the Pet Journal will often cause Battle Pets to become cached.

James D. Callahan III <>
2014-07-10 21:36:39 -0500


    - -Fixed issue where rare mobs and beasts would not be enabled on login/reload
    - -Added delay timer to vignette alert
    - -Fix for tab tooltip enable/disable state not matching actual state
    - -Fix for options not saving off state
    - Fixed error on mouseover when in pet battles.  Ticket 63 Increased the delay before re-showing an alert when triggered by a mouseover to 5im (was 15 sec)
    - typo
    - Fix for Bro'Gaz the Clanless setting him as a non achievement mob
    - Added toggle option for mouseover alerts to option menu Moved some alert option from the search page to the alert page Added mouse over alert check if mob is alive before triggering alert
    - added code to trigger alert on mouseover updated debug code to update debug frame when new debug message is added Updated how saved variables are handled to help when adding new variable and to prevent saved variables from being reset when the addon does not load completely. cleaned up vignette code
    - Updated the  5 Madexx localizations to include the color of the spawn.


First Previous Page 5 of 148 Next Last
  • #2794

    The latest version push has broken the addon, at least for me. 

    Upon login, NPCScan is disabling itself by unselecting all searches (under options -> searches), e.g. Bloody Rare, Frostbitten, etc.  It also clears the list of custom NPCs automatically at login.  I've re-added several mobs to the custom list and verified it is blank when I relog.

    I've cleared the cache and tried this on different toons and had the same results.

    I've no doubt a fix will come, curious about any chance of restoring the custom list.



    Last edited by matt0717 on 5/4/2014 9:31:11 AM
  • #2795

    Thanks for the heads up, it should be fixed in the next alpha.  Unfortunately there is no way to restore the lost custom list as it was overwritten in the saved varibles.  You might want to check in the WOW's saved variable folder to see if there is a recent NPCScan.lua.bak file, as WOW occasinally backs up the files.  Its one of the perils of  using an Alpha version that occasinally the aren't stable and might cause settings to be lost.

  • #2796

    Thanks for the info =)  I shoulda realized that I had prefs for that addon set to Alpha.  Not sure why I did.  Uninstalled/reinstalled with release version, everything works fine.  Some stuff on the custom list came back, and I will add the rest.  Sorry for the trouble =)

    Last edited by matt0717 on 5/5/2014 6:30:06 AM
  • #2793

    One thing I'm finding troublesome is the little name list, in relation to my Carbonite Minimap, I mouse over it a lot, and every time the list comes out. I can't move it easily out of the way due to to it disappearing when the map isn't hovered over, and have no way to disable it. Also, when it's not highlighted, it still shows the x's for the discovered rares.

    Is there any way to remove this list, at least during times I'm not using it? Generally I want to see rare mob paths but don't need their names...

  • #2789

    Hey guys, love this addon, but a guildmate & I found a problem. Every time we fly from Warsong Hold in Borean Tundra to Nesingwary's camp in Sholazar, we get an alert that Loque'nahak has been spotted, but he's nowhere in the area, or even in the zone at the time. We're on Eonar Horde side, if that makes any difference. We both have tried it, both get the same thing, same coords (20, 73) every time. Any advice or help would be appreciated. P.S. I doubt it's a phasing issue, she's done every quest in the zone, my character only did enough to open Nesingwary's flight point to run the test. I will say I've run this addon ever since I first heard about it years ago & never seen anything quite like it, other than occasionally with "phased" rares.

  • #2790

    Are you using the flightpoint when traveling?  If so then you are probably detecting it on another server.  Due to how the cross relm zones work, often you will be transfered to another server after landing.  IE Tundra is CRZ for server A, while Sholazar is CRZ for server B.  Usually you shift servers when crossing the zone border, but when using a flight path it is delayed until you land.  This may cause a mob to get triggered due to being spawned on server A when on a flight path, but not being there after landing due to being moved to server B.  I often see this with battle pets, as there will show up on the minimap, but dissapear after landing.

    Last edited by SLOKnightfall on 4/21/2014 6:00:59 PM
  • #2792

    As its only happening in one direction its definately triggering from a CRZ.  Your on server A from the flight to Sholazar and travel through Server A's Sholazar zone while flying. The mob is up on A so it gets triggered.  When you land you get move to Server B's.  The flight back will be throught Server B's zones, untill you land and are moved back to Server A on landing. As the mob is not spawned in Server B it would not trigger during the flight back.

  • #2791

    That's possible but it happens every single time she & I taxi in to Sholazar, but never when we taxi out. SHe's had it happen 3 or 4 times herself, for me only 1 or 2 while testing it out.

  • #2787

    Just released a new version ( with the missing localization, which should fix the issues.

    Last edited by SLOKnightfall on 4/19/2014 11:54:08 AM
  • #2785

    The localized name for 'Portent' isn't in the enUS locale file (at least - didn't check any others). If you're feeling brave 8^) go into the addon folder, then edit Locales/Locale-enUS.lua (or whatever your locale is) and add

        ["50843"] = "Portent",

    into the list with the others, and it'll be fixed.

  • #2781

    I HAVE PROBLEM, HELP PLS! I put NPCScan in Addon file, and in game it works, but only thing that doesnt show is search.... so its bassicly not working any help?


  • #2780

    Fantastic tutorial here for anyone having trouble:;feature=iv&amp;src_vid=Z7jgbc_WfYE&amp;v=UCuhrlBO_eo

  • #2778

    This addon had the greatest sound alert ever: Zoidberg wooping! It was working just fine until maybe a little over a week ago approximately. I re-installed the add-on but it's still gone.    ):  Was this taken out intentionally? Should I install an earlier version? I really loved Dr. Zoidberg's constant wooping's, they hit pretty close to home. A fix would literally make my day, thanks!!



    Edit: Doh'!!! I messed up. It was coming from VanasKoS!  I had it disabled on one of my accounts! I always forgot 'VanasKos' was in front of "zoidberg woop". Selective reading, I guess. But it's cool that it imported the sounds from VanasKoS! Very cool!

    I reccomend if you want an addon that constantly spots friendly and enemy players as they load in, and a neat little blacklist and alarm, plus a zoidberg bonus alarm to NPCscan, I reccomend you also get vanaskos, it's radical as f word!

    Last edited by Kornesczuk on 3/27/2014 7:23:14 PM
  • #2779

    NPCScan has never included any alerts and uses in games files for its  default alerts.  It was most likely part of another addon that used LibSharedMedia also.  Check any addons that you recently deleted/disabled and you'll likely find the source of the sound file.

    Last edited by SLOKnightfall on 3/27/2014 7:11:57 PM
  • #2776

    What si teh range of NPC_Scan and is it automatic?

  • To post a comment, please login or register a new account.
Login to Curse

Don't have an account? Create One.

Get an epic experience with Curse Premium
  • Faster addon downloads
  • Premium-Only Beta Giveaways
  • Ad-Free Curse experience
  • Premium Curse Client
  • and many More Features
  • Learn More »

Landmark Beta Key Giveaway!

Get My Code!