Get an Epic Experience with Premium


Achievements Login to Add Favorites
  • World of Warcraft
  • 493,271 Monthly Downloads
  • Supports: 5.4.8
  • 20,476,592 Total Downloads
  • Updated 08/25/2014
  • Created 06/06/2009
  • 9,628 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-08-25 19:12:48 -0500


James D. Callahan III:
    - Moved CacheWarnings option to global from per-character.
    - Cleanups
    - Removed commented-out code.


First Previous Page 55 of 150 Next Last
  • #1952

    i love this addon but is there a way to actually show in the map where is the NPC found? is really hard to localize them some times..

  • #1950

    Great addon, I have been using this addon for a few yrs now.  thanks for making it.  the reason I posting is to see if you can add the Ghostly Pandaren Fisherman #64004 & Ghostly Pandaren Craftsman #64191 to the data base.

     It seem as if I can never get these 2 rare spawn's for the Hidden Treasure achv. questline. I've checked on their location at least a few hundred times to no avail.

    I've tried to add these NPC's to data base via the manual method but it doesnt seem to work .  Again thanks for making this addon.


  • #1949

    I don't know if this has been mentioned before, but there is another way to keep your rare alerts without having to delete your cache. Simply change your creaturecache file to a read only file.

    That's it! Now you'll never have to delete anything, change a script, write a batch file.

  • #1948
    Clearing cache on a Mac

    If you are on Mac and know how to use the Applescript Editor, you can delete the cache file each time you start WoW by doing:

    set cachefile to POSIX file "/Applications/World of Warcraft/Cache/WDB/enUS/creaturecache.wdb"
    tell application "Finder"
        if exists cachefile as file then
            delete file cachefile
        end if
    end tell
    tell application "Finder"
        empty the trash
    end tell
    tell application "World of Warcraft Launcher" to activate

    You may have to adjust the path accordingly if you didn't install it in the default location.  You can also skip the launcher and just tell application "World of Warcraft" to activate and you'll go right to the login screen. This empties the Trash so removes those lines if that is something you want to do manually.

    Last edited by aholtz on 11/1/2012 8:55:36 AM
  • #1946

    Thanks for such a great addon! I have a request, currently on my mini map the item "Kafa'kota Bush" is showing up as nodes even though I no longer have the quest to find them. I checked the filters and there is no listing to remove this item from being tracked. I was wondering if this could be added so I can remove it and no longer see it on my minimap. Interesting on my big map there is no trace of this item. it is just on the mini map.

    Thanks for your help =)

  • #1944

    For the love of God - please please please make it quit going off when the rare is DEAD!

  • #1951

    yimanoy You cant make it not go off when the rare is dead. The creature is loaded into cache regardless.

  • #1943

    I'm getting this error when hovering my mouse over some mobs in pandaria.

    Date: 2012-10-28 03:44:44
    ID: 32
    Error occured in: AddOn: _NPCScan
    Count: 4
    Message: Note: AddOn _NPCScan attempted to call a protected function (CompactRaidFrame12:Show()) during combat lockdown.
    [C]: Show()
    ..\FrameXML\CompactUnitFrame.lua:276: CompactUnitFrame_UpdateVisible()
    ..\FrameXML\CompactUnitFrame.lua:234: CompactUnitFrame_UpdateAll()
    MoncaiCompare, v1.4.0
    Swatter, v4.0.5 (<%codename%>)
    NPCScan, v5.0.0.5
    NPCScanOverlay, v5.0.0.3
    ACP, v3.4
    ArkInventory, v30315
    ArkInventoryRules, v
    ArkInventoryRulesExample, v1.00
    Atlas, v1.22.1
    AtlasBattlegrounds, v1.22.1
    AtlasBurningCrusade, v1.22.0
    AtlasCataclysm, v1.22.0
    AtlasClassicWoW, v1.22.1
    AtlasDungeonLocs, v1.22.0
    AtlasOutdoorRaids, v1.22.1
    AtlasScenarios, v1.22.1
    AtlasTransportation, v1.22.2
    AtlasWrathoftheLichKing, v1.22.0
    AtlasMajorCitiesEnhanced, vv0.13
    BagItemLevel, v1.1.0
    BrokerLocation, v1.6.1
    CooldownCount, v4.0
    Cooldowns, v
    Coordinates, v1.7
    DBMCore, v
    DBMInterrupts, v3.3.2
    DBMLDB, v
    DBMPvP, v
    DBMRaidLeadTools, v
    DBMTheEye, v
    DBMVictorySound, v1.10.00b
    GatherMate2, v1.22
    GoingPriceAllakhazam, v4.0.1291397522-beta
    GoingPriceWowhead, v5.0.1351009454
    GuildSlacker, v1.7
    HealBot, v5.0.5.6
    InboxLooter, v
    junkdrop, vv0.8
    LowHPAlert, v
    MailOpener, vv1.2.16
    NumPadBar, v5.04
    RareAnnounce, v5.0.4.4
    Recount, v
    Reforgenator, vv2.0
    Scrap, v11.4
    ScrapMerchant, v
    ScrapSpotlight, v
    SlideBar, v4.0.5 (<%codename%>)
    StupidMount2, v
    TLootdb, v0.41-5.0
    WhereToNow, v5.0.1
    WhoNeedsThis, v0.36
    XToLevel, v5.0.4_34
    ZoneLevelInfo, v1.6.0
    BlizRuntimeLib_enUS v5.0.5.50001 <us>

  • #1939

    So here we go.


    Date: 2012-10-25 13:28:24
    ID: 2
    Error occured in: Global
    Count: 1
    Message: ...rface\AddOns\NPC_DataBase\NPC_DataBase_Functions.lua line 156:
       attempt to index global 'NPC_Data' (a nil value)
       (tail call): ?
       [C]: ?
      Swatter, v5.14.5335 (KowariOnCrutches)
      NPCScan, v5.0.0.5
      NPCScanAutoAdd, v1.1
      NPCScanOverlay, v5.0.0.3
      NPCScanOverlayBroker, v1.2.0
      AtlasLoot, vv7.03.01
      AtlasLootCataclysm, vv7.03.01
      AtlasLootClassicWoW, vv7.03.01
      AtlasLootLoader, vv7.03.01
      AtlasLootMistsofPandaria, vv7.03.01
      AucAdvanced, v5.14.5335 (KowariOnCrutches)
      AucFilterBasic, v5.14.5335 (KowariOnCrutches)
      AucFilterOutlier, v5.14.5335.5335(5.14/embedded)
      AucMatchUndercut, v5.14.5335.5225(5.14/embedded)
      AucStatHistogram, v5.14.5335 (KowariOnCrutches)
      AucStatiLevel, v5.14.5335 (KowariOnCrutches)
      AucStatPurchased, v5.14.5335 (KowariOnCrutches)
      AucStatSales, v5.14.5335.5335(5.14/embedded)
      AucStatSimple, v5.14.5335 (KowariOnCrutches)
      AucStatStdDev, v5.14.5335 (KowariOnCrutches)
      AucStatWOWEcon, v5.14.5335.5335(5.14/embedded)
      AucUtilAHWindowControl, v5.14.5335.5133(5.14/embedded)
      AucUtilAppraiser, v5.14.5335.5335(5.14/embedded)
      AucUtilAskPrice, v5.14.5335.5160(5.14/embedded)
      AucUtilAutoMagic, v5.14.5335.5335(5.14/embedded)
      AucUtilCompactUI, v5.14.5335.5335(5.14/embedded)
      AucUtilEasyBuyout, v5.14.5335.5238(5.14/embedded)
      AucUtilFixAH, v5.14.5335 (KowariOnCrutches)
      AucUtilItemSuggest, v5.14.5335.5335(5.14/embedded)
      AucUtilPriceLevel, v5.14.5335.5237(5.14/embedded)
      AucUtilScanButton, v5.14.5335.5335(5.14/embedded)
      AucUtilScanFinish, v5.14.5335.5153(5.14/embedded)
      AucUtilScanProgress, v5.14.5335.4979(5.14/embedded)
      AucUtilScanStart, v5.14.5335.5153(5.14/embedded)
      AucUtilSearchUI, v5.14.5335.5335(5.14/embedded)
      AucUtilSimpleAuction, v5.14.5335.5208(5.14/embedded)
      AucUtilVendMarkup, v5.14.5335.4828(5.14/embedded)
      Babylonian, v5.1.DEV.312(/embedded)
      BagBrother, v
      Bagnon, v5.0.6
      BeanCounter, v5.14.5335 (KowariOnCrutches)
      Configator, v5.1.DEV.330(/embedded)
      DBMCore, v
      DebugLib, v5.1.DEV.312(/embedded)
      Decursive, v2.7.2.2
      ElvUI, v4.57
      ElvUIAtlasLootSkin, v2.0
      Enchantrix, v5.14.5335 (KowariOnCrutches)
      EnchantrixBarker, v5.14.5335 (KowariOnCrutches)
      FishingBuddy, v1.1f
      GatherMate2, v1.22
      Informant, v5.14.5335 (KowariOnCrutches)
      kGratz, v0.2
      LibExtraTip, v5.12.DEV.324(/embedded)
      MillHelp, v2.0.10
      MillHelpGlyphs, v2.0.10
      NPCDataBase, v1.2
      PetBattleTeams, v2.4.10
      PetCaught, v1.1
      PetJournalEnhanced, v2.5.0
      Postal, v3.5.0
      Prospect, vv201210250038
      Recount, v
      SlideBar, v5.14.5335 (KowariOnCrutches)
      Stubby, v5.14.5335 (KowariOnCrutches)
      TipHelper, v5.12.DEV.315(/embedded)
      WIM, v3.6.2
      WIMElvui, v
      ZygorGuidesViewer, v4.0
      BlizRuntimeLib_enUS v5.0.5.50001 <us>

  • #1938
    Independant Databasing

    _NPCScan would be a lot better to use if you separated all of the IDs into one big database.lua file as oppose to in the actual coding as it stands now.. 

    Last edited by JonathanR_B on 10/25/2012 1:29:04 PM
  • #1942

    The functions in the code only create a default DB to get people started. They aren't actually a DB. The DB itself is in your character's SavedVariable file. Having the DB character based rather than hard linked to the program is far better than a master DB as it allows people to customize what NPCs they track per character. So you don't have to be bothered by a rare Hunter Pet when playing your Pally but can still get an alert for than NPC when you're on your Hunter.

    The intent of the program is that you populate it with whatever NPCs you find important rather than to track every rare or notable NPC in the game at all times. 
    It'd actually be better if it didn't have any NPCs included at all. But that would lead to the author being bombarded with "I installed it but it's not doing anything!! FIX IT!!" complaints. So he's provided the best compromise possible by including only the most commonly tracked rares such as those required for achievements.

    If you want a master DB (or a custom one) however, you can use to easily facilitate that.

  • #1935

    Delete the cache the easy way...everytime you boot your PC or on demand

    Create a .bat file as follows and add it to your startup folder (google anything you dont understand..)

    For windows 7, adjust for your own directory.

    echo off =================================

    CD "C:\Program Files (x86)\World of Warcraft\Cache\WDB\enUS"

    del /q /f /s *.*


  • #1947

    If windows is not located on the c: drive, that bat file will not work as intended.

    CD "C:\Program Files (x86)\World of Warcraft\Cache\WDB\enUS"
    CD "\Program Files (x86)\World of Warcraft\Cache\WDB\enUS"



  • #1945

    Or..  You could create a bat file to delete the createurecache which is all that's needed and then have it launch the game.  This way every time you start the game it resets the cache.  

    del "C:\World of Warcraft\Cache\WDB\enUS\creaturecache.wdb" /q /s> nul

    start "" "C:\World of Warcraft\Wow.exe"

  • #1934

    Okay my NPC scan went off for an Outland Rare Elite Coilfang Emissary and I could not find her or even a body of her. What do I need to do to fix this problem or is it glichted?

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

Alienware Alpha Giveaway!