晋城骰子大作战 zmm863-commits/dsh-dice-game

🎲 晋城骰子大作战 (Jincheng Dice Battle)

🏮 源自中国山西晋城的地方骰子玩法 — 这六种骰子玩法都是中国山西省晋城市的传统民间游戏。
晋城骰子大作战收录了晋城地区流行的六种经典骰子玩法，是当地茶余饭后、亲友聚会的传统娱乐。

晋城骰子大作战 海报

经典骰子游戏合集，作为 DSH Web GUI 插件运行。侧边栏「🎲 骰子大作战」入口打开游戏面板，直接在中心列游玩。

📌 当前状态：单机版 — 联机功能暂缓上线（MP_DISABLED = true），目前为单人 vs AI 模式；后续版本恢复联机。
当前为单机版：联机功能暂缓上线（MP_DISABLED），目前为单人 vs AI 模式；后续版本恢复联机。

Games / 玩法

📜 晋城传统玩法 — 六种玩法都流传于中国山西省晋城。

- Liar's Dice (吹牛) — 经典吹牛骰子，单人 vs AI · 经典吹牛骰子，单人 vs AI
- Guess Red Dots (猜红点) · 晋城特色：①=1分 ④=4分
- Guess Red/Blue (猜红蓝) · 红蓝点对决
- Guess Big/Small (猜大小) · 大小博弈
- Guess Odd/Even (猜单双) · 单双对决
- Guess Straight (猜顺子) · 顺子挑战

游戏为纯前端 HTML（assets/index.html + peerjs.min.js + qrcode.min.js），由插件 host 通过 /dice-game/ 路由托管，在中心列 iframe 中加载。iframe 使用不透明源沙箱（无 allow-same-origin）：游戏文档与 DSH GUI 完全隔离，无法读取页面 DOM、Cookie、localStorage 或同源 API。PeerJS/WebRTC 联机仍可正常使用，因为信令走 PeerJS 云端（wss），不依赖同源权限。

About / 关于玩法

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

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

晋城骰子大作战收录的六种玩法均源自中国山西省晋城地区——这里是太行山南端的古城，民间骰子游戏历史悠久。本插件将这些地方玩法数字化，让更多人了解晋城的骰子文化。

Poster / 海报

中英双语宣传海报见 docs/poster.png。

Install / 安装

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

重启 dsh web，然后点击侧边栏「🎲 骰子大作战」即可开始游玩。

Development / 开发

npm install
npm run build # tsdown build → __ModuleLoader__ client wrap → copy assets
npm run watch # watch mode

⚠️ Client bundle note: the build runs build.mjs after tsdown, wrapping
lib/client.js in window.__ModuleLoader__.load({ id, factory }) — the format DSH's client-modules requires. Do not remove this step, or the web shell fails to boot when the plugin is installed.

⚠️ Client bundle 说明：构建在 tsdown 之后运行 build.mjs，将 lib/client.js 包装为 DSH client-modules 要求的
window.__ModuleLoader__.load({ id, factory }) 格式。请勿移除该步骤，否则
安装插件后网页 shell 将无法启动。

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)
build.mjs # __ModuleLoader__ client bundle wrapper
cordis.patch.yml # profile bundle mount patch
docs/ # Poster & promotional assets

Known limitations / 已知限制

- Online multiplayer is temporarily disabled (MP_DISABLED) — single-player only for now · 联机暂缓上线，当前为单机版
- Game is for casual entertainment only — no real money or gambling · 游戏仅为休闲娱乐用途，不含任何真实货币或赌博功能

反馈 / Feedback

有任何问题、建议或想汇报 bug？欢迎在 GitHub 提 issue：

- 🐛 Bug 反馈：描述问题 + 复现步骤 + 截图（如有）
- 💡 功能建议：告诉我们你想加什么玩法或改进
- 💬 一般讨论：任何关于骰子游戏的反馈都欢迎

👉 提交 Issue

📧 联系邮箱：25894126@qq.com

License / 许可

MIT