🎲 dsh-dice-game — Dice Battle (骰子大作战)

🏮 源自中国山西晋城的地方骰子玩法 — These six dice games are traditional folk games from Jincheng, Shanxi, China (中国山西省晋城市). 骰子大作战收录了晋城地区流行的六种经典骰子玩法，是当地茶余饭后、亲友聚会的传统娱乐。

A collection of classic dice games that runs as a DSH Web GUI plugin. The sidebar entry "🎲 骰子大作战" opens the game panel right in the center column. Fully bilingual (中文 / English) — tap the 🌐 button in the top-right corner to switch languages at any time.

经典骰子游戏合集，作为 DSH Web GUI 插件运行。侧边栏「🎲 骰子大作战」入口打开游戏面板，直接在中心列游玩。支持中英文切换——点击右上角 🌐 按钮随时切换语言。

Games / 玩法

📜 晋城传统玩法 — All six games are played across Jincheng, Shanxi, China.

• Liar's Dice (吹牛) — the classic bluffing dice game, single-player vs AI, with PeerJS WebRTC online play · 经典吹牛骰子，单人 vs AI + PeerJS 联机
• Guess Red Dots (猜红点) · 晋城特色：①=1分 ④=4分
• Guess Red/Blue (猜红蓝) · 红蓝点对决
• Guess Big/Small (猜大小) · 大小博弈
• Guess Odd/Even (猜单双) · 单双对决
• Guess Straight (猜顺子) · 顺子挑战

The game is pure frontend HTML (assets/index.html + peerjs.min.js + qrcode.min.js), served same-origin by the plugin host via the /dice-game/ route, loaded in the center-column iframe.

About / 关于玩法

晋城骰子文化 (Jincheng Dice Culture)：

骰子大作战收录的六种玩法均源自中国山西省晋城地区——这里是太行山南端的古城，民间骰子游戏历史悠久。吹牛、猜红点、猜红蓝、猜大小、猜单双、猜顺子，是晋城百姓聚会、待客时喜闻乐见的传统娱乐。本插件将这些地方玩法数字化，让更多人了解晋城的骰子文化。

The six games in Dice Battle all originate from Jincheng, Shanxi Province, China — an ancient city at the southern end of the Taihang Mountains with a long folk tradition of dice games. This plugin digitizes these local games so more people can discover Jincheng's dice culture.

Languages / 语言

• 🌐 Chinese & English switchable in-game (persisted in localStorage)
• 中文与英文双语切换（自动记忆选择）

Install / 安装

dsh plugin --profile web add dsh-dice-game
# or local development:
dsh plugin --profile web add link:/root/软件项目/骰子大作战

Restart dsh web, then click "🎲 骰子大作战" in the sidebar to start playing.

Development / 开发

npm install
npm run build      # tsdown build + copy assets to lib/assets
npm run watch      # watch mode

Project structure / 项目结构

src/
  index.ts          # Host: /dice-game static route + agent system prompt
  client/
    index.ts        # Client entry: sidebar entry + game panel
    controller.ts   # Panel open/close state (framework-free)
    sidebar-entry.ts# Sidebar entry (DOM injection + MutationObserver self-heal)
    mount.ts        # Center-column panel (title bar + iframe)
    styles.ts       # Panel & entry styles (--dsw-* theme vars)
assets/             # Game static assets (copied to lib/assets on build)
cordis.patch.yml    # profile bundle mount patch

Known limitations / 已知限制

• Online mode depends on the PeerJS public signaling server (may need a proxy in mainland China)
• Game is for casual entertainment only — no real money or gambling

License / 许可

MIT