gomaaz/gameparty

🎮 Gameparty

免责声明： 本项目100%为兴趣开发。它是为了好玩，在局域网派对上为朋友构建的——并非用于生产环境。不提供任何形式的保证。作者对使用本软件可能导致的任何损坏、数据丢失、错误或混乱不承担责任。使用风险自负。玩得开心。🤙

---

因为告诉你的朋友"我们玩点什么吧"永远不够具体。

我们都知道这种情况：你和一群朋友在局域网派对上，每个人都想一起玩得开心——但一半的人沉迷于自己的游戏，让所有人真正一起玩就像赶猫一样困难。总有人有理由不加入："再玩一局就好"、"我不太懂那个游戏"、"也许 later"。

Gameparty就是为解决这个问题而构建的。

理念很简单：通过一点友好的竞争，将你的局域网派对变成共享体验。玩家通过一起游戏赚取硬币，在商店中花费硬币购买有趣的动作，互相挑战决斗和团队决斗，并争夺排行榜的榜首位置。突然之间，加入小组游戏不再是你"不得不"做的事——而是你"想要"做的事，因为有了赌注，而且所有人都参与其中。

这不是为了赢。而是为了让每个人离开沙发的角落，进入同一个游戏——一起欢笑、竞争，真正共度时光。这才是重点。

---

截图

https://github.com/user-attachments/assets/e1011f7c-da92-4c15-b212-3e57380ce859 https://github.com/user-attachments/assets/21da1e5e-3cf4-478f-a7d0-64d7b62f4425 https://github.com/user-attachments/assets/babb70d6-594a-4312-bdd6-7d337b9d1d0c https://github.com/user-attachments/assets/fc240af9-1da5-4fd7-ad81-5ca2f01ec054 https://github.com/user-attachments/assets/678fa0c1-186a-4a91-b575-e434484f6b4c https://github.com/user-attachments/assets/7353fcb1-284b-4839-9124-e13f4c50d3cb https://github.com/user-attachments/assets/a895de44-d354-4a5f-9718-a23702bc5879 https://github.com/user-attachments/assets/869172fc-7af2-406f-9877-5e686175d54c https://github.com/user-attachments/assets/1d25f2ca-ef0e-4440-b462-f030381bb40d https://github.com/user-attachments/assets/27629f6c-897d-4893-b97b-024b87d1f2f8

---

功能特性

硬币系统

玩家在小组游戏中每分钟都能赚取硬币。硬币获取速率随参与人数增减，且可由管理员完全配置。等待时，会话卡片显示预期速率；会话开始后，实时计数器实时更新。

商店

花费硬币购买能改变游戏进程的动作：

针对性动作（强制参与、饮品指令、扒窃）会向接收者触发实时通知，包括确认流程。

决斗、团队决斗与自由对战

1v1决斗： 挑战另一名玩家进行一对一较量——决斗被接受的瞬间，双方都将扣除赌注。无法反悔。

团队决斗： 从在场所有人中组建两支队伍，设置每人的赌注，所有参与者必须单独接受后决斗才会开始。由小组 leader 决定获胜方；管理员支付奖金池。

自由对战（FFA）： 第三种挑战类型——所有人对抗所有人。任意数量的玩家（至少3人）以相同赌注参与，奖金根据最终排名分配。可精确配置每个名次的收益比例（例如：第1名：50%，第2名：30%，第3名：20%）或使用预设比例。包含快速选择：50/30/20、60/40、70/20/10和赢家通吃。所有参与者必须单独接受后赌注才会锁定。会话结束后，创建者分配最终排名；管理员审核并触发奖金发放。

奖金分配模式（适用于所有三种挑战类型）：

• 赢家通吃 — 默认模式。全部奖金归赢家（或获胜团队）。
• 按比例分配 — 配置自定义的赢家/输家百分比分配。输家获得部分退款；赢家获得剩余部分。赢家必须至少获得50%。

游戏库

游戏列表是Gameparty的核心——所有已批准的游戏集中展示，每张卡片上都以褪色背景显示游戏封面图。

• 游戏详情模态框 — 点击任何游戏标题打开完整视图，包含截图滑块（封面图+最多6张游戏内截图）、发行日期、类型、支持平台、Metacritic评分、商店链接、描述和PC系统要求
• 商店链接 — 游戏标题下方的可点击徽章（Steam、GOG、Epic等） -.** 徽章— 快速链接到该游戏的搜索结果 - 游戏匹配器 **— 显示当前最受玩家感兴趣的游戏
• 玩家可标记对游戏的兴趣；管理员可添加、编辑、批准和删除游戏

会话

两种类型，统一界面：

