what is doudizhu fr?

aurexloveu/doudizhu — explained in plain English

Analysis updated 2026-05-18

★ 21JavaScriptAudience · generalComplexity · 3/5Setup · moderate

vibe map

mindmap
  root((repo))
    What it does
      Chinese card game
      Play vs AI opponents
      Browser-based
    How to run
      Node.js 18 plus
      Local web address
      Auto data folder
    Game features
      Full 54-card deck
      Bombs and bidding
      Seasonal scoring
      15-second turn limit
    Social features
      Chat and emoji
      Props like tomatoes
      Table cloth designs
      Music and sounds
    Tech stack
      JavaScript
      Node.js
      WebSockets
    Developers
      Plug in custom AI
      JSON stdin stdout
      Automated tests

mindmap root((repo)) What it does Chinese card game Play vs AI opponents Browser-based How to run Node.js 18 plus Local web address Auto data folder Game features Full 54-card deck Bombs and bidding Seasonal scoring 15-second turn limit Social features Chat and emoji Props like tomatoes Table cloth designs Music and sounds Tech stack JavaScript Node.js WebSockets Developers Plug in custom AI JSON stdin stdout Automated tests

what do people make with this?

VIBE 1

Play Dou Dizhu at home against two AI opponents directly in your web browser.

VIBE 2

Write your own AI bot that communicates via JSON and test it against built-in opponents.

VIBE 3

Host a family game night with chat, emoji reactions, and fun props like tomatoes and eggs.

VIBE 4

Run a multi-round card game session with automatic scoring and persistent player profiles.

what's the stack?

JavaScriptNode.jsWebSockets

how it stacks up fr

	aurexloveu/doudizhu	ahmedabdodev/fcis-gpa-helper	amazingsyp/pokemon-ontology
Stars	21	21	21
Language	JavaScript	JavaScript	JavaScript
Setup difficulty	moderate	easy	easy
Complexity	3/5	2/5	3/5
Audience	general	general	researcher

Figures from each repo's GitHub metadata at analysis time.

how do i run it?

Difficulty · moderate time til it works · 30min

Requires Node.js 18 or higher and running a local server before opening the game in your browser.

No license information is provided in the repository, so default copyright restrictions apply and usage rights are unclear.

in plain english

This repository is a browser-based version of Dou Dizhu, a popular Chinese card game for three players. It is designed for family play at home, with one real human seat and two AI opponents filling the remaining spots. The game runs as a self-contained Node.js module, separate from the larger Aevi project it belongs to. The repository does not include the main Aevi website, chat system, memory features, or server configuration. To run it, you need Node.js 18 or higher. After installing dependencies and starting the server, you open a local web address in your browser. The public version connects three AI seats to real local strategy players by default, so no API key is needed. The referee service creates a data folder on first run to save scores, player profiles, and game state across sessions. The game includes a full 54-card deck with proper card pattern recognition, comparisons, dealing, bidding, passing, bombs, and seasonal scoring across multiple rounds. Each turn has a 15-second limit, and the referee steps in if something goes wrong, so a game never freezes. It uses real-time WebSocket syncing for live updates and offers family session lengths of 4, 8, 16, or 24 rounds, with 4 being the default. Beyond the core card play, the table includes chat, a round-by-round chat log after each session with one-click copy, 13 emoji reactions, interactive props like tomatoes and eggs, four table cloth designs, sound effects, and two background music tracks. Players have profiles and can vote to dissolve a session. Developers can plug in their own AI by writing a program that reads JSON from standard input and writes JSON to standard output. The referee validates every move and retries once on errors before auto-playing. Tests cover card patterns, scoring, persistence, interactions, and asset verification.

prompts (copy fr)

prompt 1

I want to write a custom AI bot for this Dou Dizhu card game. Show me how to create a program that reads JSON from standard input, determines the best move, and writes JSON back to standard output in the format the referee expects.

prompt 2

Help me set up and run this browser-based Dou Dizhu game on my computer. I have Node.js 18 installed, walk me through installing dependencies, starting the server, and opening the game in my browser.

prompt 3

I want to understand the card pattern recognition and comparison rules in this Dou Dizhu game. Explain the full 54-card deck system, how bombs work, and how bidding and passing function.

prompt 4

Help me extend this Dou Dizhu game by adding a new emoji reaction or a new interactive prop. Walk me through where assets are stored and how the asset verification tests work.

Frequently asked questions