Wifi Card Games (wifi-card-games)

A multiplayer card game collection mod for Minecraft 1.21.1 (Fabric · server-authoritative).
Currently includes:

• Dou Dizhu (Fight the Landlord) – Classic / Wildcard modes, Standard / Folk rule sets

• Board games – Reversi (Othello), Gomoku, and Go (shared lobby & room system)

• UNO – up to 10 players

• Mod ID: wifi-card-games

• Entry point: io.wifi.cards.CardGameMod (umbrella entry, preparing for future games)

• Submodules:

  • Dou Dizhu: io.wifi.cards.doudizhu
  • Board games: io.wifi.cards.board (Othello/Gomoku/Go)
  • UNO: io.wifi.cards.uno

🌐 Language Support

• Text includes all in‑game UI labels, chat messages, rule descriptions, and button texts.
• Voice refers to the voice‑over for UNO calls (“UNO”, “Draw two”) generated via edge‑tts. The voice is always in Chinese regardless of the selected language; English does not have its own TTS voice. Other sound effects use Minecraft’s built‑in sounds, which are language‑independent.
• The mod automatically detects the client’s language setting and switches text accordingly.
• Traditional and Simplified Chinese are handled as separate locales (zh_CN and zh_TW) with distinct translation files.

✨ Features

Rooms & Multiplayer (in-memory only, no persistence)

• Create room: choose Classic/Wildcard mode, Standard/Folk rule set, and whether to announce to chat.
• One‑click join: announced rooms show [Click to Join]; or enter a room code manually.
• Invite: /doudizhu invite <player> sends a clickable invitation.
• Auto‑start: when 3 players are ready, the game begins; you can leave anytime during waiting or playing.

Dou Dizhu Gameplay

• Bidding: pass / 1 / 2 / 3 points (must exceed current highest bid).
• Landlord contest: if someone bids 3, a round of “rob/not rob” follows; two consecutive “not rob” ends the round (base score 3). If no one bids 3, the highest bidder becomes landlord. If all pass, redeal.
• Card play: full hand-type recognition and comparison (single, pair, triple, triple+single, triple+pair, straight ≥5, consecutive pairs ≥3, airplane with wings, four‑with‑two, bomb, rocket – no triple‑king bomb). Bombs/rockets double the multiplier immediately.
• Wildcard mode (55 cards, 4 bottom cards): wildcards can substitute any card; wildcard + triple = wildcard bomb. Triple+pair is forbidden in this mode.
• Show hand: landlord may reveal all cards before playing the first hand – visible to all (cards are removed from display as they are played).
• 30‑second turn timer: auto‑action on timeout.

Auto‑play & Stability

• Auto‑play: can be toggled at any time from the game screen (bidding → pass, robbing → not rob, playing → best move).
• Auto‑play on disconnect: if a player disconnects during a game, a bot takes over; on reconnect, full state sync (hand, bottom cards, multiplier, timer, revealed cards, auto‑play status).
• Exit game: players can voluntarily exit (button) or be kicked by an operator; their seat becomes bot‑controlled. If no real players remain, the room is closed.

Interface

• Text‑based card display: click/slide to select cards (sliding over unselected selects it, over selected deselects it – no missed cards), hint button, show‑hand button.
• In‑game chat: press the chat key (default T) to open chat; closing or sending returns to the game; chat history rendered by vanilla HUD.
• Lobby / rule introduction (scrollable, muteable) / settlement screen; no global blur – only content areas have a semi‑transparent dark background.

♟️ Board Games (Reversi / Gomoku / Go)

All three board games share one lobby, room system, network protocol, and board interface (/chess).
The board is rendered via gui.pose().scale() to adapt to window size – it scales up for large windows and down for small ones, never overflowing or covering buttons; click detection remains accurate even at small sizes.

Rooms & Multiplayer

• Unified lobby /chess: choose a game (Go offers 9×9 or 19×19) → create room; or enter a room code to join.
• Room list in lobby: shows all rooms – waiting rooms can be joined; ongoing games can be spectated.
• Spectating: after a game starts, you can spectate (from lobby list / chat announcement / /chess spectate <code>). Real‑time board display, unlimited spectators, exit anytime.
• Auto‑start: when 2 players are ready, game begins; announced rooms are clickable; /chess invite <player> to invite.

Gameplay

• Reversi (8×8): Black goes first; if no legal move, pass automatically; if both pass, count pieces to determine winner.
• Gomoku (15×15): Black first; first to get five in a row wins; full board = draw; no forbidden moves.
• Go (9 or 19 lines): Black first, play on intersections; liberties / captures / no suicide / simple ko; if both pass consecutively or 4 consecutive passes occur, score by Chinese rules with komi 3.75.
• 60‑second turn timer: on timeout, Gomoku/Reversi let AI play one move (heuristic/greedy); Go simply passes.
• Resign anytime (Go also has a “pass” button).
• Rule introduction: lobby “Rules” button or in‑game “Rules” button (scrollable, full rules for all three games).
• In‑game chat: press chat key (default T) to open; closing/sending returns to the board.

Auto‑play & Stability

