# Mythic+ Party Shuffle

Organize your Mythic+ nights entirely in-game. One player creates an event,
others join from the addon with a click, and the organizer shuffles everyone
into balanced groups of 5 — each player instantly sees their own group.
No website, no sign-up, no spreadsheets.

## What it does
- Create an event in seconds and share a short code.
- Players join from the addon — their character is auto-detected (class, spec,
role, item level). Nothing to type.
- Smart shuffle into balanced groups: one tank + one healer per group when
possible, melee/ranged spread evenly, Bloodlust and Battle-Rez distributed
across groups, and anti-repetition so you don't run with the same people
every time.
- Everyone sees their own group live. The organizer can keep groups hidden
until ready, then reveal them.
- Group quality at a glance: per-group average item level, keystone range, and
warnings (missing tank/healer, no Bloodlust/Battle-Rez).
- Organizer tools: re-shuffle, kick a member, close the event. Event state
survives a /reload.

## How it works (no backend)
Everything syncs peer-to-peer over the game's addon channels — there is no
server and nothing leaves the game. Players on your realm (or connected realms)
join with a code; cross-realm and cross-faction play is supported through a
shared in-game WoW Community.

## Quick start
1. Install and type /mpps.
2. Create an event, or join one with a code.
3. Click Shuffle — done.

## Notes & limits
- Everyone who participates needs the addon installed.
- Same faction + realm/connected realms works with just a code. For cross-realm
or cross-faction, members share a WoW Community.

## Feedback
Bug reports and suggestions are very welcome in the comments / issues.

## Credits
- Icon: "Card exchange" by Delapouite — game-icons.net (CC BY 3.0).
- Open source, MIT licensed. Made by Rothkill.