LyreAB’s DotD Raid Catcher Script Guide

Frequently Asked Questions

Installing the Script

Using the Raid Catcher

Options and Filters

Importing Raids

Joining Raids

Understanding Raid Info

Additional Functions

This guide was written because of the frequency of questions and confusion that arises in chat when someone new to the game joins in and everyone tries to guide the poor newbie at the same time.

The guide is split into several sections.  The first section deals with some of the frequently asked questions about the Raid Catcher, and is useful to those who are unfamiliar with it.  The second section deals with how to install the script.  The third section deals with how to make use of the script once it’s installed.  The last section deals with some of the additional functions that you can add to the Raid Catcher which helps in other ways.

Frequently Asked Questions

So, to start off, what is the Raid Catcher Script?  

Well, the Raid Catcher script is a script written by wpatter6 and jHunz for the Mozilla Firefox and Google Chrome browsers, and is designed for the Kongregate and Armor Games versions of the game.  The script is a means to help people get access to the raids that have been posted publically, even though they might not be in the chat room that they are posted in, or even on when the raids are posted.  It does this by gathering up all those raids, as well as the raids which are directly submitted to it, and placing them into a database which it can then pull raids from.  The Raid Catcher script is the evolution of a script which wpatter6 and jHunz originally wrote to collect all the raids that are posted in chat, the SRDotDX script.  That script only collected raids posted in chat, as well as letting you grab from player maintained databases called pastebins if you had a link to it.  The current version of the Raid Catcher makes the old script obsolete, as it grabs raids just like the old one does, and while it doesn’t have built in pastebin support, the universal database it does maintain makes those pastebins obsolete except for private raid databases.

Why does everyone say that it’s something I MUST HAVE?  

Really, it’s not something that every player must have.  It’s something that most people recommend having and using, but it’s not a necessity.  It does make getting access to raids a lot easier, and saves a lot of time.

Is this script really a virus?  

No, this script is not a virus, and it won’t install anything on your computer that will harm it.

I don’t use Firefox or Chrome, can I still use the Raid Catcher?

Unfortunately, the script is designed specifically for Firefox and Chrome, and the programmers do not guarantee that it will work for any other browser.

I’m a Facebook/iOS/Mobile player, can I still use the Raid Catcher?

Again, the script is designed to work with Kongregate or Armor Games only, and won’t work for other platforms.

Where can I get the script?

You can get a link to the script by asking about it in chat from most people, or you can go to 

Why can’t I get any raids?

This will also be covered later in the guide, but the most common reason is that your raid timers have expired.  The script requires that you periodically submit raids of your own in order to get access to the raids that others have posted.  This is so that the database doesn’t run out of raids.

My Raid Catcher still isn’t working!

For help with specific issues not covered in this guide, the best solution is to send a Private Message to wpatter6 or jHunz detailing your problem, or to post in the forum linked to the script’s userscripts web page.

Installing the Script

So, now that you have decided to get the script and make use of it, how do you go about installing it?  Well, if you go to the script page,, there are installation instructions there.

Using the Raid Catcher

Once you’ve installed and gotten the catcher up and running, using the catcher is fairly easy.  The first thing you will need to do is to set it up to get you the raids you want.  The second thing is importing and joining raids.  

Options and Filters

So, how do you set up the Raid Catcher?  First, you will need to set your options and filters.  There are default settings for these, but they may not be exactly what you want, so it’s best to go through them and make sure they are set the way you like.

First select the Raid Catcher tab by clicking on the RAIDS tab that now appears between your GAME and ACHIEVEMENTS tabs at the top of the chat window, like in the picture below.  

This brings you to the Raid Catcher tab, with its many subtabs.  There should be four tabs here: Raids, Importing, Options, and Filters, like in the picture below.  Select the Options tab.

Under the Options tab are three sections of options, RAID LIST OPTIONS, TOOLBAR OPTIONS, and CHAT OPTIONS.  

RAID LIST OPTIONS has currently two options.  

The first option is to hide visited raids in list.  Selecting this option will cause raids that you have visited to not be shown in the list of raids you can join.  This is useful if you only want to see new raids.

The second option is to store raids locally.  What this does is store a listing of the raids that you have imported or seen on your computer, which speeds up importing of new raids.  Considering there are generally tens of thousands of raids in the database at any given time, this can be a real time saver.  Keep in mind though, that even if you store locally, importing for the first time or after you’ve been away from the game for several days can still take quite a while.

TOOLBAR OPTIONS currently has only one option.

The current version of the Raid Catcher also installs a toolbar down at the bottom of your chat window.  This toolbar has buttons for quick importing and joining of raids, reloading of the game window (without reloading chat), and to a webpage with some game stats.  The option here is if you want that toolbar hidden or visible.

CHAT OPTIONS is where you can adjust how raids get displayed in the chat window.

The first option is to hide filtered raids in chat.  Enabling this causes any raid that you have unchecked in your filters to automatically be blocked and not displayed in your chat window.  Useful if you don’t want to even see those raids.