• Gomoku/Reversi: on exit/disconnect, seat becomes bot‑controlled (AI plays); on reconnect, full snapshot sync.
• Go has no auto‑play: if a player exits/disconnects, the game ends immediately (the other wins); if both pass repeatedly, the game ends by counting.
• If no real players remain (or all offline), the game ends and the room is closed.
• Debug bot: for Gomoku/Reversi, you can add 1 AI opponent when creating a room (Go does not provide AI).

🎴 UNO (up to 10 players)

Standard 108 cards (4 colours 0–9 + Skip/Reverse/+2, 4 Wild, 4 Wild+4). Each player starts with 7 cards; the first card flipped must be a number card. Max 10 players per room. The host (seat 0) clicks “Start Game” to begin (needs at least 2 players; you may add 0–9 bots when creating the room).

Gameplay

• Play: must match colour or number with the top card; Wild cards can always be played (colour selection pop‑up before playing).
• Action cards: Skip skips next player; Reverse reverses direction (in 2‑player games, it acts as Skip); +2 makes next player draw 2 and lose their turn; Wild+4 lets you choose colour and the next player draws 4 and skips (no “must have no matching colour” restriction – casual rule).
• Draw: if you cannot play, click “Draw” (or the deck) to draw 1 – if it’s playable, you may play or pass; if not, turn passes automatically. If deck is empty, reshuffle the discard pile (keep top card).
• UNO call: when you play your penultimate card (leaving 1), you must click “Call UNO!”. If you don’t and another player catches you with “Catch … UNO”, you draw 2 (the catch window closes after success). If no one catches you, you automatically draw 2 when it becomes your turn again (chat + table prompt + voice “Draw two”). The window for catching expires when your next turn starts.
• First to empty hand wins (single round). Settlement screen offers “Play again” (room stays open, restart).
• 30‑second turn timer: on timeout, auto‑draw (and auto‑play if possible).

Auto‑play & Stability

• Auto‑play: togglable anytime (finds playable card, auto‑selects colour, auto‑calls UNO).
• Auto‑play on disconnect: bot takes over; on reconnect, full sync (hand, current colour, direction, timer, UNO status, auto‑play status).
• Exit: voluntary exit or kick; seat becomes bot‑controlled. If no real players remain, room closes.
• Spectating: after game starts, spectate via chat announcement or /uno spectate <code> – left panel shows every spectator the complete hands of all players.
• Voice: UNO call plays “UNO”; being caught plays “Draw two” (generated via edge‑tts, source in tools/input_uno.txt, script tools/gen_sound.py). Other sound effects use Minecraft built‑in sounds.
• Interface: lobby (with rules), table left‑bottom “Rules / History” (event log: plays/draws/penalties/UNO calls, player names highlighted, scrollable), settlement screen. In‑table chat via chat key (default T), returns to game after closing/sending.

📦 Requirements

🚀 Installation

1. Install Fabric Loader for Minecraft 1.21.1.
2. Download this mod jar and Fabric API, place them in your mods folder.
3. Launch the game (singleplayer or multiplayer; the server must also have the mod and Fabric API installed).

🎮 Quick Start

Dou Dizhu:

1. Type /doudizhu to open the lobby.
2. Create room (choose mode/rule set/announce) or enter a room code to join.
3. With 3 players, game starts automatically (for testing: /doudizhu debug bots 2 adds dummy players).
4. Bid → contest → play cards; you can toggle “Auto‑play” or “Exit” anytime.

Board games (Reversi / Gomoku / Go):

1. Type /chess to open the board lobby.
2. Choose a game (Go: choose 9 or 19) → Create room, or enter a room code to join; the lobby list shows ongoing games you can spectate.
3. With 2 players, game starts automatically (for testing: /chess debug bots 1 adds an AI opponent for Gomoku/Reversi, not for Go).
4. Click the board to place; you can “Resign” or “Exit” anytime; Go has a “Pass” button.

UNO:

1. Type /uno to open the lobby.
2. Create room (add 0–9 bots, choose announce) or enter a room code to join.
3. The host clicks “Start Game” (needs at least 2 players) to begin.
4. Play/draw cards; when you have 1 card left, remember to “Call UNO!”; first to empty hand wins; click “Play again” for a new round.

⌨️ Commands

Dou Dizhu:

Board games:

UNO:

🃏 Rules Summary (Dou Dizhu)

• Card ranks: 3 < 4 < … < 10 < J < Q < K < A < 2 < 小王 < 大王
• Hand types: single / pair / triple / triple+single / triple+pair (not in Folk rules) / straight (≥5) / consecutive pairs (≥3 pairs) / airplane (≥2 groups, with optional wings) / four‑with‑two / bomb / rocket (big + small joker)
• Comparison: same type and same count → compare highest rank; four‑with‑two cannot be compared with each other; bomb beats any non‑bomb, rocket beats all, bombs compare by rank.
• Wildcard mode: wildcards are jokers that can substitute any card; wildcard + triple = wildcard bomb; triple+pair is forbidden.
• Scoring: base score × multiplier (bombs/rockets/wildcard bombs double immediately). Landlord win: +2×base×multiplier for landlord, each farmer −base×multiplier; loss gives opposite (displayed only for that round, not stored).
• Full rules are available in‑game via the “Rules” screen.