KeyScout

1.0.1

• The menu has a sidebar: pages grouped as Start here (Keys, Filters), Fine-tune (Applying, Search, Chat, Panel) and Your history (Listings, Stats, Insights, Leaders), with Help at the bottom, so the simple pages come first.
• Keys tab: Vault Goals moved into the Great Vault section, with more room around it.
• The Great Vault (Mythic+) summary moved from the Stats tab to the bottom of the Keys tab, one column per slot.
• Recent Groups: each group has an X to remove just that one (click it twice). The list shows 11 groups at a time now.
• Recent Groups no longer keeps groups that never became a run: if no key started and the party never filled, the group is dropped when you leave it. Older ones like that are cleared at login.
• Leaders: Most Invites only lists leaders who invited you at least once.
• Share KeyScout: the "Trying an addon" line now says KeyScout is free on CurseForge instead of in beta.

1.0.0

• First full release, with the same features as 1.0.0-beta3. KeyScout now comes with the CurseForge app's default Release setting, so you don't need to switch to Beta to get it.

1.0.0-beta3

• Share KeyScout: the lines you can send to your group no longer say the addon is hidden or to ask you for a link. KeyScout is listed on CurseForge now, so they tell people to search for it there.

1.0.0-beta2

• KeyScout rests on characters below max level, since Mythic+ is closed to them: the panel stays closed (type /ks or use the minimap button to open it anyway) and the engine won't turn on, with one line in chat saying why. The very first time you install KeyScout it opens on whatever character you're on, so you can find it and look around. Your ON switch is kept for when you get there: on reaching max level KeyScout says it's ready, the panel opens, and it's back as you left it.

1.0.0-beta1

• First beta: same features as 1.0.0-alpha6, now listed in CurseForge search and the CurseForge app. Set the addon to Beta under Preferred Release Type in the app to get it.

1.0.0-alpha6

• Match score: the leader's best run in the dungeon now counts against the key level instead of just "timed or not": timed 2+ levels higher +8, at the key or one higher +5, one or two below nothing (that's normal pushing), three or more below -3, and no run there -3 ("Leader has no run in this dungeon", which used to read "-3 Leader timed this dungeon").
• Group Readiness learns how far apart your groups really land: when high readiness has been overpromising and low readiness underselling, it's pulled toward your average (gently at first, more as keys add up; never below 0.6x). On the keys so far this cut the average miss against the result from about 10 points to about 7.
• Fixed: right after you joined a group, its leader could count as someone you'd played with before (the application that got you in counted as history), and clicking them showed the group you were in. Players from other realms were also saved twice, once without their realm, which doubled their counts; the duplicates are cleaned up on load. Players you rated now match as leaders from other realms too.
• Match score: a group with a player the game flags for leaving keys loses 8 points (16 for two or more), and players you rated after a run count: Rather not -10 each (-14 if you tagged them Left or Toxic, -28 at most), Play again +4 each (+8 at most).
• Your pending applications are scored with the same information as new ones (leader history, realms, your ratings), so Swap Slots cancels the one that's really the weakest.
• You're in! window: Group Readiness now shows how the group looked when you signed up, "At sign-up 58 · +14", in green when it turned out better and red when worse. At sign-up the listing only shows the leader's run and everyone's class; once you're in, everyone's runs, ratings and gear count, and the line keeps updating as players join.

1.0.0-alpha5

