开发者开源2D/3D网页游戏原型框架，支持AI编码代理快速构建

用2D和3D原型化网页游戏的框架

一个用于探索游戏概念的框架。先写下你想要的东西，然后让编码agent放手把它实现出来。

我做随机的网页游戏大概有十年了。一直想把这些年积累的经验和技巧都收进一个repo里，好用尽可能省token的方式尝试大量游戏概念。现在开源出来，万一别人也觉得好玩呢！

这个框架给agent提供了拼装网页游戏所需的工具。它支持2D游戏和3D游戏，配套完整的资源生成流水线。它还包含支持持久化后端、数据库存储、多人游戏用的websocket，以及注册接入任意外部系统MCP所需的全部工具。

声明：这是一个原型框架，不是发布游戏的方式。用它快速试玩概念、玩一玩、分享给朋友。它专为本地开发设计，没有账号、没有访问控制、也没有生产环境的托管配置，示例游戏是粗糙的原型而非成品。如果某个概念可行，带上你学到的东西，去别处做真正的游戏。

写世界。我的游戏概念规格存放在ProductNow里。你也完全可以用repo里的markdown，我只是更喜欢正规的文档编辑器，尤其是在想和别人协作的时候。

把规格拉下来，然后我通过MCP把我的编码环境接上去，让它放手实现。理论上你也可以在运行时把游戏接上去，不过我还在探索这能玩出什么花样。也许做个可以轻松贡献的活传说库会挺好玩？

生成资源。Blueprint Workshop（/assets）列出了所有资源类型：战斗房间、角色立绘、敌人、精灵图集、卡牌、图标和纹理、音频、3D模型，以及整套地牢包。每种类型跑一个专用agent。agent读取传说，然后调用共享工具来画图、渲染音频或构建3D模型。应该很容易按你的需要扩展。

玩。每个游戏都会加载生成的资源。资源缺失时，它会使用内置的替代品，所以任何资源生成之前每个游戏都能玩。

生成任务跑在任务队列上，所以你可以刷新页面或取消一次运行，而不会丢失进度。你运行框架时，agent已经拿到了触发生成所需的全部指令。

前置条件 Bun Docker mkcert ngrok（可选，付费计划）：用于连接ProductNow这类外部MCP服务器，或把游戏分享给朋友。参见连接外部MCP服务器和与朋友分享游戏。

快速开始 先跑初始化设置，然后启动整套服务：

./scripts/bootstrap.sh bun run dev

./scripts/bootstrap.sh会安装依赖、构建本地CLI、用本地默认值初始化.env、配置本地HTTPS证书，并构建monorepo的各包。

bun run dev会在Docker里启动Postgres、Redis和可观测性工具，应用数据库迁移，并在https://localhost:3000提供前端、在https://localhost:8080提供后端API。

API Key与配置 仅仅探索或玩这些游戏，你不需要任何真实的API Key。所有游戏都包含内置的备用资源和程序化逻辑，而且./scripts/bootstrap.sh会用占位凭据填充.env，让后端开箱即能干净启动。

不过，一旦你想生成新资源（在/assets的Blueprint Workshop里或通过CLI脚本），就需要在.env文件里填上有效的API Key。

变量 是否必需？ 提供方/服务 作用 ANTHROPIC_API_KEY 必需（用于资源生成） Anthropic Claude 驱动Mastra agent的推理、规划和多步流水线编排。 OPENAI_API_KEY 必需（用于资源生成） OpenAI 用于文本任务和图像生成（角色立绘、房间、精灵图集、敌人和图标）。 GEMINI_CREDENTIALS 必需（用于资源生成） Google Cloud Vertex AI 服务账号JSON字符串或凭据文件路径；驱动Gemini agent和Vertex AI图像绘制。 ELEVENLABS_API_KEY 可选 ElevenLabs AI生成音效、环境房间循环音和器乐背景音乐。若不填，则跳过音频生成，游戏使用内置的合成音效提示。 MESHY_API_KEY 可选 Meshy 高细节带纹理的3D模型以及角色绑定/动画。若不填，3D生成会使用内置的零额度程序化低多边形编译器。 其他配置项 MCP_OAUTH_ENCRYPTION_KEY：一个32字节base64编码的密钥，用于在Postgres中静态加密ProductNow OAuth token。./scripts/bootstrap.sh会自动提供本地开发默认值；生产部署应设置一个独一无二的密钥。 ProductNow连接（可选）：通过Blueprint Workshop里的Connect ProductNow按钮连接你的传说文档。这需要ngrok（参见连接外部MCP服务器）。 PRODUCTNOW_GAMES_FOLDER_ID：存放游戏传说的ProductNow文件夹。每个游戏在其中建一个子文件夹存放自己的传说，首次使用时创建；Towers of Coreborn直接使用这个文件夹。未设置前传说存储不可用。 PRODUCTNOW_LORE_DOCUMENT_ID（可选）：Towers of Coreborn视为正典的那份文档。不设置的话，agent会去找名为“Lore”的文档。 ------------------------ 面向AGENT的README ------------------------ 你需要ngrok才能把框架连接到任何外部MCP服务器，比如用来存传说的 ProductNow。没有它，其余一切照常本地运行。 原因：外部MCP服务器通过OAuth让后端登录。在这个流程中， 服务器会获取后端的OAuth客户端文档并重定向回去，所以后端必须能通过 一个公网HTTPS URL访问，且该URL的证书要被服务器信任。mkcert生成的 本地https://localhost证书只被你自己的机器信任。ngrok为前端和后端 提供带有效证书的公网HTTPS URL，这正是OAuth流程所需要的。

（原文较长，此处译出前 6000 字，完整内容请点「打开原文」。）