gamedev.pl

gamedev.pl

描述一款游戏。由 AI Agent 构建。所有人都能在浏览器中游玩。

立即游玩 → www.gamedev.pl · 封闭测试版

关注动态：YouTube · X

写下几句话，描述你想要的游戏。应用会询问所需信息，然后你可以把简报交给平台构建器，或通过 MCP 连接自己的编码 Agent。Agent 会构建真正的代码，而不是只改动数字的模板。审核通过后，游戏便会出现在目录中，并在浏览器里运行。邀请朋友一起玩——有些游戏能把手机变成控制器，共用一个屏幕进行游戏。

上面的每款游戏都是这样构建的。

这个仓库就是实现上述功能的平台，而且它是开源的。

观看 AI 开发团队公开交付游戏

这套代码库的大部分由编码 Agent 编写，构建游戏的流水线本身也由 Agent 运行。这种方式足够特别，值得观看，而不只是阅读相关介绍：

• 创作者的描述会转化为规格说明，QA 门槛会在编写任何代码之前提出实际的澄清问题。
• 创作者可以选择托管的平台构建器，也可以连接自己的 Cursor、VS Code、Claude Code、Codex 或其他支持 MCP 的 Agent。
• Agent 会在工作时向 Creator Studio 汇报进度、发送截图和可玩的草稿；创作者的备注也会通过同一实时通道返回。
• 修改会基于创作者实际玩过的准确存储版本启动新任务，而不是依赖过期分支或拉取请求。
• 每款游戏都必须通过验证门槛和人工审核，才能发布到独立的、由 Agent 维护的游戏仓库。

**CI 强制执行的一项保证：**目录中的每款游戏都能用一根拇指游玩。触控支持是_根据每款游戏的源代码推导得出的_，而非在规格说明中声明，因此游戏无法虚报自身并不具备的可玩性。

有趣的工程细节都记录在 docs/ 中——建议从 docs/README.md 开始阅读。

连接你的 Agent（MCP 或 gamedevpl CLI）

两种方式，同样的游戏。站内页面是 https://www.gamedev.pl/connect（也可访问 /mcp）。它位于页眉菜单中，不在 /create 或公开游戏页面上。

MCP。 该服务是远程的，无需安装：让支持 MCP 的客户端连接到 https://www.gamedev.pl/api/mcp，然后通过 OAuth 登录。Claude 用户也可以将其作为插件安装——listings/mcp/claude-plugin/README.md 列出了准确步骤，其中包括安装操作本身不会完成的连接器审批。官方注册表条目为 pl.gamedev/creator。

这些工具涵盖一个构建轮次：开启或重新加入轮次、阅读需求说明和引擎套件、向套件和文档提问、暂存并交付源文件、检查质量门禁，以及与创作者交换进度、截图和消息。还有其他工具，但它们被有意隐藏，绝不会公开宣传，因此 Agent 无法发现它们。 listings/mcp/README.md 列出了每个工具及其注释、每个具有破坏性的工具实际会消耗什么，以及其余工具为何隐藏。

CLI。 apps/cli 是 gamedevpl 终端客户端（不含本地模型）。不带动词时，它会打开 REPL：先交谈；当你提出要求时，才会开始游戏。gamedevpl checkout <slug> 是使用自有编辑器的方式。当 CLI_SURFACE 关闭时，安装程序（/install.sh）会返回 404。开启该标志后，即使还没有 cli-v* GitHub 发布版本，路由也会提供脚本——此时失败的是下载。在发布版本推出前，请运行 npm install，然后运行 npm run bundle -w @gamedevpl/cli。详情： apps/cli/README.md。

创建游戏目前处于封闭 Beta 阶段。 任何人都可以加载这些工具；但调用需要经过审批的创作者账号。这是访问门槛，并非服务中断—— 加入候补名单。

五分钟内在本地试用

npm install
npm run dev

此项目要求 Node.js 20.19 或更高版本。打开 **http://localhost:5173**（不要使用 127.0.0.1）。你将看到一个可浏览的街机、可玩的游戏、开发用登录入口，以及内存中的提交流程——不需要 API 密钥、GitHub 令牌或云项目。游戏内容来自同级目录中的游戏仓库，或可用时来自 GAMES_LOCAL_DIR；否则使用打包的示例游戏。由于没有编码 Agent 监视内存存储，本地提交会一直排队。

完整说明（包括本地环境中哪些内容是有意模拟的，以及可能让你意外的地方）请参阅 docs/local-development.md。

注意： 在本地运行此项目是为了开发平台，而非重现托管版构建器。编排代码位于此处，但实时编码 Agent 运行时是外部托管服务。你仍可使用自己的 Agent 和线上站点的 MCP 连接来体验创作者交接流程。

安全模型

游戏是真实代码，因此无法像结构化数据那样进行安全检查。安全性来自执行隔离，而非代码检查：每个游戏都会被组装成一份独立文档，并在 <iframe sandbox="allow-scripts allow-pointer-lock"> 中渲染，且没有 allow-same-origin。 它无法访问父页面、Cookie、存储或任何经过身份验证的端点。

这是项目中最重要的一条不变量。如果你发现了绕过它的方法，请私下报告——参见 SECURITY.md。

仓库布局

apps/
  web/               Vite + React + TypeScript — arcade, player, Creator Studio
  cli/               `gamedevpl` terminal client (see Connect your agent above)
  api/               Fastify + TypeScript — catalog, jobs, auth, agent channel, multiplayer
  api/fixtures/      Games-repo-shaped content so the app runs with no credentials
  e2e/               Playwright checks for critical browser and production flows
  world/             Persistent-world service, deployed separately from the main API
packages/
  contract/          Types, constants and route tables shared across workspaces
  zone-core/         Shared protocol and simulation primitives for persistent worlds
infra/               Cloud Run deployment and read-only production-inspection scripts
docs/                The plan of record — read this before making assumptions

游戏本身位于一个由编码 Agent 维护的独立仓库中；此应用是目录、播放器和提交入口。参见 docs/games-repo.md。

贡献

欢迎贡献，上面的本地设置旨在让你几分钟内就能运行首次更改。

• 发现了 Bug？ 提交问题。 网站页脚有一个“报告 Bug”链接，会自动为你预填信息。
• 有想法？ 提交功能请求， 或发起一场讨论。
• 发现了安全问题？ 请勿提交问题 — 请参阅 SECURITY.md。
• 正在编写代码？ 完成前请运行 npm install，然后运行 npm run type-check && npm run lint && npm run test && npm run build。 编码 Agent 应阅读 docs/contributing-for-agents.md。

翻译是不错的首次贡献机会：界面位于 apps/web/src/i18n/locales/，目前提供英语和波兰语版本。

历史

gamedev.pl 是波兰游戏开发领域的一个老牌名称 — 多年来，这个域名一直是一个社区网站，一代人曾在这里学习制作游戏，而本仓库保存着它的源代码。这个社区网站仍留存在本仓库早期的历史中。

如今，这个域名以不同的方式延续着同一初衷：过去它教人们如何制作游戏，现在它让任何人都能制作游戏。这种延续是刻意为之。

许可证

GPL-3.0。使用 Genaicode 开发。