# Loot & Baloot

**Saudi Baloot (بلوت), played at your WoW party table.**

Loot & Baloot brings the classic four-player trick-taking card game to World of Warcraft. The whole game runs over the addon channel — no external services, no logins, nothing to configure. Open the window, sit four players (or fill seats with bots), and deal.

Built and tested for **Retail / Midnight (Interface 12.0.5)**.

---

## What you get

- **Full Saudi Baloot ruleset.** Hokm (الحكم) trump contracts, Sun (الصن) no-trump contracts, the complete bidding chain, the meld system, last-trick bonus, and round-target play to 152.
- **Authentic mechanics:**
- **Double/ Triple / Four / Gahwa** escalation (×2, ×3, ×4, gahwa)
- **Belote** (K+Q of trump, +20) with the cancellation rule
- **Al-Kaboot** (كبوت) — both forward sweep and reverse كبوت المقلوب, gated on bidder leading trick 1
- **Takweesh** (تكويش) and **Kawesh** (كوش) outcomes
- **AKA** call, including the implicit Ace-led signal and receiver relief
- **SWA (سوا)** "claim the rest" with full minimax validation and the polite ≥4-cards permission gate
- **Sun overcall window** — bidder UPGRADE, non-bidder TAKE, or TAKE_HOKM with a different trump suit
- **Triple-on-Ace pre-emption (الثالث)**
- **Sequences** (3/4/5+), **Carrés** of T/J/Q/K and Aces (with Sun-only Four-Hundred), tied-meld dealer-right priority
- **Four bot tiers**, each strictly extending the previous — switch on per host:
- **Standard** — solid baseline
- **Advanced** — partner-bid awareness, score-position adjustments, AKA self-call, position-aware following, J-of-trump gating
- **M3lm (معلم)** — partner/opponent play-style ledger across the full game, match-point urgency, coordinated escalation
- **Fzloky (فزلوكي)** — signal-aware: reads partner's first discard as a suit-preference cue
- **Saudi Master** — determinization-sampling MCTS-flavoured decision engine
- **Robust networking.** Host/client model over the WoW party addon channel. Sessions survive `/reload` — state, hands, escalation timers, SWA windows, redeals, and pre-emption windows all re-arm cleanly.
- **AFK protection.** Per-turn timers with a local T-10s pre-warn (audio + UI pulse). If a seated player drops from the party, the host kicks the seat automatically.
- **Quality-of-life.** Minimap icon, lobby with party sidebar, persistent team names, configurable target score, slash commands (`/baloot`).

---

## How to play

1. Form a WoW party (any size up to 4 humans).
2. Anyone with the addon types `/baloot` to open the lobby.
3. The host fills seats — humans from the party list, or bots at any tier.
4. Deal and play. Standard Saudi rules apply: 32-card deck, 4-3-3 deal, R1 declare-trump-on-bid-card / R2 free-trump bidding, 8 tricks, target 152.

Solo play with three bots works fine — the host is just you.

---

## Slash commands

- `/baloot` — open the lobby
- `/baloot advanced` / `m3lm` / `fzloky` / `saudimaster` — toggle bot tiers
- `/baloot swa` — toggle SWA mechanic
- `/baloot swaperm` — toggle the polite-permission gate for ≥4-card SWA calls
- `/baloot target <N>` — set the cumulative target (default 152)
- `/baloot debug` — verbose logs

*Loot & Baloot is a fan project. World of Warcraft is a trademark of Blizzard Entertainment. Baloot is a Saudi Arabian card game with no formal ownership; this implementation follows the conventions documented in published Saudi rulebooks and widely-referenced gameplay videos.*