Get an Epic Experience with Premium


Achievements Login to Add Favorites
  • World of Warcraft
  • 530,923 Monthly Downloads
  • Supports: 5.4.8
  • 19,944,139 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 2 of 148 Next Last
  • #2850

    I dont know if i did this correctly, but everytime i type /npcscan nothing comes up except asking me to type /help for a list of commands. i enabled the scan for my character, clicked on using out of date add ons. theres teh option for npc scan in teh interface options but that is it. am i using this wrong. ive never used add ons before. also downloaded overlay but dont think it is working eitehr. please help thank you

  • #2848

    It seems that updating to (July 10th) has deleted my _NPCScan.Overlay directory from Addons.

  • #2849

    They're completely separate AddOns. If .Overlay was removed, either the Client malfunctioned somehow or you deleted it accidentally.


  • #2847

    THanks for updating madexx rare in uldum

  • #2843

    Date: 2014-07-10 00:54:58
    ID: 1
    Error occured in: Global
    Count: 1
    Message: ..\AddOns\_NPCScan\_NPCScan.lua line 961:
    attempt to index field 'NPCs' (a nil value)
    (tail call): ?
    self = <unnamed> {
    0 = <userdata>
    PLAYER_LEAVING_WORLD = <function> defined @Interface\AddOns\_NPCScan\_NPCScan.lua:1040
    ACHIEVEMENT_EARNED = <function> defined @Interface\AddOns\_NPCScan\_NPCScan.lua:1055
    ZONE_CHANGED_NEW_AREA = <function> defined @Interface\AddOns\_NPCScan\_NPCScan.lua:1067
    PLAYER_LOGIN = <function> defined @Interface\AddOns\_NPCScan\_NPCScan.lua:929
    CRITERIA_UPDATE = <function> defined @Interface\AddOns\_NPCScan\_NPCScan.lua:840
    PLAYER_UPDATE_RESTING = <function> defined @Interface\AddOns\_NPCScan\_NPCScan.lua:740
    PLAYER_ENTERING_WORLD = <function> defined @Interface\AddOns\_NPCScan\_NPCScan.lua:985
    event_name = "PLAYER_LOGIN"
    stored_options = <table> {
    Achievements = <table> {
    Version = 3
    CacheWarnings = true
    stored_character_options = <table> {
    NPCs = <table> {
    Version = ""
    NPCWorldIDs = <table> {

    Last edited by SLOKnightfall on 7/10/2014 10:20:00 AM
  • #2842

    I tried everything to delete my cache, including a search for creaturecache.wdb, which I found in several locations. Finally, I threw away the NPCScan folder in my Addons folder, deleted my cache, reinstalled NPCScan, restarted the game, and except for 1 rare (Shadowclaw), there were no dreaded red "X's" seen. 
    Unfortunately, when I logged out and back, there were all the "X's" again. 
    Will NPCScan cache a rare hunter pet if I have it on another toon?

    Last edited by rpalmeri on 7/10/2014 1:08:13 AM
  • #2846

    Actually it the game does cache all pets a hunter has available to summon via "Call Pet" when the player logs in. If one of them is in the rare list, then it gets marks as cached.

    Last edited by SLOKnightfall on 7/10/2014 11:53:47 PM
  • #2844

    No, it does not cache pets from an alt.

    I run a bat file that I run when I start WoW that deletes the cache every time I start the game.

    @echo off
    del Cache\WDB\enUS\creaturecache.wdb
    start C:\"Program Files (x86)\World of Warcraft\World of Warcraft Launcher.exe"

    Last edited by SLOKnightfall on 7/10/2014 11:53:03 PM
  • #2838

    I have the latest version installed and I am searching for the Mysterious Camel Figurine. After 3 weeks I started to get paranoid that my NPC Scan was not alerting me that they were there, so I started searching manually trying to eyeball the little camels.

    Sure enough, I found one manually and NPC Scan did not trigger an alert. My cache was cleared, and nothing was out of the ordinary. NPC Scan was also working for other mobs in the zone (the armadillo for example) and all over the world (Northrend rares, Outland rares, Timeless Isle rares, etc.).

    I'm not sure if it's a bug with the current build of NPC Scan or some sort of incompatibility with another addon. I tried removing the NPC Scan Overlay addon and I've continued searching, but I haven't come up with any yet (but it's only been 2 days). Testing it is rather tough given the spawn rate of the camel figurines, I was wondering if anyone else is encountering this problem though, and if so, how they have fixed it. Thanks!

    EDIT: I wanted to follow up to say that I deactiavted all addons except for NPC Scan and the Mysterious Camel Figurine DID register. It looks like NPC Scan had a conflict of some sort with another addon, or something was configured improperly.

    If you're running into this same problem, I'd recommend deactivating other addons other than NPC Scan, clearing your cache, and then searching.

    Last edited by Sholoshka on 7/7/2014 12:08:48 AM
  • #2840

    Check in the settings that the "World" setting in the list is displaying Kalimdor.  Others have reported similar issues and the problem that the "World" was set to something else or was in all caps.  If the world is not set correctlth then the addon won't search for it, as it thinks the mob is not in the current continent.  If the mob name in the settings list is bright yellow then it should be monotoring for the mob being added to the game cache.

  • #2841

    This makes sense. Thanks for sharing. I am still (out of paranoia mostly) just disabling all addons other than NPC Scan and searching for it that way. I checked the world and it is "Kalimdor" so it is all good to go. Thanks for clearing this up!

  • #2836

    Is there any way to turn on map markers for vignette spawns?

  • #2837

    I'm not sure what map markers you are talking about.   Vignette mobs have a default game UI (Skull icon) that shows in the minimap that NPCScan has not controll over.  If you are looking for spawn and route's then use NPCScan.Overlay, which adds that to the map for the majority of the rare mobs in the game.

  • #2831

    Great addon, only problem is that i downloaded to find a specific tameable rare beast and it isnt on the list. Loque'nahak. I'll try to get it by spamming a macro but just letting you know.


  • #2853

    Loquenalak is on the frostbitten list IIRC because he is part of the acheivement


  • 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 »

ArcheAge Beta Key Giveaway

Get My Code!