-** 即时会话 — 立即开始，玩家加入大厅 - 计划会话 **— 安排在特定日期/时间，提前对所有人可见

• 会话卡片显示游戏封面图以便快速识别
• 可选玩家槽位 — 编号座位，优先填充最低空闲槽位
• 会话结束并发放硬币后，每个参与者都会收到包含游戏、时长、玩家数量和硬币收益的收据模态框

通知

标题栏中的实时面板收集所有待处理动作——决斗挑战、团队决斗邀请、商店任务（强制参与、饮品指令）和管理员奖金发放提醒。徽章计数实时更新，对所有玩家可见。

RAWG集成（可选）

连接RAWG.io可自动丰富游戏库的元数据。在rawg.io/apidocs获取免费API密钥，并在docker-compose.yml中设置。

获取并本地存储的内容：

• 封面图 → gamefiles/covers/
• 最多6张游戏内截图 → gamefiles/screenshots/
• 描述、Metacritic评分、类型、发行日期、平台、PC系统要求
• 商店链接（Steam、GOG、Epic、Xbox、PlayStation Store、官方网站）

使用方法：

• 在管理员面板的"游戏数据"下切换RAWG开关
• 点击"从RAWG加载游戏数据"一次丰富所有已批准游戏——已完成的条目会被跳过以节省API调用
• 建议新游戏时，会出现RAWG结果的自动完成下拉菜单——选择后立即预填所有元数据并下载图片
• 管理员面板显示已进行的API请求总数和已丰富的游戏数量

游戏导入与导出

所有导入在提交前显示预览模态框。CSV格式：

name,genre,maxPlayers,shoplink_label_1,shoplink_url_1,shoplink_label_2,shoplink_url_2
"Mario Kart 8","Racing",4,"Steam","https://store.steampowered.com/app/...","",""

** 提示（Excel）：**保存为"CSV UTF-8（逗号分隔）"——不要使用某些地区默认的分号分隔格式。

服务器日志

管理员面板中的实时日志查看器，带级别筛选（ALL / INFO / ERROR / DEBUG）。RAWG API调用在DEBUG级别详细记录。在docker-compose.yml中设置日志级别：

yaml
LOG_LEVEL=INFO   # OFF | INFO | DEBUG

---

快速开始

选项A — Docker Hub（推荐）

无需git clone，无需构建。只需两条命令：

bash
curl -O https://raw.githubusercontent.com/gomaaz/Gameparty/main/docker-compose.yml
docker compose up -d

在浏览器中打开http://localhost:3000**。 网络中的所有人可通过http://<主机IP>:3000**加入。

默认登录（仅首次启动）：

首次启动前可通过编辑docker-compose.yml中的SEED_ADMIN_NAME / SEED_ADMIN_PIN更改默认凭据。

更新到最新版本：

bash
docker compose pull && docker compose up -d

持久化数据：

• SQLite数据库位于命名Docker卷中（gameparty-data）——重启和更新后保留
• 通过RAWG下载的封面图和截图存储在./gamefiles/（从主机绑定挂载）

自定义端口（如8080）： 将docker-compose.yml中的"3000:3000"改为"8080:3000"。

RAWG API密钥： 在docker-compose.yml中设置RAWG_API_KEY=your_key_here。免费密钥可在rawg.io/apidocs获取。

---

选项B — 反向代理（Nginx Proxy Manager）

如果通过反向代理暴露Gameparty，SSE（实时更新）需要特定配置。将以下内容添加到代理主机的"高级"选项卡：

nginx
proxy_buffering off;
proxy_cache off;
proxy_read_timeout 86400s;
proxy_send_timeout 86400s;
proxy_http_version 1.1;
proxy_set_header Connection '';

若没有proxy_buffering off，实时更新会被静默拦截，客户端只能退回到轮询模式。

---

选项C — 手动（Node.js）

bash
npm install
npm start

需要Node.js 18+。服务器运行在http://localhost:3000。

---

配置

所有配置位于docker-compose.yml：

---

角色

---

技术栈

-** 后端 ：Node.js、Express、better-sqlite3（SQLite） - 前端 ：原生JS、HTML5、CSS3——无框架 - 实时通信 ：服务器发送事件（SSE） - 外部API ：RAWG.io（可选） - 部署 **：Docker / Docker Compose

国际化

UI支持英语（默认）和德语。通过标题栏中的旗帜按钮切换——存储在localStorage中。

---

版本控制

每次更改都使用版本标签（v2.3.x）提交。 所有版本可在https://github.com/gomaaz/Gameparty/releases%E6%9F%A5%E7%9C%8B%E3%80%82