# partygame

**Repository Path**: cflmy/partygame

## Basic Information

- **Project Name**: partygame
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-06-18
- **Last Updated**: 2026-06-18

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 暮云聚会游戏

一个专注于**聚会游戏**的 Web 项目（PartyGame），适合朋友聚会、家庭活动、团建等场景，提供轻量、有趣、即开即玩的互动体验。

## 在线访问

项目部署地址：[https://partygame.cflmy.cn](https://partygame.cflmy.cn)

## 项目简介

PartyGame（暮云聚会游戏）旨在收集和实现各类适合多人参与的聚会小游戏，让线下聚会更有互动性和趣味性。项目采用 PHP 作为后端，便于部署到常见的虚拟主机环境，降低运维成本，方便快速上线与迭代。

## 游玩模式

每款已上线游戏均支持以下两种模式，进入游戏后可在首页选择：

| 模式 | 适用场景 | 说明 |
| ---- | -------- | ---- |
| **传手机玩** | 只有一台设备、围坐同屏 | 一台手机或平板轮流操作，适合线下面对面聚会；无需联网同步，即开即玩。 |
| **房间联机** | 每人有自己的手机 | 房主创建房间并分享 6 位房间号，其他玩家输入房间号加入；多设备实时同步进度，支持观战。 |

### 房间联机简要流程

1. 选择「房间联机」→ 创建房间或加入房间（填写昵称）
2. 房主在大厅等待玩家到齐后点击「开始游戏」
3. 游戏进行中由房主推进流程（部分游戏允许所有玩家投票/猜数等互动）
4. 可随时「离开房间」；被房主踢出后会收到提示，可重新加入

> **角色说明**：房主负责创建房间、开始游戏及推进回合；普通玩家以同步观看与参与互动为主，界面会显示「等待房主…」等提示，与房主看到的操作按钮不同。

## 游戏清单

### 已开发完成

以下游戏均已支持 **传手机玩** 与 **房间联机** 两种模式：

| 游戏 | 路径 | 人数建议 | 简介 |
| ---- | ---- | -------- | ---- |
| 真心话大冒险 | [`/games/truth-or-dare/`](public/games/truth-or-dare/) | 2 人起 | 转瓶抽人，选择真心话或大冒险；三档强度题库。 |
| 从来没有 | [`/games/never-have-i-ever/`](public/games/never-have-i-ever/) | 2 人起 | 「我从来没有……」陈述，做过的人放下手指，先放完者接受惩罚。 |
| 你宁愿 | [`/games/would-you-rather/`](public/games/would-you-rather/) | 2 人起 | 两难选择题，投票统计 A / B 选项倾向。 |
| 数字炸弹 | [`/games/number-bomb/`](public/games/number-bomb/) | 2 人起 | 在数字范围内轮流猜数，踩中炸弹者出局。 |
| 谁是卧底 | [`/games/undercover/`](public/games/undercover/) | 4~12 人 | 发词、描述、投票，找出隐藏卧底；8 人及以上可开启 2 个卧底。 |

### 准备开发 / 规划中

以下玩法按开发优先级分为三档，欢迎通过 [Issue](https://gitee.com/cflmy/partygame/issues) 讨论细节或提交 Pull Request 参与开发。新游戏上线后优先支持 **传手机玩**，需要多机同步的再接入 **房间联机**。

#### 第一梯队（优先开发 · 可快速复用现有框架）

| 游戏 | 计划模式 | 简介 |
| ---- | -------- | ---- |
| 两真一假 | 传手机 → 房间联机 | 每人准备 3 条陈述（2 真 1 假），其他人猜哪条是假的；适合深度破冰。 |
| 答非所问 | 传手机 → 房间联机 | 轮流提问，回答者必须答非所问，答得太正常者输；华人聚会常见暖场游戏。 |
| 国王游戏（轻量版） | 传手机 → 房间联机 | 随机指定「国王」编号，对对应号码发号施令；需安全指令库与内容审核。 |

#### 第二梯队（中等难度 · 差异化明显）

| 游戏 | 计划模式 | 简介 |
| ---- | -------- | ---- |
| 你比我猜 | 传手机 | 一人看词表演/描述，其他人猜；计时 + 得分，词库可按电影/食物/动作分类。 |
| 心口不一 | 传手机 | 齐喊口号，同时喊数字并伸手比划，心口一致者输；0 道具反应类暖场。 |
| 谁最可能 | 传手机 → 房间联机 | 「谁最可能……？」大家同时指向某人；陈述题库 + 随机抽题。 |
| 七秒挑战 | 传手机 | 7 秒内完成挑战（绕口令、做动作等）；可复用大冒险类题库 + 倒计时组件。 |

#### 第三梯队（投入较大 · 需专项设计）

| 游戏 | 计划模式 | 简介 | 主要难点 |
| ---- | -------- | ---- | -------- |
| 你画我猜（联机版） | 房间联机 | 一人作画、他人猜词，实时同步画布 | Canvas 同步、房间状态、低延迟 |
| 行动代号 | 传手机 → 房间联机 | 25 词网格 + 队长提示，双队对抗 | 词库、双队 UI、规则较复杂 |
| 狼人杀 / 间谍危机 | 房间联机 | 身份隐藏 + 多阶段发言与投票 | 状态机复杂，人数与流程要求高 |
| 抓鸭子 | 传手机 | 节奏口令游戏，跟节奏喊口号 | 轮次状态、节奏感 UX |
| 词语接龙 | 传手机 | 经典中文接龙，上家末字接下家首字 | 词库合法性校验、生僻字处理 |

### 开发路线图

```
Phase 1（快速扩充书架）          ✅ 已完成
  ✅ 真心话大冒险
  ✅ 从来没有
  ✅ 你宁愿
  ✅ 数字炸弹

Phase 2（提升粘性与推理类）      🔄 进行中
  ✅ 谁是卧底
  → 你比我猜（传手机版）
  → 两真一假
  → 答非所问

Phase 3（联机能力与重度玩法）    🔄 部分完成
  ✅ 房间码 + 多机同步（已上线 5 款）
  → 你画我猜联机版
  → 狼人杀（轻量版）
  → 行动代号
```

### 新游戏选型原则

适合接入本平台的游戏通常具备：

| 条件 | 说明 |
| ---- | ---- |
| 规则简单 | 30 秒内能讲清，适合破冰 |
| 少依赖道具 | 手机 / 浏览器即可，线下聚会也能用 |
| 单机可玩 | 同一设备轮流操作，或「传手机」模式 |
| 后端轻 | 题库 JSON + PHP 随机接口，不必强依赖 WebSocket |
| 氛围导向 | 输赢次要，互动和笑点是核心 |

强实时、高同步要求的玩法（如画布联机、复杂身份局）会排在第三梯队，在房间基础设施稳定后再专项推进。

## 技术栈

- **后端**：PHP 7+（适配虚拟主机部署）
- **前端**：HTML / CSS / JavaScript（原生实现，无构建步骤）
- **房间联机**：JSON 文件存储房间状态 + 前端轮询同步（`public/includes/room.php`、`public/assets/js/room-client.js`）

## 项目结构

```
partygame/
├── public/                    # Web 入口（虚拟主机网站根目录指向此处）
│   ├── index.php              # 首页与游戏列表
│   ├── includes/
│   │   ├── layout.php         # 页面布局
│   │   ├── room.php           # 房间存储与 API 逻辑
│   │   └── room_panels.php    # 模式选择 / 大厅 / 联机 UI 片段
│   ├── assets/
│   │   ├── css/room.css       # 房间联机通用样式
│   │   └── js/room-client.js  # 房间联机通用客户端
│   └── games/                 # 各聚会游戏（独立子目录）
│       ├── truth-or-dare/
│       ├── never-have-i-ever/
│       ├── would-you-rather/
│       ├── number-bomb/
│       └── undercover/
├── scripts/
│   └── deploy_ftp.py          # FTP 部署脚本（凭据通过环境变量传入）
├── config/
│   └── config.example.php
├── docs/
├── LICENSE
├── CONTRIBUTING.md
└── README.md
```

## 参与贡献

本项目为**公开仓库**，欢迎有想法的朋友一起参与开发。你可以：

- 提交 Issue 讨论新游戏玩法或功能建议
- 通过 Pull Request 贡献代码
- 完善文档、修复 Bug 或优化体验

详细说明请参阅 [CONTRIBUTING.md](CONTRIBUTING.md)。

如有合作想法或疑问，欢迎联系作者：**pingan@cflmy.cn**

## 本地开发

```bash
# 克隆仓库
git clone https://gitee.com/cflmy/partygame.git
cd partygame

# 复制配置文件（按需修改）
cp config/config.example.php config/config.php

# 使用 PHP 内置服务器进行本地预览（需已安装 PHP）
php -S localhost:8080 -t public
```

浏览器访问 <http://localhost:8080> 即可预览。

### 虚拟主机部署

1. 将仓库代码上传至主机
2. 将网站根目录（Document Root）设置为 `public/`
3. 复制 `config/config.example.php` 为 `config/config.php` 并填写实际配置
4. 绑定域名并确保 `public/games/*/data/rooms/` 目录可写（房间联机需要）

也可使用 FTP 脚本上传 `public/` 目录内容：

```powershell
$env:FTP_HOST='你的FTP地址'
$env:FTP_USER='你的FTP账号'
$env:FTP_PASS='你的FTP密码'
python scripts/deploy_ftp.py
```

## 开源协议

本项目采用 [MIT License](LICENSE) 开源，欢迎 Fork 与贡献。

## 仓库地址

- Gitee：<https://gitee.com/cflmy/partygame>

## 联系方式

- 邮箱：pingan@cflmy.cn
- 网站：<https://partygame.cflmy.cn>

---

欢迎 Star、Fork 与贡献，一起把聚会变得更有趣。