This is a companion addon to go along with the Raiding, Recruitment, and Mythic+ Rankings site, Raider.IO: https://raider.io. With this addon installed, you'll gain access to an easy way to view Mythic Keystone scores, Raid Progress, and Recruitment status for players-- all without leaving the game!
Simply hover over a player with your mouse, your guild roster, or even the Group Finder list where you see queued people; if they meet the minimum qualifications then you'll see their score and best run in the tooltip.
Additionally, you can right-click players from the standard target unit frame to Copy Raider.IO URL and then easily look up their full profile on the site. With this functionality you can directly paste these URLs anywhere on Raider.IO to navigate to that player's profile page.
With the Raider.IO Recruitment features you can now also see whether a player is looking for a guild/team, or if they are recruiting for their own guild/team. This will show up as a line in the tooltip as follows:
You can right click on any player that is recruiting and hit Copy Recruitment URL to copy a URL that you can paste into your browser to view more details of the recruitment profile.
Because recruitment information can change regularly, we encourage people to use the Raider.IO Desktop Client to keep this data in sync.
If you have run into any problems, check out our FAQ at https://raider.io/faq, or join us on Discord at: https://discord.gg/raider in #addon-discussions -- we always have people around willing to help.
The easiest way to get started is to use the RaiderIO Desktop Client: https://raider.io/addon
Once installed you can load into the game and you will start seeing Mythic+, Raiding, and Recruitment details on players around you. This AddOn works by storing a snapshot of character data from Raider.IO and then using that to populate information on qualified players.
To qualify for inclusion in a snapshot, players must meet specific criteria based on the type of data:
Mythic Plus
- Have earned at least 200 points in the current or previous season. Honored and higher patrons do not have a minimum score requirement in order to be shown in the addon.
- Have logged in to the game within the past 14 days
Raiding
- Have defeated at least 30% of the bosses (rounded up) in either Normal, Heroic, or Mythic
Recruitment
- All active and public recruitment profiles are available in-game
Remember: We update the addon with the latest scores and top runs multiple times each day. Update regularly to ensure you are seeing the freshest information. Using the RaiderIO Desktop Client you can keep your addon updated automatically!
Our intent with this AddOn is to provide an easy way for people to get some information at a glance when forming groups. There is no substitute for talking with your fellow players, so be a pal and listen if an applicant whispers you. These are the fields we show, and when we show them:
Raid information in tooltips simply lists the best progress seen for the player.
Mythic+ tooltips have a lot of parts to them:
Raider.IO M+ Score: This is the overall score for this character. If the score is from a previous season, then the value of the score is rounded to the nearest 10s, and is prefixed with±. You can also identify the previous season score by looking for the(S#)suffix on the tooltip headline.Best Run: This will indicate the Mythic+ level for the player's best scoring run, along with the specific dungeon. Up to three plus signs+will be prefixed to the keystone level to indicate how much the keystone was upgraded during that run. Note: when this keyword is highlighted green it means that the player'sBest For Dungeonis also the same as their overallBest Run.Best For Dungeon: You'll see this line when using LFD to form or join a Keystone group. This will show the Mythic+ level of the player's best scoring run for the chosen dungeon.Timed #+ Runs: These lines indicate how many M+ runs have been completed by this player within the timer over the course of the current season. The player's two highest categories of Timed Runs will show by default.Main's Best M+ Score/Main's Current M+ Score: This indicates the best character score on this player's account, if they have registered on Raider.IO and linked their Battle.Net account. This will only show if the Main's Score is greater than the current character's score. If someone has a good score on their main, then much of their prior experience will help them perform better in dungeons while on their alt.
Role icons included on Mythic+ tooltips can be thought of as badges earned by accumulating certain amounts of score while playing as that role. Fully opaque icons indicate they've earned at least 80% of their overall score in that role. Semi-transparent role icons indicate they have earned at least 40% of their overall score in that role.
We currently determine the profile to show based on a priority order for the entity and activity type. Our overall rationale is that we want the most common organized activities to take precedence when choosing what to show in-game.
- Guild + Raiding (only recruiters)
- Guild + Guild Mythic+ (only recruiters)
- Team + Team Mythic+ (only recruiters)
- Character + Raiding
- Character + Guild Mythic+
- Character + Team Mythic+
- Guild + Guild PVP (only recruiters)
- Guild + Guild Social (only recruiters)
- Character + Guild PVP
- Character + Guild Social
Note: Anyone in your guild who has access to the Recruitment information will show your group's recruitment profiles in-game. Meaning, it is based on the roles given to each rank. These ranks will show the tooltip in game, and will also be able to access recruitment information on the site:
- GM / Captain
- Officer
- Recruiter
You can view your personal M+ and Raid Progress profile when you open the Dungeon Finder. This will be shown as a large tooltip alongside the Dungeon Finder frame with additional details about your per-dungeon performance.
This can be used to help understand what dungeons you should try to focus on in order to raise your score.
By default when you are in the Dungeon Finder it will show your own profile. However, you can press a modifier key (Shift/Alt/Ctrl/Cmd) to show the target character's full profile instead. There is also a config option to invert this behavior.
You can view additional details when hovering over Mythic+ Keystone items, such as:
-
The highest key completed for each member of your group for the dungeon you are in, or queued for.
-
Avg. Timed +# Player Score: This is the rounded median score of players who have successfully completed Mythic+ runs in time at this level. This data is sampled from the past 60 days of runs tracked on Raider.IO, and it excludes the top and bottom 1% of scores at each level. This is intended to provide a guide for the type of score you might consider when forming or joining a group based on data seen across all players.
You can pull up detailed information for all the characters in your group at once by utilizing the Raider.IO Group Search feature.
- Click the magnifying glass icon at the bottom of the Dungeon Finder
- Copy the text in the window that pops up
- Go to https://raider.io and hit Ctrl-V or Cmd-V to paste this while the site is in the foreground.
This will then take you to the Raider.IO Advanced Search page for all the characters in your group.
- Click the "Copy Raider.IO URL" button
- Copy the text in the window that pops up
- Go to https://raider.io and hit Ctrl-V or Cmd-V to paste this while the site is in the foreground.
This will take you to that character's profile page.
You can look up any character in the current database by using the /rio search command.
When you type this, you will be presented with a small frame where you can enter the realm name and character name to search for. If they are found, then their information will be pulled up and displayed.
You can type /rio search to hide the window.
Our recommended settings are enabled by default, but we've provided several options to customize how and where the tooltips might show while in-game. Type /raiderio to open the Raider.IO options frame. Alternatively, you can also find a shortcut in the Interface > AddOn settings frame.
Here you can easily enable or disable various features, including whether to show scores from each faction, and various tooltip customization options.
Remember to click "Save" to save the changes, or "Cancel" to abort and close the dialog.
Scores map to a specific color based on their range. We've followed the standard WoW quality colors, but added additional gradients between the base values to provide more brackets to ascend through. These tiers are recalculated based on actual scores.
Interested in supporting development of Raider.IO and getting some rewards while you're at it? We offer multiple levels of rewards.
Friendly:
- Browse Raider.IO AD-FREE!
- Friendly Patron rank in Discord
Honored:
- Exclusive profile header background options
- Minimum score requirement removed from addon
- Elevated queue priority
- Honored Patron rank in Discord
- Plus all rewards from Friendly tier
Revered:
- Desktop client updates scores 4 times a day
- Custom Vanity URL for your guild or character
- Queue priority elevated above Honored level
- Revered Patron rank in Discord
- Plus all rewards from Friendly and Honored tiers
Exalted:
- Desktop client updates scores 8 times a day
- Utilize up to 2 Custom Vanity URLs
- Queue priority elevated above Revered level
- Automatically qualify for all locked header backgrounds
- Exalted Patron rank in Discord
- Plus all rewards from Friendly, Honored, and Revered tiers
We love our fellow developers! We wanted to provide anyone in the community a simple way to tap into the scores that are a part of this addon. Addon developers can do this by utilizing the RaiderIO table to access certain APIs we provide.
If the documentation is out-of-date you can also get a lot of information straight from the source code. A lot of the functionality is annotated for the sake of the lua language server extension in vscode.
These functions return nil or a RaiderIOProfile table.
RaiderIO.GetProfile("target")
RaiderIO.GetProfile("Name", "Realm"[, region])
This table contains data depending on what providers are loaded. This documentation is not complete, there are several internal values but they are all based on the core data that is documented below.
{
success = boolean
region = "us" | "kr" | "eu" | "tw" | "cn"
faction = 1 | 2
name = "Name"
realm = "Realm"
mythicKeystoneProfile = RaiderIOMythicKeystoneProfile | nil
raidProfile = RaiderIORaidProfile | nil
recruitmentProfile = RaiderIORecruitmentProfile | nil
}
{
hasRenderableData = boolean - if false pretend the table was nil instead (the database is outdated so we don't want to show inaccurate data)
currentRoleOrdinalIndex = number
currentScore = number
fortifiedDungeons = number[]
fortifiedDungeonTimes = number[]
fortifiedDungeonUpgrades = number[]
fortifiedMaxDungeon = RaiderIOMythicKeystoneDungeon
fortifiedMaxDungeonIndex = number
fortifiedMaxDungeonLevel = number
keystoneFifteenPlus = number
keystoneFivePlus = number
keystoneTenPlus = number
keystoneTwentyPlus = number
mainCurrentRoleOrdinalIndex = number
mainCurrentScore = number | nil
mainPreviousRoleOrdinalIndex = number
mainPreviousScore = number | nil
mainPreviousScoreSeason = number
mplusCurrent = RaiderIOMythicKeystoneRoleInfo
mplusMainCurrent = RaiderIOMythicKeystoneRoleInfo
mplusMainPrevious = RaiderIOMythicKeystoneRoleInfo
mplusPrevious = RaiderIOMythicKeystoneRoleInfo
previousRoleOrdinalIndex = number
previousScore = number
previousScoreSeason = number
sortedDungeons = RaiderIOMythicKeystoneDungeonProfile[]
sortedMilestones = Milestone[]
tyrannicalDungeons = number[]
tyrannicalDungeonTimes = number[]
tyrannicalDungeonUpgrades = number[]
tyrannicalMaxDungeon = RaiderIOMythicKeystoneDungeon
tyrannicalMaxDungeonIndex = number
tyrannicalMaxDungeonLevel = number
-- metatable data dynamically assigned depending on the weekly affix
dungeons = number[]
dungeonTimes = number[]
dungeonUpgrades = number[]
maxDungeon = RaiderIOMythicKeystoneDungeon
maxDungeonIndex = number
maxDungeonLevel = number
}
{
dungeon = RaiderIOMythicKeystoneDungeon
level = number
chests = 0 | 1 | 2 | 3
fractionalTime = number - between 0.0 and 1.0
}
{
index = number
id = number
instance_map_id = number
keystone_instance = number
lfd_activity_ids = number[]
name = string
shortName = string
shortNameLocale = string
timers = number[]
}
{
[1] = "tank" | "healer" | "dps
[2] = "full" | "partial"
}
{
roles = RaiderIOMythicKeystoneRole[]
score = number
season = number | nil
}
{
hasRenderableData = boolean - if false pretend the table was nil instead (the database is outdated so we don't want to show inaccurate data)
progress = RaiderIORaidProfileProgress[]
previousProgress = RaiderIORaidProfileProgress[]
sortedProgress = RaiderIORaidProfileSortedProgress[]
raidProgress = RaiderIORaidProfileRaidProgress[]
}
{
difficulty = 1 | 2 | 3
progressCount = number
raid = RaiderIORaidProfileRaid
killsPerBoss = table<bossIndex, killCount>
}
{
isMainProgress = boolean
isProgress = boolean
isProgressPrev = boolean
obsolete = boolean
progress = RaiderIORaidProfileProgress[]
tier = number
}
{
count = number
difficulty = number
killed = boolean
}
{
current = boolean
fated = string
progress = RaiderIORaidProfileRaidProgressInfo
progressCount = number
raid = RaiderIORaidProfileRaid
show = boolean
}
{
index = number
id = number
instance_map_id = number
lfd_activity_ids = number[]
name = string
shortName = string
shortNameLocale = string
}
{
dungeon = RaiderIORaidProfileRaidDungeon
id = number
mapId = number
name = string
shortName = string
bossCount = number
ordinal = number
}
{
hasRenderableData = boolean - if false pretend the table was nil instead (the database is outdated so we don't want to show inaccurate data)
entityType = number
title = string[] - this locale key will yield the actual label from the locale table
titleIndex = number
tank = boolean
healer = boolean
dps = boolean
}
Updates a tooltip widget and appends the character profile just like how RaiderIO does to the regular tooltips. This function uses the same arguments as RaiderIO.GetProfile except the first is the tooltip widget.
RaiderIO.ShowProfile(tooltip, ...) => true | false - depending on if the tooltip was altered or not
Returns the colors for a given score.
RaiderIO.GetScoreColor(score) => red, green, blue - in the range of 0.0 to 1.0
Please refrain from using these API as they will be removed in future updates.
RaiderIO.ProfileOutput
RaiderIO.TooltipProfileOutput
RaiderIO.DataProvider
RaiderIO.HasPlayerProfile
RaiderIO.GetPlayerProfile
RaiderIO.ShowTooltip
RaiderIO.GetRaidDifficultyColor
RaiderIO.GetScore