The second option is to hide all raid links in chat.  Enabling this causes all posts in chat with raid links to not be displayed.  This does not hinder the catcher from collecting those raids, they just aren’t displayed in the chat window.

The third option is to hide all seen raids in chat.  Enabling this causes raids that have been posted in chat before to not be displayed.  So you will basically see a raid posted only once per game session, further posts of that same raid won’t be displayed.  Reloading your page will reset this, since it clears out your chat history.

The fourth option is to hide all visited raids in chat.  Enabling this causes raids that you have visited (ie. added to your new/active raids list in game) to not be displayed.  This can cause problems if you’re attempting to share one of those raids in chat, as you won’t be able to see your own chat post with the raid link, even though everyone else will.  The script will block your own post from being displayed on your chat window.

The fifth option is to display raid links in a specific format.  Normally the raid link shows as a link to a web page, and clicking on that takes you to a web page where you get joined to that raid.  Enabling this option changes the way that the link gets displayed.  With the basic link, you have to mouse-over the link and look at the actual link text to see what raid it is and what difficulty it is.  The default for this option changes the link so that in chat it displays whether or not you’ve seen/visited the raid, what raid it is and what difficulty it is, as well as the Fair Share and Loot Tier values for the raid.  If you don’t know what Fair Share and Loot Tiers are, please consult a raids guide for their definitions.  Also see the Understanding Raid Info section below.

Now that you’ve gone through the Options and set the catcher up the way you want, it’s time to tackle Filters.  Filters are basically a way to tell the Raid Catcher that these raids are the ones you care about, and the rest you don’t care about.

Clicking on the Filters tab brings up an expandable list of raids, Small, Medium, Large, Epic, Colossal, Guild, and Special raids.  Each of these corresponds to a size of raid, with the last two being for Guild raids of any size and Special raids, which consists of Event Raids and World Raids.

Expanding a filter gives you a list of the raids of that size with check boxes for the four different difficulty levels, as well as all.  Check the boxes of the raids and difficulties that you want the Raid Catcher to keep track of.  These raids are the ones that will be imported when you import raids.  Raids that are not checked will not be imported, although raids of these types that the catcher sees in the chat window will still be added.  Filters are primarily for importing raids from the database, as well as letting you filter out raids in chat if you don’t want to see them.  That’s the primary use for the Guild and Special raids selections, since you can’t join Guild raids unless you’re a member of that guild, and Special raids all have raid links on the Home tab.

That completes setting up the Raid Catcher, and gets you to where you’re ready to start importing and joining raids.

Importing Raids

Importing raids is relatively simple once you’ve got everything set up.  Clicking over to the Importing tab brings up three selections, Expiration Times, Importing, and Direct Submission.  We’ll tackle these one at a time.

The Expiration Times section displays the five different sizes of raids, Small, Medium, Large, Epic, and Colossal, each with a timer associated with it.  The timer is how much longer the Raid Catcher will allow you to import raids of those sizes.  When you first start running the script you will have all five sizes enabled.  To reset the timer for a particular size, all you have to do is either post a raid of that size or submit one to the catcher.  The only catch is that the raid you post or submit has to be one that the catcher has not yet seen and validated.  Which basically means a raid that you have summoned yourself.  Direct submission of raids is recommended rather than relying on posting, because the raid catcher doesn’t continuously grab raids from chat.  It grabs raids periodically, then has to validate them, and if your posted raid dies before it gets grabbed and validated, you won’t get credit for the raid, and will have to wait until you can summon another raid of that size.  Directly submitting a raid causes the catcher to immediately validate it, and gives you credit once it does so.  Submitting a raid causes the timer to change to Open.  Once the submitted raid dies, the timer changes back to a countdown to when it will next expire, which is generally a few hours after the cooldown for that raid size resets and you can summon another one.

The Importing section is where you can do all your importing from.  The top of the Importing section shows some information on the last time you imported, as well as how many raids were imported.  Below that is a button marked Importing, a pull down box which defaults to Latest, and a check box marked Join raids after importing.

Clicking the Importing button sends an import request to the Raid Catcher server, it will then import all the raids in the database that fit your filter selections.

The pull down box lets you select whether to import all raids, just the latest raids (raids posted to it since you last imported), or raids posted within a certain time frame such as the last X hours.

The check box is for whether you want to join all the raids that you are importing as part of the importing process.  This speeds things up, but if you have a lot of raids checked in your filters, you could end up having to sort through a ton of raids in your New Raids list.  I recommend leaving this unchecked and use the join button instead (see the Joining Raids section below).

The last section is the Direct Submissions section.   This section consists of an empty box, a pull down box next to Make public, and a Submit Raid button.  To use this, paste the raid link into the empty box, set the pull down box for whatever delay time you want, and click submit.  This sends the raid to the catcher’s database.  Note that if you use a delay time other than Immediately, the catcher will not post the raid into the database until the delay time is over.  It also will not validate the raid and give you credit until this timer is over, so if the raid is killed before the delay is over, you won’t get credit even though you sent it to the catcher.  This is primarily useful if you have a private raid that you know won’t get killed and you want to release it to the public after a delay so it does get killed, but you don’t want to wait around and do it manually.  While the raid catcher will also add your raid and validate it if you post it in chat, there is a delay on doing so because the raid catcher doesn’t continuously check chat, and if your raid dies before it gets validated, you won’t get credit for it, which is why direct submission is recommended.

