Get an Epic Experience with Premium


Achievements Login to Add Favorites
  • World of Warcraft
  • 257,285 Monthly Downloads
  • Supports: 6.2.3
  • 33,710,141 Total Downloads
  • Updated 02/08/2016
  • Created 06/06/2009
  • 11,473 Favorites
  • Project Site
  • Comments
  • Release Type: Release
  • License: GNU General Public License version 3 (GPLv3)
  • Newest File:
Support development! **

About _NPCScan

_NPCScan helps you find rare mobs through the use of dynamic target macros, mouse over alerts and for Vignette mobs proximity. Once a mob is found by one of these methods an on screen alert is displayed, in addition to an audio alert.

_NPCScan & Warlords

Due to changes in how the game caches mobs in WoD, it is looking like _NPCScan will no longer be able to auto detect non-Vignette mobs. Due to this the only way to find pre-MoP rares via _NPCScan will be via mouse over, nameplate, or the new dynamic target macro keybind being added. The new keybind will trigger a /targetexact …” macro that updates with tracked mobs based on the zone you are currently in. Vignette mobs will still automatically trigger an alert when the mob gets in range, and should work more reliably due to updates to the Vignette API.

V6.x Changes
  • Cache Scanning Removed - Due to changes in the way WoW cache mobs, NPCScan can no longer auto alert when mobs are nearby like it use to.
  • Dynamic TargetExact Macro Keybind - NPCScan now has a keybind you can set that will try to /exacttarget tracked mobs. This macro will dynamically update based on the zone you are in and which mobs are being tracked.
  • Updated Vignette Alerts - Vignette Alerts are now more reliable and show the actual mob when detected the majority of time.

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.


Dynamic Target Keybind

NPCScan now includes a keybinding that will trigger a stored dynamic target macro. Each time it is pressed, the keybind will trigger a /targetexact <mob name> for every tracked mobs in the current zone you are in, in addition to any custom added mobs. This macro will be auto updated based on the zone you are currently in. To access this feature, just set a keybind under the Key Bindings->Addons->_NPCScan->Dynamic Target Macro section. Note: To search via the keybind, you will need to continuously push the bind. Pushing it once will only trigger it once, it does not auto scan like it did Pre WoD.


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.


If you have nameplates turned on, NPCScan now has the ability to trigger alerts off them. This method is not completely reliable as it has to rely on name comparison, so if mob name that NPCScan has does not match it will not trigger an alert. Also the range is limited as you need to get close enough to a mob to have the game display its name plate.

Addons that modify nameplates may interfere with this.

“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.&nbsp; 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 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.&nbsp; That page's URL will look like

32500 is Dirkee's NPC ID.

James D. Callahan III <>
2016-02-08 04:43:44 -0600

Localization updates.


No changelog


First Previous Page 87 of 182 Next Last
  • #1957

    NPC Scan doesn't list the location of "The Razza" the rare white Chimaera in Feralas  It floats around 84 / 49.  Doesn't seem to patrol.

  • #1956

    Feature Request:

    Is there any way this could search for objects as well.  Would love to use NPCScan to track Lost&Found objects as well.

  • #1955
    Quote from Autotaz7 »

    She was not even visible.. My NPC Scan went off for another Rare Elite in the Outland and that rare was nowhere in site also. I think it is glitched or something. >.>

    Well I deleted the addon and re-installed it. I also noticed that when it goes off I am on a flight path. I always return to the location it goes off. After re-installing it I went back to the location and Doomslayer was nowhere to be found. I couldn't even see him visually.

    Just wanted to add that I have also had this problem and I believe it has to do with the cross-realm zones. Not sure if anything can be done to prevent NPCscan from scanning while on a flight path but if so this would help prevent these false positives as odds are good that the flight paths are traveling through some kind of wierd non-player environment which would explain why the rare's are alive and not dead.

  • #1953
    Move _NPCScan Frame?

    Is there an option to somehow move the frame that shows the NPC with the NPC's model and the ribbon behind the NPC's name? If not, there should really be a way implemented.

  • #1962

    if you use the test found alert button in the options you can then drag the pop up with your mousewhile holding ctrl.

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

Darkest Dungeon Wiki Editing Contest