PartyFinder is a server-authoritative matchmaking system for World of Warcraft Mythic+ dungeons. It helps players find groups quickly by matching group leaders (hosts) with players looking for groups based on their roles, item level, RaiderIO score, and dungeon preferences.

1. Install the WoW Addon: Download PartyFinder addon from CurseForge
2. Generate Link: Type /pf in WoW to generate your character link
3. Import to Website: Copy the link and paste it at mythicfinder.online
4. Choose Mode: Either create a group (if you have a keystone) or find a group
5. Wait for Match: The system will automatically match you with compatible players

All matchmaking logic runs on the server, not in your browser. This means:

• ✅ Fair matching: Server decides who matches with whom based on strict rules
• ✅ Anti-cheat: Players can't manipulate the queue or bypass requirements
• ✅ State recovery: If you refresh the page, your queue position is restored
• ✅ Real-time updates: Match notifications via WebSocket (fallback to polling if WebSocket unavailable)

The server matches players based on several criteria:

• Role Requirements: Groups need 1 tank, 1 healer, 3 DPS
• Dungeon Selection: Players must want the same dungeon
• Key Level Range: Player's max key must be >= group's key level
• Level Requirement: Minimum character level 80
• Off-Role Penalty: Playing off-spec reduces max available key by 2 levels

Priority System: Players who get matched but decline are returned to the front of the queue.

1. Match Notification: You'll hear a sound (if enabled) and see a notification
2. Review Group: Check the group composition, dungeon, and key level
3. Accept or Decline: You have 90 seconds to decide
4. All Players Accept: If everyone accepts, you'll get whisper instructions
5. Someone Declines: Match is canceled, you're returned to queue with priority

If you're a player (not host):

1. Copy the whisper command shown on the website
2. Paste it in WoW chat: /w LeaderName-Realm id XXXXXX
3. Wait for the group leader to invite you

If you're the group leader (host):

1. Wait for players to whisper you with their Match ID
2. Verify the Match ID matches
3. Invite each player: /invite PlayerName-Realm

Yes, you can decline after accepting by clicking the red "Decline Match" button on the accepted match screen. You'll be able to search again immediately after declining.

Note: Other players in the match will be returned to the queue with priority if you decline. Please only decline if absolutely necessary to avoid disrupting other players!

Your max available key is calculated from your best runs:

• Completed in time: Max key = best key + 1
• Not in time: Max key = best key (no bonus)
• Off-role penalty: If playing off-spec, -2 levels (minimum +2)
• No experience: Only +2 keys available

Example: Best run is Ara-Kara +15 (in time), playing main spec → max key +16. If playing off-spec → max key +14.

Common reasons:

• ❌ Level too low: Minimum level 80 required
• ❌ Invalid token: Update your addon to latest version (1.0.3+)
• ❌ Already in queue: Close other browser tabs with PartyFinder open
• ❌ Duplicate token: Someone else is using your character in another session
• ❌ No keystone: (for hosts) You need a keystone to create a group
• ❌ No dungeon selected: (for players) Select at least one dungeon

Each addon installation generates a unique secure token (32 characters + 16-character signature). This token:

• ✅ Prevents spam: Users can't manually create valid tokens
• ✅ Detects multi-accounts: Server kicks duplicate tokens
• ✅ Persists across sessions: Token saved in WoW SavedVariables
• ✅ Signed with secret key: Server validates signature to prevent forgery

Important: Token is tied to your WoW installation, not your character. All characters on the same PC share the same token.

No! Opening multiple tabs will cause issues:

• ❌ "Already in queue" error
• ❌ Duplicate join requests
• ❌ State desynchronization

The system detects duplicate sessions and shows an alert. Close all other PartyFinder tabs before joining the queue.

Yes! Your queue state is preserved using session storage. If you refresh:

• ✅ Queue position maintained
• ✅ Timer continues from where it left off
• ✅ Accepted matches are restored
• ✅ Search preferences remembered

Important: Don't close the tab completely! The system sends a leave request when the tab closes, removing you from the queue.

Click the "Change Character" button. This will:

1. Remove you from the queue (if in queue)
2. Clear all session data
3. Return you to the import screen

Then import your new character's link from the addon.

The left sidebar shows real-time queue statistics:

• 🗝️ Group Leaders: Players with keystones looking for party members
• 🔍 Looking for Group: Players searching for a group to join
• 🛡️ Tanks: Total tanks in queue (both hosts and players)
• 💚 Healers: Total healers in queue
• ⚔️ DPS: Total DPS in queue

Matches are canceled if:

• ❌ Someone declined: Any player clicks "Decline"
• ❌ Timeout (90 seconds): Not all players accepted in time
• ❌ Player disconnected: Lost connection to server

When a match is canceled, all players are returned to the queue with priority (they move to the front of the line).

Not yet, but the website is mobile-responsive. You can use it on your phone's browser while playing WoW on PC.

Note: Sound notifications and background updates work best on desktop browsers.

PartyFinder is open source! You can:

• 📝 Report bugs on Discord
• 💡 Suggest features on GitHub Discussions
• 📧 Contact the developer via Discord (link on main page)