内容
<div align="center">
<img src="https://cdn.simpleicons.org/unrealengine/8A63D2" height="56" alt="虚幻引擎" />
<img src="https://cdn.simpleicons.org/unity/8A63D2" height="56" alt="Unity" />
<img src="https://cdn.simpleicons.org/godotengine/8A63D2" height="56" alt="Godot" />
# 游戏开发插件
### 在虚幻引擎、Unity和Godot中构建游戏 — 使用人工智能，自动完成。
一个用于人工智能编码代理的插件市场 — **[Claude Code](https://docs.anthropic.com/en/docs/claude-code)**
和 **[OpenAI Codex CLI](https://developers.openai.com/codex/)** — 教会代理启动
一个真正的游戏项目，安装引擎插件，登录并打开连接到云端的编辑器 — 这样您只需通过询问即可构建游戏。
[](./LICENSE)
[](https://docs.anthropic.com/en/docs/claude-code)
[](https://developers.openai.com/codex/)
[](https://ai-game.dev)
[](https://ai-game.dev)
[](https://ai-game.dev)
[](https://ai-game.dev)
<img src="./assets/banner.png" alt="使用 AI 构建游戏 — 创建项目，安装插件，登录并打开 Unreal、Unity 和 Godot 编辑器，全部自动完成" width="100%" />
</div>
---
## 这是什么？
**ai-game-dev-plugin** 是一个包含三个游戏引擎插件的市场 — 每个引擎一个插件 — 用于人工智能编码代理。每个插件都教会代理驱动该引擎的官方 npm CLI，因此它可以从**零**开始到一个正在运行的编辑器 **连接到 [ai-game.dev](https://ai-game.dev)** — 创建
项目，安装引擎插件，登录并打开编辑器 **为您自动完成**。
它与 **Claude Code 和 OpenAI Codex CLI** 配合使用，从一个源代码树：每个引擎的单一共享技能，加上每个代理的插件清单。
连接后，AI 可以在您真正的编辑器中构建游戏：创建项目结构，生成对象，编辑场景，编写逻辑并迭代 — 所有操作都通过您的编码代理完成。
| 引擎 | 包装 CLI | 它教会代理... |
| ------ | ------------- | ------------------------ |
| **虚幻引擎** | [`unreal-mcp-cli`](https://www.npmjs.com/package/unreal-mcp-cli) | 创建 UE 项目，安装 Unreal-MCP，登录，打开云模式 |
| **Unity** | [`unity-mcp-cli`](https://www.npmjs.com/package/unity-mcp-cli) | 通过 Hub 创建 Unity 项目，安装 Unity-MCP，登录，打开 |
| **Godot** | [`godot-cli`](https://www.npmjs.com/package/godot-cli) | 创建 C# Godot 项目，安装 Godot-MCP，登录，打开云模式 |
## 🚀 快速开始
添加市场，然后安装您使用的引擎插件。
### Claude Code
```text
/plugin marketplace add IvanMurzak/ai-game-dev-plugin
```
```text
/plugin install unreal@ai-game-dev-plugin
/plugin install unity@ai-game-dev-plugin
/plugin install godot@ai-game-dev-plugin
```
### OpenAI Codex CLI
在 shell 中注册市场，然后在 Codex 会话中安装：
```bash
codex plugin marketplace add IvanMurzak/ai-game-dev-plugin
```
```text
/plugin install unreal@ai-game-dev-plugin
/plugin install unity@ai-game-dev-plugin
/plugin install godot@ai-game-dev-plugin
```
> **仅限技能替代方案（Codex）：** 运行手册也作为存储库原生技能发布在
> [`.agents/skills/`](./.agents/skills) 下。Codex 通过扫描 `.agents/skills` 目录从工作目录到存储库根目录来发现技能，因此您可以将 `<engine>-game-dev` 文件夹放入项目的 `.agents/skills/`（或 `~/.agents/skills/`）中，而不是安装插件。
然后只需询问：
> _"使用 AI 建立一个新的虚幻引擎游戏并连接到 ai-game.dev。"_
## 三个插件
| 引擎 | Claude Code | Codex CLI |
| ------ | ----------- | --------- |
| 虚幻引擎 | `/plugin install unreal@ai-game-dev-plugin` | `/plugin install unreal@ai-game-dev-plugin` |
| Unity | `/plugin install unity@ai-game-dev-plugin` | `/plugin install unity@ai-game-dev-plugin` |
| Godot | `/plugin install godot@ai-game-dev-plugin` | `/plugin install godot@ai-game-dev-plugin` |
每个插件都是一个单一的、专注的 **技能**，在您要求代理为该引擎创建、设置或打开项目时自动激活。
## 🤖 AI 自动执行的操作
当您要求代理设置游戏时，技能通过 `npx -y <engine-cli>@latest` 运行完整的端到端流程：
1. **创建** — 搭建一个全新的引擎项目（如果您已经有一个，则跳过）。
2. **安装** — 将引擎的 MCP 插件/插件添加到项目中。
3. **关闭** — 确保编辑器未运行，以便在下次启动时加载新的令牌。
4. **登录** — 与 [ai-game.dev](https://ai-game.dev) 进行交互式设备代码登录；代理
为您中继验证 URL + 代码，以便在浏览器中打开。
5. **打开** — 在 **云** 模式下启动编辑器。
6. **连接** — 等待编辑器实际连接到云（代理在通过之前不会声称成功）。
7. **连接 MCP** — 将项目的工具与您的代理注册（`setup-mcp claude-code` 用于 Claude Code，`setup-mcp codex` 用于 Codex），以便 AI 可以构建游戏。
> **重要的顺序：** 编辑器始终在 **登录前关闭**，并且 **仅在登录成功后打开**，因此在启动时加载新的身份验证令牌。代理为您强制执行此操作。
## ✅ 先决条件
- **Node.js 18+** （CLI 通过 `npx` 运行）。
- **已安装引擎** — 虚幻引擎，Unity（通过 Unity Hub），或 Godot 4.x **.NET/Mono**
（Godot C# 项目还需要 **.NET SDK**）。
- 一个免费的 [ai-game.dev](https://ai-game.dev) 帐户用于登录步骤。
- 一个桌面会话 — 编辑器打开一个真正的窗口。
## 🌐 由 ai-game.dev 提供支持
这些插件是通往 **[ai-game.dev](https://ai-game.dev)** 的入口 — 云让 AI
在您真正的引擎中构建游戏。登录步骤授权您的项目访问云端，编辑器连接到它，以便 AI 可以创建和迭代您的游戏。您可以自带免费帐户；
插件连接其他所有内容。
## 🧩 它如何组合在一起（适用于贡献者）
一个源代码树为两个代理服务：
- **规范技能** — `plugins/<engine>/skills/<engine>-game-dev/SKILL.md`。两个插件清单
都引用插件自己的 `./skills/` 目录，因此 Claude Code 和 Codex 包共享此
个文件。
- Claude Code 清单：`plugins/<engine>/.claude-plugin/plugin.json`
- Codex 清单：`plugins/<engine>/.codex-plugin/plugin.json`
- **市场目录** — `.claude-plugin/marketplace.json`（Claude Code）和
`.agents/plugins/marketplace.json`（Codex）。
- **存储库原生 Codex 技能** — `.agents/skills/<engine>-game-dev/SKILL.md` 由
规范技能通过 [`scripts/sync-skills.mjs`](./scripts) **生成**。编辑规范 `SKILL.md` 后，
运行 `node scripts/sync-skills.mjs` 以重新生成它们，并运行 `node scripts/sync-skills.mjs --check`
以防止漂移。
- **代理说明** — [`AGENTS.md`](./AGENTS.md)（Codex）镜像布局和黄金规则。
有关完整情况，请参阅 [`scripts/README.md`](./scripts/README.md) 和 [`AGENTS.md`](./AGENTS.md)。
## 🤝 贡献
欢迎在
**[github.com/IvanMurzak/ai-game-dev-plugin](https://github.com/IvanMurzak/ai-game-dev-plugin)**
上提交问题和拉取请求。
保持更改专注于创建 → 安装 → 登录 → 打开 → 连接故事，保持所有 JSON 有效，
在提交前运行 `node scripts/sync-skills.mjs --check`，并匹配现有的技能结构。
## 📄 许可证
[Apache-2.0](./LICENSE) © 2026 Ivan Murzak.
<div align="center">
<sub>为游戏开发者而打造，不再是样板文件。 · <a href="https://ai-game.dev">ai-game.dev</a></sub>
</div>
