massivedecks/client

Massive Decks 客户端镜像

镜像概述

Massive Decks 客户端镜像是开源喜剧派对游戏 Massive Decks 的前端组件。Massive Decks 是一款基于 Cards against Humanity 的免费开源游戏，支持多人在线或同室游玩，玩家可通过任何设备（手机、PC、Chromecast 等具备浏览器的设备）参与游戏。客户端负责提供用户界面，实现游戏交互功能。

核心功能与特性

• 跨设备支持：可在任何具备网页浏览器的设备上运行，无需安装专用应用
• 灵活游玩方式：支持同室聚会或在线远程游玩
• 自定义内容：通过 Many Decks 加载自定义牌组
• 规则定制：
  • 支持自定义卡片
  • 可设置家庭规则
  • 包含 AI 玩家功能
  • 可自定义游戏时间限制
• 观众模式：允许观众观看游戏进程
• 隐私保护：游戏默认私密，可设置密码保护
• 多语言支持：提供社区翻译

使用场景

• 朋友聚会或家庭娱乐的派对游戏
• 线上远程聚会的互动游戏
• 需要自定义游戏内容和规则的场景
• 希望私有部署游戏服务的场景

技术细节

客户端采用 Elm 语言开发，与使用 https://www.typescriptlang.org/ 开发的后端服务配合工作。

使用方法与配置说明

镜像获取

客户端镜像托管在 GitHub Container Registry，可通过以下命令拉取：

bash
docker pull ***-ghcr.xuanyuan.run/lattyware/massivedecks/client:latest

部署示例

Docker Compose 配置

Massive Decks 客户端需与服务器端配合使用，以下是基础的 docker-compose.yml 示例（完整示例可参考项目 https://github.com/Lattyware/massivedecks/tree/main/deployment）：

yaml
version: '3'

services:
  client:
    image: ***-ghcr.xuanyuan.run/lattyware/massivedecks/client:latest
    ports:
      - "80:80"
    depends_on:
      - server
    environment:
      - REACT_APP_API_URL=http://server:8080/api
    restart: unless-stopped

  server:
    image: ***-ghcr.xuanyuan.run/lattyware/massivedecks/server:latest
    environment:
      - PORT=8080
      - DATABASE_URL=sqlite:///data/massivedecks.db
    volumes:
      - server-data:/data
    restart: unless-stopped

volumes:
  server-data:

配置说明

客户端主要通过环境变量进行配置，常用参数包括：

• REACT_APP_API_URL：指定后端服务器 API 地址（必填）
• REACT_APP_SENTRY_DSN：Sentry 错误跟踪配置（可选）

相关资源

• https://github.com/Lattyware/massivedecks/wiki/Deploying
• https://github.com/Lattyware/massivedecks
• https://github.com/users/Lattyware/packages/container/package/massivedecks%2Fserver