SuperAPI AI 工具集

add-multiplayer

编程与开发

查看项目

更新于 10-16 03:42

技能介绍

用途:为已有的 Phaser 3 或 Three.js 单机浏览器游戏加入实时或回合制多人对战,服务器采用 PartyKit(底层为 Cloudflare Durable Objects,每个房间一个对象)。

主要能力:脚手架生成 multiplayer-server/(含 partykit.json、package.json、tsconfig.json、src/server.ts、.gitignore),提供 realtime 与 turn-based 两套服务器模板;生成客户端文件 src/multiplayer/MultiplayerClient.js、RemotePlayerRegistry.js 和 src/systems/NetworkManager.js;对 EventBus.js、GameState.js、Constants.js、main.js 与 render_game_to_text() 做纯追加式修改。默认房间为 'lobby',暂未提供匹配 UI。

使用方式:以 /add-multiplayer [路径] [--mode=realtime|turn-based] 调用;未指定模式时按现有事件推断。安装依赖后本地用 npx partykit dev 调试,部署需先执行 npx partykit login --provider github,再 npx partykit deploy,并把部署 URL 写入 Constants.SERVER_URL 与 .env 的 VITE_MULTIPLAYER_SERVER_URL。客户端安装命令为 npm install partysocket。

适用场景:实时模式适合动作、跑酷、平台类连续位移游戏;回合制模式适合卡牌、棋类、解谜等离散操作游戏。

限制与原则:单人模式必须离线可用,连接失败时 NetworkManager 捕获错误并发出 network:disconnected;仅允许追加编辑,不得重命名或删除现有字段;EventBus 是唯一通信接缝。已知 v1 限制:无匹配 UI、无观战、无持久账号、仅有服务端限流。云成本方面,Cloudflare Workers 免费额度为每天 10 万请求和 1GB Durable Object 存储,项目部署在用户自己的 Cloudflare 账号下。其余价格与扩展细节暂未提供。