Proper Dungeon Finder

Why I made this

As a fellow rogue, I know how hard it is to find a group, or to gather one yourself. When I was putting a group together, I would scroll to the bottom of the list looking for a tank or healer, only to find out that someone had already invited them.

This addon gives you one simple view. Click a button to whisper a group, or search for exactly the roles your party is missing and invite them. I've been using it myself, and it speeds up a tedious task.

What it is

A better Group Finder for WoW Forever, with two modes in one window: Find a group and Build a group.

Find a group

• Pick dungeons from a card grid (level-range colours, favourites, search).
• Filters that matter: free slot for your role and your class not already in the group.
• Each group shows class icons, who is in it, and which roles it still needs.
• Click a row to whisper the leader with your saved message (3 editable templates).
• Whispered leaders are marked "Sent" so you never double-whisper.
• List myself / Unlist myself with one button.

Build a group

• See players who are looking for a group, filtered by the roles you need, class not already in your party, and level fit.
• Whisper or Invite with one click.
• List my group / Unlist my group with one button, and handle applicants (Invite / Decline).

Quick scan button

A small movable button on screen: one click refreshes your search. Optionally it also whispers the best matches. Auto-whisper is off by default and rate-limited (3 per scan, 20 per hour).

Minimap button

Left-click opens the window, right-click shows the quick button. Works with LibDBIcon / minimap button bags.

Commands

• /pdf open or close the window
• /pdf party open Build a group
• /pdf finder open Find a group
• /pdf quick show or hide the quick scan button
• /pdf minimap show or hide the minimap button
• /pdf reset clear the "already whispered" list

Key bindings: Options > Keybindings > AddOns > Proper Dungeon Finder.

How refreshing works

The game only allows a search from a real click or key press, so no addon can refresh by itself on a timer. Proper Dungeon Finder reminds you every 15 seconds ("Refresh (new!)") and lets you bind a key, so one tap does the whole refresh.

Notes

• Built and tested on the WoW Forever client (interface 16001). Other clients and versions are untested.
• If something breaks, please include the Lua error text (BugSack or BugGrabber) when you report it.
• Optional: LibDBIcon-1.0 for the minimap button. Not required.