heart7 - 扑克牌游戏 “憋七” 的Rust实现

效果图

WEB端效果图

服务端运行指南

• 编译：cd server; make
• 运行服务端heart7d --listen <IP:PORT>，不加参数默认监听0.0.0.0:20007
  • log在stdout

TUI客户端运行指南

• Requirements

  • Nerd Fonts
  • 一个现代的终端模拟器，比如alacritty、kitty等
  • 不保证Windows上的编译、运行和显示
  • 不要使用任何除ascii可显示字符以外的字符！！！！！

• 编译运行

  • cd client_tui; make run
  • 默认日志不记录，可以通过环境变量LOGFILE来设置
  • 可通过-a选项更改默认服务器地址，如heart7 -a 1.2.3.4:12345

• 操作方式

  • 全键盘操作，支持动态调整终端大小，最小需要160*48
  • 通过上下左右键移动光标位置（有高亮提示），ENTER键确认
  • 输入框支持左右方向键、DELETE和BACKSPACE
  • 连接服务器：输入服务端地址
  • 输入用户名，选择创建房间或者加入已有房间
  • 创建房间需输入房间名，不能与其他房间名重复
  • 加入房间后等待4位玩家到齐，按ENTER键确认准备开始
  • 游戏过程中，通过上下键选择是出牌或者扣牌，通过左右键调整选定的牌
    • 能接的牌有实时高亮显示，无牌可接会有提示
    • 画面右下角列出了自己扣掉的牌，其他玩家的名字附近标有其扣牌数量
    • 牌桌（画面中央）上显示花色排列的状态，黄色高亮的表示本轮出牌，绿色高亮表示本轮自己出牌
  • 游戏结束画面包括：
    • 游戏胜负
    • 每位玩家的扣牌
    • 牌桌上接出的牌的具体状态，每张牌高亮的颜色用于区分是谁接的牌（每个玩家对应的颜色在其名字上标出）
    • 按ENTER继续游戏
  • 在任意状态下，按ESC可调出菜单，选择退出游戏、退出房间、退出程序
  • 在任意状态下，按Ctrl-C强制退出程序

WEB客户端操作指南

• 部署：
  • cargo install trunk
  • cd client_wasm; make serve
• 浏览器访问服务地址的10007端口（默认）即可
• 通过鼠标或者触摸点按即可完成操作
• 对于电脑，点击输入框才可以输入；对于手机，点按输入框会跳出输入法
• 建议使用Chrome、Edge、Firefox等主流浏览器

“憋七”的游戏规则

• 4位玩家平均发52张牌（不含大小王），每人13张，轮流出牌，在桌面上形成4种花色的A到K的排列
• 每种花色的排列从7开始，向两侧延伸
• 发到红桃7的玩家先出牌，按逆时针依次出牌（PLAY）
• 如果没有牌可以接，需要扣牌（HOLD）；全场第一张扣牌不可以是A
• 只要有牌接，就不可以扣牌
• 7不可以扣
• 最终计算每位玩家的扣牌总点数（A-K对应1-13），总点数最少的玩家获胜；如遇到同分，按照出牌顺序，上家输
• 如果某位玩家没有扣牌，则称“净手”（CLEAR）;如果净手且最后出一张7,则称“立七”
• 有人净手后，所有人不得再出牌，全部扣掉

实现

• C/S架构，通信使用gRPC/web-gRPC（tonic + tonic-web）
• 服务端使用tokio进行异步
• TUI客户端使用tokio进行异步，界面显示使用ratatui + crossterm
• WEB客户端使用wasm-bindgen对接JavaScript的Promise进行异步，界面显示使用web-sys + gloo，使用原生HTML5 Canvas API