Joining Raids

Now we get to the part everyone has been waiting for, joining raids.  The Raid Catcher is designed to make joining raids easier, and as part of that it bypasses the normal “change to a new web page so I can join this raid” that was designed into the game.  Instead it simply joins those raids, and refreshing your raids list in game will display those newly added raids.  And it’s all done using the Raids tab of the Raid Catcher.

There are three sections in the Raids tab, Search, Sort, and Join.

The Search section lets you select which raids you want to see out of all the raids the catcher has in storage for you.  This storage is the raids which the catcher has seen in chat, as well as the raids you have imported.  Search lets you filter these to display only certain raids.  

The first thing in the Search section is a box labeled Quick and a set of buttons marked Save and Delete.  This lets you set up a saved set of quick searches for future use, as well as deleting ones you don’t use any more.

The second thing in the Search section is Boss: followed by a pulldown box and an empty box.  This lets you specify the difficulty of a Raid in the pulldown box, and the name of a raid in the empty box, to let you search for all raids of a particular name and/or difficulty.

The next Search filter is Poster, which lets you sort for raids posted by a certain person (by IGN) or those not posted by that person.

Next is Room, which lets you sort for raids posted in a certain chat room.

Age lets you sort raids by how long ago they were summoned, either by being newer than the specified time, or older than the specified time.

So as an example, if you wanted to look for Nightmare difficulty Bellarius raids, you’d set the Boss box to read Nightmare, and put Bellarius into the box.  This will change the raids displayed below in the Join section to all Nightmare Bellarius raids.  Specifying Normal bell will display all raids of Normal difficulty whose name contains the text string “bell”.

If you wanted all Tyranthius raids older than 4 days, you’d set the Boss section to Tyranthius and the Age section to Older than 4 days.

The Sort section of the Raids tab lets you sort the list of raids displayed under join by time, name, difficulty, or the Raid ID number, in either ascending or descending order.  This will let you search through them easier.

The Join section of the Raids tab has a check box marked All Raids, and a number followed by selected.  Checking the All Raids box sets the catcher to join all the raids you’ve imported or it’s seen in chat, and not just the ones displayed under the buttons.

Below that are three selections, Visited, New, and Both.  These set the catcher to join raids that you’ve already Visited, raids you haven’t Visited, or Both.  This filters the raids displayed to the ones selected.

Next come two buttons, Join and Delete.  Clicking the Join button joins all the raids that are displayed below the buttons and changes their status to Visited.  Delete removes the displayed raids from the catcher’s memory.

Below the buttons are a list of all the raids the catcher has in its memory on your computer, which you’ve set the Search and Sort for.  Each raid will show [Link] followed by the difficulty, the name of the raid, and whether you’ve visited the raid (ie. had it added to your New Raids list).    The [Link] is the web hotlink that you can use to manually join the raid or share it.

Note that just because a raid is listed here, doesn’t mean that it’s still alive.  If you join a raid and it is dead, the catcher will automatically delete it from the list, the same as if you manually delete it.  If the raid is still alive, joining will change the status to Visited and leave it in your list until you manually delete it.  Also, this does not mean that the raid will still be alive when you find it in your New Raids list, it could die in between being added and you going to hit it, just like normal.

Understanding Raid Info

With the latest update of the Raid Catcher script, v 2.4.0, wpatter6 and jHunz have incorporated the LEON Guild’s Raid Ranges data for loot tiers.  For instance, the image below shows the new raid info for Kalaxia the Far-Seer.

Note the last line, Loot Tiers.  This shows the different damage values for loot drops that are above the Fair Share value.  These three numbers represent the 2 or 3 Epic, 3 Epic, and Max Share values.  Other non-tiered raids may have more loot tiers than just those above Fair Share.  Tiered raids are a bit different, in that they have a large number of tiers above Fair Share, and those represent numbers of epics far in excess of the 3 or 4 that non-tiered raids can have.

Additional Functions

Recently, at user request, wpatter6 and jHunz added to the Raid Catcher the ability to incorporate Add-ons.  One of the recommended Add-ons is the YepoMax Add-on, written by YepoMax.  This adds some additional tools and two new tabs to the Raid Catcher, a Tools tab and a News tab.

YepoMax’s add-on adds tools such as a TNL Estimator, a Land Calculator, Sharing functionality for private raids, and an easy way to add and delete friends on Kongregate.

The TNL Estimator, using code designed by the LEON guild from Kongregate, estimates how long it will be before you have enough bars to level, based on the class you selected, your current bars, and your current xp needed to level.

The Land Calculator helps in figuring out the most cost efficient lands to buy based on your current land amounts.

The Sharing functions aids in sharing private raids to a list of friends you can specify, all at once, by batch whispering the raid link to them.  There is also a function for sharing raids with guild mates.

The friends functions are so you can quickly add and delete friends to gather Achievement Points for having 5000 friends that play DotD.