• Suggested sign-up note shows your highest key and average key ("best +15, avg +12", from your best run in each dungeon) in place of "kick": a leader can tell more from those two numbers.
• Panel in Smart mode: the extra "Levels +10 to +12" line under "From ... · Queueing for ..." is gone, since it said the same thing twice. The search text to copy is centred in a narrower box.
• Group tooltip, Utility section: the classes that bring lust, battle res, Augmentation and interrupts are named in their class colours instead of all green.
• Smart and Range tooltips are written for players now: what Smart does for you, and that switching back to Range or Exact keeps your levels.
• Filters tab: the Skip Sellers and Avoid Decliners explanations moved into their tooltips (they were two long paragraphs that ran into the OCE row), and the switches sit side by side. Realms have their own short section: the OCE choice, then the realms you skip (click to stop) and the realms seen lately (click to skip). The type-a-realm box is gone; /ks blockrealm <realm> still adds one by name.
• Missing Portals disappears from Smart Select once every portal is earned, since it has nothing left to do for the season, and the other buttons close the gap; the tip under them drops its sentence too. The other picks always stay, even when they'd select nothing right now, so the row never rearranges under a click.
• Plan by dungeon now decides the levels. With it on, every ticked dungeon is queued at its own level: your best timed run there plus the Keystone step you pick (+0 to +5; a dungeon you only finished over the timer stays at that level, one you never ran takes your key level). Tick or untick a dungeon, change the step, or let a Smart Select pick for you, and the levels follow; one search text covers all of them, and the panel and the Keys tab tell you when it changes. The level buttons ("+11 · 3 dungeons") tick every dungeon that lands on that level. Change the key level yourself and the plan turns off: one level for all again. Missing Portals, Below Key and Shortest still mean one level for everything they pick; Push Higher, Lowest Rated and Fewest Chests turn the plan on.
• Smart Select buttons light up while their pick is exactly what is ticked, the same highlight as All Dungeons and the level buttons, so you can see which one you're on. Tick or untick anything by hand and none of them matches, so they all go dark.
• Keys tab rows: the best level, its chests and the score sit in three aligned columns under their own titles (Best / Chests / Score), so "+10 (+2)" no longer reads like arithmetic and the numbers line up whether or not a row is ticked. With the plan on, the third column is Queue: the level each dungeon queues at, dim on unticked rows. Hover a row for the full story: time against the timer, score, timer, portal, and the plan's level.
• Panel: while the plan is on, one line says what you'll queue for, "Queueing for +11 to +12 in 4 dungeons" with the levels in green ("Will queue for" while KeyScout is OFF), in place of the list of dungeon names it used to print, and Step 1 below carries the matching search text. The plan itself is listed in the footer with the other filters ("Filters on: Plan by Dungeon, Keystone +2"), where Clear turns it off too. The Keys tab shows the same line in place of the key stepper, with Exact / Up to +2 / ±1 beside it.
• The amber "needs +12: a lower key there can pop" warning is gone. With the plan giving every dungeon its level there is nothing left to warn about.
• The settings window's footer reads "Pending 0/5" (green) instead of "Pool 0/5".
• Panel steps, said plainly: Step 1 is "Copy the text below into the Premade Groups search box (the LFD button opens it) and press Enter or Refresh. We'll use your filters below for the rest." Step 2 is "Click ON and keep playing. As you press your keybinds, KeyScout looks for a group with you." No more Ctrl+C lecture, and nothing that sounds like it all happens without you. The Help tab's Getting Started says the same.
• Two resets instead of one. The settings window's footer button is now Reset..., opening a small panel with Reset Filters and Reset Settings, each a two-click confirm with a line on what it touches. Reset Filters puts everything that decides which groups you get back to a fresh install: key level and dungeons, Apply As, must-haves and skips, rating and match limits, realm skips and Blizzard's own Premade Groups filter. Reset Settings does everything else: chat lines and alerts, applying, panel and window options. The panel stays where you put it, and neither touches your keybind setup, stats, leader history or blocked leaders. /ks reset filters, /ks reset settings, or /ks reset for both.
• Three ways to choose levels, side by side. Key Level now opens with a choice, on the panel (right of the stepper) and on the Keys tab: Exact Level (the default: one level for every ticked dungeon, with Accept to widen it a little), Range (Lowest to Highest) and Smart (was Plan by Dungeon). The row under it changes with the choice: Key level + Accept, Lowest + Highest, or Step + Accept. Smart means Smart Filters recommend dungeons from your season and each queues at its own level, its best timed run plus the Step; the Keys tab shows the chain in one line, "From your best runs +9 to +11 · Queueing for +11 to +13 in 4 dungeons · each dungeon at its own level", and the panel says "From +9 to +11 · Queueing for ...". Your Range is kept while you try Smart, so switching back restores it. Picking Smart on the panel opens the Keys tab, where the filters are. The Keystone +1/+2/+3 buttons and the Plan by Dungeon toggle are gone; the panel's Step stepper no longer truncates to "Keys...". The Loadout's flex row is labelled Accept (Exact / Up +2 / ±1) so it reads as tolerance, not a second level setting.
• Avoid, don't skip. OCE realms and leaders who usually decline you are no longer filtered out: with the switch on they lose 20 points, so they sit at the bottom of the list and get an application only when nothing else is left. The panel's Loadout has an Avoid: row for the two (OCE Realms, Decliners); Skip: keeps the hard ones (your class, and Skip Sellers stays a hard skip, since a boost sale is never wanted). The Filters tab's OCE choice reads Any / Prefer / Avoid.
• Cancel Lowest is the new name of Cancel All, because that is what it does: this click withdraws your lowest-scored application and each action button press withdraws the next weakest, so your best applications go last (they used to go in the game's order). The button counts down. It sits left-aligned under "Next step:" together with Step Now (optional); the "or just press any action button" line is gone. Step Now's tooltip lays the cycle out as three bullet points (Search, Apply, Cancel, then over again) instead of a paragraph.
• Plan by Dungeon reads top-down now. Keys tab: "From your best runs: +9 to +11" on the first row, the Keystone step stepper under it, then "Queueing for +11 to +13 in 4 dungeons" in the hint line, so it is clear what the step steps from. The panel's line under the stepper starts the same way ("From +9 to +11 · Queueing for ..."). The level buttons are your three highest next levels (a gap between them is fine) and read "+12 Dungeons" over "3 of 8".
• Panel wording: the empty area reads, centred, "No search results yet" over "Press any action bar keybind (or Step Now) to start queueing." (and, after a search that found nothing, "No groups at your levels in the last search" over "Your next keybind press searches again."); the footer reads "Current step: pending your next keybind press".
• The sign-up note moved to Keys > Apply As and is called what it is: the note Blizzard sends with your application (it was "Note to Leader" on the Chat tab, which read like a whisper). Same row: what the game has in the box now, Type the Note... to open Blizzard's sign-up window, the "Ask for the note on my first application" switch, and a Suggested line to copy, built from your spec, rating, item level and what you bring (lust, brez, kick, dispels), within the box's 63 characters.
• The whisper on apply is gone. It annoyed leaders and opened conversations that could go wrong; the sign-up note does the job. The Chat tab keeps the party hello, the Share line and the alerts. /ks msg apply is retired.
• Smart Filters live in Smart mode. Under the dungeon list, Exact and Range show All Dungeons and a hint; Smart adds the filters: Highest Keys, Lowest Keys, Under My Level (was Below Key), Highest Rated, Lowest Rated, Fewest Chests, Shortest Timers and Missing Portals. Hover any of them for what it means and exactly which dungeons it would tick. A filter only ticks dungeons; the Step decides the levels, except Missing Portals, which also sets a floor of +10 (a timed +10 is what earns the portal). Ticking by hand clears that floor.
• Keys tab rows keep the same four columns whatever you do, Best / Chests / Score / Timer, numbers centred under their titles, so nothing bounces when a setting changes (the plan's level per dungeon is in the row tooltip). The level buttons read "3 dungeons at +11" with a line above saying what they do; All Dungeons moved up to the Smart Select row.
• Panel: Group Finder is the button's name now (the game's own), and Settings opens the settings window (it said Menu). Loadout toggles wrap to a second line instead of running into the panel's border.
• When the Group Finder search box is readable and empty, the panel's Step 1 says so in amber ("Step 1: the search box is empty") and the Keys tab's search line starts with "The search box is empty."
• Share KeyScout, your pick of five lines. Chat > Share KeyScout has a picker with five lines to send (While I play, How I got here, Any action button, You're in! window, Beta testers); the chosen line shows in full under the row, wrapped, and stays your default. Send to Party and the panel's Share link send that line. It replaces the single copy field.
• Panel Loadout: the toggles read Skip Sellers, Skip Decliners, Widen Over Time, OCE Realms and Plan by Dungeon, and each has a tooltip saying what it does. The class skip is worded as what it checks, Already a Demon Hunter in my role, with your class in its colour so it visibly follows the character you're on: it skips groups that already have one of your class in a role you apply as, since with you that would be two. Its tooltip says so, and says why it's green when you stack your own armor type. The Filters tab's switch reads the same way ("Skip groups that already have a Demon Hunter").
• Skip Decliners' hint (Filters tab, and the panel tooltip) now says what happens either way: a leader who declines you is skipped for the cooldown under Applying (20 minutes by default) and that listing for the rest of the session. The switch adds the long memory across characters (3+ answered applications, 80%+ declined) and stays off by default.
• Keys tab: All Dungeons moved off the Dungeons title, where it was always green, to the first spot on the row of level buttons, and it now lights up only while every dungeon is selected, the same way a plan level lights up when it is the current selection. Best +1 / Best +2 sit beside the Plan by dungeon checkbox, the plan is explained in three short points under the buttons, and Apply As has room around its title.
• Escape closes the You're in! window, as it already closed the settings window. The always-on panel stays put (Escape hides every such window at once, and the panel is meant to stay); its minimize and close glyphs and /ks do that job.
• Note to leader, typed once. Chat > Note to Leader has Set the Note Now, which opens Blizzard's own sign-up window on the best listing so you can type the note and click Sign Up yourself, and an option Ask me for the note on the first application: with it on, KeyScout's first application of a session opens that window instead of applying, you type the note once, and every application after that carries it. Addons can't type into that box, but the game sends whatever is in it with each application, and it stays until Blizzard's window opens for a different dungeon.

1.0.0-alpha4

• Minimap button with the KeyScout logo. Left-click shows or hides the panel, right-click opens the settings, drag it around the minimap. The logo also sits on the panel, the settings window and the addon list.
• Windows stay in front. The panel, the settings window and You're in! share one layer: whichever opens or gets clicked last comes to the front, so nothing hides behind anything. The settings window opens attached to the panel's right side and follows it; drag it anywhere to detach, click Attach in its header to snap it back. The Panel tab remembers your choice.
• Run Recorder (quiet). Every Mythic+ key you run is now recorded on this account: who was in it, keystone level and affixes, how it went, deaths, ratings before and after, and each player's numbers from the game's own damage meter, every meter type it offers. It shows nothing and scores nothing yet; it keeps clean data so later KeyScout updates can grade runs, groups and players from what you've already played. Stays under a 4 MB budget on its own, keeps the newest 100 runs in full, and never sends anything anywhere. /ks recorder on|off, /ks runs.
• Combat logging in dungeons. When you zone into a dungeon (and again as the key starts), KeyScout turns the game's combat log on if it isn't already, with advanced logging, so Warcraft Logs and a future companion have the full run. It turns it off when you leave, but only if it was the one that turned it on. /ks combatlog on|off, or the switch in Applying > Behaviour.
• A level per dungeon, one search text. A Smart Select whose dungeons need different levels (Push Higher, Lowest Rated, Fewest Chests) now gives each dungeon its own exact level and suggests one search text covering the span. You type it once; inside it, Scout Sense tells the levels apart, so an Altar that needs +12 isn't applied to at +10 while a Kings' Rest at +10 is. The panel shows "Per dungeon: Kings' Rest +10 · Ruby Life Pools +11 · Altar of Fangs +12" in place of the level stepper, the Keys tab shows each dungeon's level, and changing the key level goes back to one level for all. The plan's group buttons still offer the exact one-level-at-a-time steps if you'd rather retype per step. With the plan on and one level for all, the panel warns when a picked dungeon needs more than the low end of what you search.
• Exact means exact (opt in, Applying > Behaviour): with the search box wider than your one level, keep only listings whose level is pinned by the box or a leader's item-level tag and skip the rest as "Level not certain". Off by default, so the text you set stays the text you set.
• Loadout is the new name of the panel's Power Options. It gained the power-user switches that used to live only in the settings: Swap slots (Off / Gentle / Balanced / Eager), Widen over time, Skip sellers and Skip decliners. Plan by dungeon is now a toggle on the Level row instead of a button floating on the right, so Range mode no longer leaves an empty row. A tinted backdrop with a bar down the left now shows exactly where the section starts and ends, so you can see what the header collapses.
• Clearer panel messages: with nothing searched yet it asks you to press a button (or Step now) instead of saying "no groups"; after a search that found nothing it says so and that the next press searches again; when KeyScout is off it says "Turn KeyScout ON to continue" once, not twice; the footer reads "Step now: any action button you press".
• Step now button. One Group Finder step by mouse, beside "Next step" on the panel, for anyone who'd rather click than press a key. It is optional: every action button press does the same, the panel says so under it, and the Panel tab can hide it.
• Panel tab in the settings: size, lock, hide inside instances, Next Best rows; the Step now and minimap buttons; and what the minimized panel keeps. The settings window now has two rows of tabs.
• Help tab. Getting started in three steps, every slash command one per line (scroll for more), a few tips, and a support address you can copy (click it, Ctrl+C), sitting above the footer. /ks support opens it.
• Dry Run is now Preview Mode everywhere: the badge, the footer button (hover it for what it does), the chat lines and /ks preview on|off; /ks dryrun still works. It searches and shows what it would apply to, without applying, so no invites come while it's on.
• Minimized panel keeps the level stepper (From / To with Range on), the search text to copy, and Step now and Cancel All at the bottom right, each of them optional (Panel tab). Change the level, grab the text or take a step without expanding it.
• Once your search text is set and the Group Finder is still open, the panel says you can close it now: KeyScout searches without the window, and you only need it again to change the text.
• Cancel All no longer turns KeyScout off. It withdraws your applications, skips those groups for five minutes, and keeps hunting; only OFF (or joining a group, entering an instance) stops it.
• Cleared search text, noticed. The game empties the Group Finder search box when you join a group, and with the window closed you'd never see it: KeyScout would quietly go by Scout Sense. Now it notices the box went blank after you had set it, says so once, and Step 1 comes back in amber as "Step 1 again" with the text you had, so you can paste it once more if you want exact levels.
• Deaths and time to spare. Each run now records the death count (and the time deaths cost). The You're in! window shows "Timed +1 28:14 · 5:30 to spare · 4 deaths" (or "1:12 over"), counts deaths live while the key runs, and hovering the Result score shows the time against the timer and the deaths.
• Rate this group. Once a key has ended (or the group is gone), the You're in! window lists the other members with Play again / Rather not. Click a stamp, then the row, to pick from six quick reasons; there's also a note box for the run. Stamps stay with the player (the last 10) and with the run, and Played together before shows your latest verdict on someone. Reopen any run from Stats > Recent Groups to rate it later. Your notes only; nothing is ever shared.
• The LFD button (and Search > Open Dungeons Search) now opens the Group Finder straight to Premade Groups > Dungeons > the search page, with the search box ready for your text. No more clicking Premade Groups, then Dungeons, then Find a Group. It never searches by itself, so your applications and results stay as they are; clicking it again on that page closes the window.

1.0.0-alpha3

• Fixed: after a group KeyScout found you finished its key (or an invite went away without you answering it), the panel could keep saying "Invite pending: answer Blizzard's dialog" with no dialog anywhere, and only a /reload cleared it. KeyScout now asks the game which invites are really waiting each time it plans a step, the same way Blizzard's own invite window does, so a stale one can no longer block you.
• Fixed: after a key, KeyScout could announce that the game was blocking your action-button presses and stop listening to them, with no way left to queue until a /reload. The game reports KeyScout's own windows being touched in combat as "blocked" too, and every such report counted. Now only a block of one of KeyScout's own key-press actions counts; a real run of them rests the presses for 10 minutes instead of the whole session, and turning KeyScout OFF and ON ends the rest. Clicking ON on the panel now also takes the first step (a search), so the panel alone can start it.
• KeyScout pauses while the game restricts addons (inside a running key or a boss fight), and the saved log notes every block and every restriction change, so a repeat can be read from /ks debug.
• Leaderboard: My Group shows your history with each member of the party you're in right now, leader or not: groups together, keys timed, your stamp, their record as a leader with you, and a click through to the runs you recorded with them. The button carries a count when KeyScout knows someone in your party, red when one of them is a Rather not, and the panel shows the same badge ("2 you know" / "1 rather not") in its footer, or on the minimized panel's bottom row, only while there is someone to show; hover it for who, click it for My Group. A Find box filters the board by name.
• Leaderboard: a leader's rates now count only the applications they answered (invited, declined, or let run out). The ones you or KeyScout withdrew, for a swap or by turning it off, no longer drag their invite rate down; the match bonus and "Skip leaders who usually decline you" use the same count. Cards show Ignored and Withdrawn, the key levels a leader invited you at ("Avg invite 30s at +10-12") and the keys you ran with them, and names with their realm have room again. Click a leader for the runs you recorded with them, and click a run for its summary.

1.0.0-alpha2

• If the game ever blocks Group Finder actions started from your action-button presses, KeyScout stops using them for the rest of the session and tells you once what still works (its own keybind, or clicking the panel), instead of repeating an error. The panel footer shows it too.

1.0.0-alpha1

First public test build. KeyScout finds and applies to the best Mythic+ groups for you while you keep playing: every action button you already press lets it take one Group Finder step (search, apply, or cancel), so you never sit refreshing listings.

Getting started

• Pick your key level on the panel, paste the search text it gives you into the Group Finder search box, click ON, and play. That's it.

Finding groups

• Ranks every listing and keeps your five applications on the best ones, swapping weak ones out.
• Exact key levels through the search box, or Scout Sense reads each leader's runs.
• Optional filters: must-have Lust / Brez / Tank / Healer, playstyle, leader rating, realms (Prefer or Skip OCE), same-class skip, likely sellers and carry teams skipped.
• Vault Goals, Smart Select and Plan by Dungeon pick levels and dungeons for your Great Vault, portals and score.

Once you're in

• "You're in!": the dungeon and level, every member's rating, item level and best run there, the group's basic needs, Group Readiness (hover it for the scale), and a one-click teleport to the dungeon.
• After the key, a result score shows how it went and how that compares with the readiness it started with. Readiness tunes itself to your results over time.
• Played together before: see who in the group you've run with, how often, and how those keys went. Optionally say hi to them (off unless you turn it on).
• Recent Groups keeps your last 20 groups and how each key went.

Your stats

• Insights: how your keys went by readiness, basic needs, experience, rating, gear, affix and dungeon.
• Leaderboard of the leaders you've applied to: invites, speed, best keys.
• Great Vault progress and time-to-invite stats.

Nothing is ever sent to other players unless you click Share or turn a message on.