# Darkmoon Party Shuffle

Organize your dungeon nights entirely in-game — with a Darkmoon Faire twist.
One player **opens a table**, others **take a seat** from the addon with a
click, and the dealer **shuffles** everyone into balanced groups of 5. Each
player is dealt their own hand — flip the cards to see who you're running with.
No website, no sign-up, no spreadsheets.

Built for **Mythic+ and keystones**, and works for any 5-man dungeon content.

## What it does
- **Open a table** (create an event) in seconds and share a short code — your
Name-Realm.
- Players **take a seat** 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.
- **Your hand, as cards**: your group is dealt to you as a hand of Darkmoon
cards — face-down at first, click to flip and reveal each member. A new
shuffle re-deals the hand.
- **Dealer controls**: keep the hands hidden, then **Deal** to reveal them to
everyone (or **Collect** to hide again). Re-shuffle, kick a player, or close
the table. State survives a /reload.
- **Quality at a glance**: per-group average item level, keystone range, and
warnings (missing tank/healer, no Bloodlust/Battle-Rez).
- **Gather your hand**: the designated inviter forms the in-game party with one
click.

## 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. **Open a table**, or **take a seat** at one by host name.
3. Click **Shuffle** — the cards are dealt. Hit **Deal** to reveal every hand.

## 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
- Logo source asset: "Card exchange" by Delapouite — game-icons.net (CC BY 3.0).
In-game World of Warcraft textures (Blizzard) are used for the runtime icon
and the Darkmoon-themed UI.
- Open source, MIT licensed. Made by Rothkill.