Get an Epic Experience with Premium


Achievements Login to Add Favorites
  • World of Warcraft
  • 1,476,047 Monthly Downloads
  • Supports: 6.0.2
  • 22,377,100 Total Downloads
  • Updated 10/24/2014
  • Created 06/06/2009
  • 9,957 Favorites
  • Project Site
  • Comments
  • Release Type: Release
  • License: GNU General Public License version 3 (GPLv3)
  • Newest File:
Support development! **

About _NPCScan

If you care at all about my wishes, you won't download this AddOn from SolidIce: They are leeching it from the site I actually choose to put it on.

_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 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.
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.

“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 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.

James D. Callahan III <>
2014-10-24 21:50:34 -0500


    - -Added check to prevent macro generation when in combat and to delay
    - -Fix for toast not showing up on the test alert
    - -Fixed target macro so it gives an alert if mob is found -Added check if a mob's alert is all ready shown before triggering another.
    - -Fix for vignette not placing raid icon over target. -Update to Bai'Jin the Butcher's name from Bai-Jin the Butcher


First Previous Page 1 of 156 Next Last
  • #3002

    when using vignette to alert for nearby rares, instead of finding "Nalash Verdantis" it finds "Nelash Verdantis" and I can't target through the icon, if I mouse over Nalash afterwards it corrects itself to Nalash instead of Nelash and works normally. does this have something to do with localization names?

  • #3003

    Yes it does.  The behind the scenes process is that the addon gets the mob's id, looks up its name in the localization file, then sets a /targetexact <Mob name> macro.  A lot of the localization comes from Wowhead's database, but even then that is not 100% accurate, as I've noticed a few mob's names have changed with the 6.0 patch and are not changed on Wowhead.

    Last edited by SLOKnightfall on 10/24/2014 5:09:15 PM
  • #3000

    dunno if am the only one here , but i noticed  NPC_scan no longer able to put a marker on the mobs it finds , i can click the box aslong as i want noting will show up ..... , easier to see with an icon :p 

  • #3001

    Its a known issue and is fixed on the alpha build.  It just has not been bundled into a new release version yet.

  • #2996


    I tried the script as posted below: /run print(_G._NPCScan.macrotext)

    in Abyssal Depth and it showed the two rares that will spawn there but not Poseidus.

    Anyway I could somehow add it to the dynamic macro? Thanks!

  • #2997

    Nice catch.  Due to him being in multiple zones, I'll have to add some code to add him to the macros of for the other zones.  A quick fix would to be to add him to the custom mob list.

  • #2995

    is it possible to use "dynamic target" macro instead keybind ?

    something like /seekrare


  • #2998

    I believe so.  I'll look into it and update once I get more info.

  • #2994

    Hey, i wonder if it would be possible to put in a option so when you press the ESC button, you also close the little popup Window ?

    Or else a option for muting sound again after playing the announcement sound ?

    Else keep up the good work :D

    Last edited by MartinL on 10/22/2014 11:21:41 PM
  • #2993

    if theres ever a way to get alerts working again for old rares like time lost and posedius, then i'll take anything even if it is alerted by name plates.

  • #2990

    Where can i see what ID mobs are listed in Dynamic TargetExact Macro Keybind ?

  • #2991

    When you bring up the NPCScan option menu, all the hightlighted mobs that are in your current zone, plus any custom mobs are in the macro.  To see an exact list you can type the following command in the chat window to get a printout of the macro text: /run print(_G._NPCScan.macrotext)

  • #2985

    I added a hotkey for the Dynamic Target macro yesterday, and had no issues while camping a rare in the Vale. Today however I am getting the following error when using the same hotkey:

    "Message: [string "_G._NPCScan.CheckMacroT"]:1: '=' expected near '<eof>'
    Time: 10/20/14 12:48:35
    Count: 4
    Stack: [C]: ?
    [C]: in function `RunScript'
    Interface\FrameXML\ChatFrame.lua:2091: in function `?'
    Interface\FrameXML\ChatFrame.lua:4387: in function `ChatEdit_ParseText'
    Interface\FrameXML\ChatFrame.lua:4041: in function `ChatEdit_SendText'
    Interface\FrameXML\ChatFrame.lua:2686: in function <Interface\FrameXML\ChatFrame.lua:2679>
    [C]: in function `RunMacroText'
    Interface\FrameXML\SecureTemplates.lua:463: in function `handler'
    Interface\FrameXML\SecureTemplates.lua:649: in function <Interface\FrameXML\SecureTemplates.lua:597>

    Locals: "


    The hotkey still works and even when giving an error targets the rare, but it is rather annoying :X

  • #2986

    Strange.  From the looks of the error report, the part of the command looks like it is cut off when generating the macro.  I’ll look into it this evening when I have some free time.  What mob were you trying to camp?  Most of the MoP mobs in the vale have vignettes displayed on the minimap and can trigger alerts with the vignette tracking option in the settings menu.

  • #2999

    Thanks for tracking down the issue and the info. I'l look into it.  I've got a few ideas on how I might be able to rework it to get arround the character limits.

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

Line Your Pockets: Steam Wallet Giveaway