晋城骰子大作战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
- 猜红点 (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

中英双语宣传海报 (Bilingual promotional 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

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

⚠️ 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