# ohmygame
**Repository Path**: mr_sunke_admin/ohmygame
## Basic Information
- **Project Name**: ohmygame
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No
## Statistics
- **Stars**: 1
- **Forks**: 0
- **Created**: 2026-10-15
- **Last Updated**: 2026-10-31
## Categories & Tags
**Categories**: Uncategorized
**Tags**: None
## README
> [!NOTE]
> 🚧 OhMyGame 目前处于 Beta 阶段,难免还有粗糙的地方。欢迎加入我们,一起把它做好!
## 新动态
- **2026-10 · beta 5**
([更新说明](https://github.com/WhiteTowerAI/ohmygame/releases/tag/v0.0.0-beta.5.0))
- **现已支持互动故事:** 适合做视觉小说、互动电影和剧情游戏。每个画面都是一个自由的网页,
可以放视频、写对白、给选择,甚至装下一个小游戏;描述你想要的,Agent 就帮你做好,
不受固定节点类型的限制。
- **带上你自己的 Agent:** 用 Claude Code、Codex 或 OpenCode 来运行对话,
也可以把 OhMyGame 接进它们。
- **插件:** 在 Godot、Unity、Unreal Engine 或 Cocos Creator 里开发;用 Blender、
Aseprite 或 Tiled 做素材;上架微信小游戏、抖音小游戏或 TapTap,
[让游戏帮你赚钱](#-发布和变现一个链接或者玩家付费的平台)。
## 这是什么
做一款游戏,需要设计文档、2D 美术、3D 模型、视频、代码,做完还要有地方发布。
现在这些工作分散在五六个不同的工具里。OhMyGame 把它们放进了一个应用:描述你想做的游戏,
Agent 会设计它、制作素材、搭建游戏、亲自试玩确认能正常运行,再发布成一个可以分享的链接。
它围绕两个核心设计理念:
1. **一切都在画布上。** 设计文档、概念图、3D 模型和视频并排放在同一块画板上。
一张角色草图可以延伸出更多美术图、一段视频,或者一个绑好骨骼的 3D 模型,
而且全部可以直接用在你的游戏里。
2. **活由 Agent 来干。** 它像你一样操作画布:起草设计文档,把角色草图变成绑好骨骼的
3D 模型,编写代码,再试玩检验结果。
OhMyGame 是开源的,通过 Pi 支持 40 多家模型服务商,从 Anthropic、OpenAI 到 DeepSeek、
通义千问。密钥留在你自己的电脑上,没有按次计费的点数,做出来的东西归你所有。
## 功能
### 🤖 Agent:操作画布,搭建并试玩游戏
Agent 像你一样使用画布:起草设计文档,排布画板,并在上面生成素材。它阅读设计文档、
编写代码,在实时预览中运行游戏。然后它会在一个你可以旁观的窗口里打开游戏并亲自试玩,
包括实时渲染的 Canvas 和 WebGL 游戏。发现问题时,它会尝试修复,然后再玩一遍。
在这个过程中,它还可以生成图片、视频、3D 模型和音频,搜索网络,并使用 MCP 服务器和插件。
**▶ Agent 在桌面端和移动端试玩一个新道具功能,然后汇报发现的问题(4 倍速)。**
https://github.com/user-attachments/assets/3cb982e8-a4a8-4715-bf3c-df4e41e7855b
### 🎨 画布:设计文档、美术、视频、3D 和音频同在一块画板
每个游戏项目都有一个设计空间:一份主设计文档,加上若干画板,文档、图片、视频、3D 模型和音频
在画板上并排摆放。节点之间可以互相引用,所以一个角色设计可以衍生出更多图片、一段视频、
一句配音,或者一个绑好骨骼、带动画的 3D 模型。生成结果会进入共享的素材库(Asset Library),
供你的游戏使用。
https://github.com/user-attachments/assets/5a35964d-87b3-4153-8b1b-fc6deced5bb3
### 🔗 发布和变现:一个链接,或者玩家付费的平台
登录后即可发布:OhMyGame 会构建你的游戏,并生成一个任何人都能在浏览器里打开就玩的链接。
重新发布会更新同一个链接。发布的游戏会出现在应用内的社区(Community)里,
你可以在那里玩到别人做的游戏,按最新、最多浏览或最多点赞排序,查看创作者主页,
给喜欢的游戏点赞。
一人工作室,就该能养活自己。除了社区,插件还能把你的游戏送上玩家愿意付费的平台。
一个人做微信、抖音小游戏,靠广告和内购就能变现。
| 上架到 | 怎么赚钱 | 怎么做 |
| -------------------------- | ------------------ | ------------------------------------------------- |
| 微信小游戏、抖音小游戏 | 广告、内购 | [平台插件](#-插件连接更多游戏开发工具) |
| TapTap | 下载、内购 | TapTap Maker 插件 |
| Steam 等商店 | 买断 | 通过 Godot 或 Unity 插件导出 |
| itch.io、Poki、CrazyGames | 付费下载、广告分成 | 直接上传网页游戏的构建产物 |
**游戏是你的,收入也是你的。** OhMyGame 不从你的游戏收入里抽成。
### 🧑💻 带上你自己的 Agent
已经在用 Claude Code、Codex 或 OpenCode?在模型选择器里选中它,它就会用自己的登录来运行对话,
并且能用上整个工作室:画布、媒体生成、试玩、插件和撤销,对话记录保留在 OhMyGame 里。
详见[编程智能体](docs/coding-agents.md)。
### 🔌 在 Claude Code、Codex 等 Agent 中使用 OhMyGame
已经在用别的编程 Agent?打开 **设置 → MCP 服务 → 允许其他 Agent 使用 OhMyGame**,
一键连接 Claude Code 或 Codex。它们会获得 OhMyGame 的媒体生成(使用你配置的服务商)、
画布和试玩能力,以及一个讲解工作流程的 Skill。DeepSeek Harness 和其他 MCP 客户端可以添加
那里显示的 `ohmygame-studio` 命令。详见 [External agents](docs/external-agents.md)。
### 🧩 插件:连接更多游戏开发工具
插件让 Agent 在你熟悉的引擎和工具里干活:
- **引擎:** Godot、Unity、Unreal Engine 和 Cocos Creator。
- **平台:** TapTap Maker、微信小游戏和抖音小游戏。
- **素材:** Blender、Aseprite 和 Tiled。
在 **插件** 页中启用,或者用插件构建器做你自己的插件。引擎插件使用各引擎自己的编辑器和工具,
请先安装好它们。详见 [Plugins](docs/plugins.md)。
## 你可以做什么
我们团队用 OhMyGame 做的三款游戏:
### 🎮 网页游戏
**最推荐的起点。** 运行在浏览器里的 2D 和 3D 游戏,使用 Three.js、React Three Fiber 或 Phaser 构建。
Agent 会走完一整套网页游戏流程:设计文档、关键画面 mockup、正式美术、可玩的核心循环,
以及在实时预览中试玩。做出来的游戏适配任意窗口尺寸,支持触屏,并能发布成一个可以分享的链接。
项目本身就是一个普通的 Web 项目,可以用任何编辑器打开。
### 🎬 互动故事
互动电影、视觉小说和剧情游戏。每个画面都是一个自由的网页,拥有自己的图片、视频和代码:
主菜单、案件档案、一段对话、一个谜题。你在图上把它们连起来,运行时负责状态、存档、音乐和跳转。
故事作为独立的网页运行,运行时也是项目的一部分,所以 Agent 可以改动它运行方式的任何地方。
架构和创作模型见 [Playable Nodes](docs/playable-nodes/README.md)。
### 🎲 General Game:任意引擎与技术栈
**General Game** 不预设引擎和技术栈。你可以从一个想法开始,导入用任何引擎做的项目,
或者为游戏制作工具和内容。Game Studio 插件负责在不同引擎之间协调设计、正式美术、开发实现和验证,
[引擎插件](#-插件连接更多游戏开发工具)则让它在你所用的引擎里工作。做 Godot 游戏,
可以从侧栏新建一个 **Godot** 项目。
如果产出的是网页,预览、试玩和发布都和网页游戏一样可用;原生游戏使用各自引擎的工具。
详见 [General Game 说明](docs/runtime.md#agent-game-use)。**想做浏览器游戏?请选 Web Game**,
它专门为浏览器调优过。
## 实现原理
把这一切串起来的思路是:一个 Agent 驱动工作室的每个部分。
**1 · 带图形界面的完整 Pi Agent。** OhMyGame 运行的是
[Pi](https://www.npmjs.com/package/@earendil-works/pi-coding-agent),带有完整的工具集和持久化会话,
界面专为查看结果而设计,而不是让你读 diff。关掉应用再回来,项目、对话和上下文都还在。
你负责描述、审阅和把控方向;随时可以手动编辑,但那不是主要的用法。
**2 · 每个工作区都是文件。** 网页游戏就是一个普通的 Web 项目。设计文档是 Markdown,
画板和素材画布(Asset Canvas)共用同一套 JSON 节点模型。互动故事是存在磁盘上的节点图。
每种工作区都附带 `AGENTS.md` 和 JSON Schema,所以 Agent 编辑它们的方式和编辑代码一样,
可视化编辑器读写的也是同一批文件。
**3 · 游戏操作就是工具调用。** 试玩游戏(`game_use`)、生成媒体、检查故事节点,
都是普通的 Pi 工具,和它的编程工具放在一起。所以 Agent 能把它们串起来:
在一次对话里起草设计、制作美术、编写代码,再试玩结果。
## 任意模型,自带密钥
OhMyGame 不会把你绑定在某一个模型上,也不按次收费。
- **40 多家服务商的编程模型**,通过 Pi 接入,包括 Anthropic、OpenAI、Google、DeepSeek、
通义千问(Qwen)、Kimi、智谱 GLM、MiniMax、xAI、Mistral、Groq、OpenRouter、
Amazon Bedrock 和 Vercel AI Gateway。
- **直接登录你已有的订阅**,例如 ChatGPT Plus/Pro 或 GitHub Copilot,也可以粘贴 API 密钥。
- **你已经在用的编程智能体**:Claude Code、Codex 和 OpenCode 使用各自的登录来运行对话,
对话记录、撤销、画布、媒体工具和插件仍由 OhMyGame 提供。在设置中启用,并遵循原生 CLI
的权限边界。详见[编程智能体](docs/coding-agents.md)。
- **媒体模型**:图片、视频、3D 和音频生成,可通过 OpenAI、Codex、OpenRouter、
火山方舟 / BytePlus ModelArk、MiniMax、Meshy、Tripo、Hyper3D,以及豆包语音 / Seed Audio 接入。
- **自定义服务商和模型别名**:可以选择语言、图片、视频和 3D 用途,配置协议模板和生成默认值。
详见[自定义模型配置](docs/custom-models.md)。
密钥只保存在本地守护进程里,永远不会进入 Agent 的工作区、你的游戏或渲染进程。
## 快速开始
### 下载
点击页面顶部的按钮,或者前往 [Releases](https://github.com/WhiteTowerAI/ohmygame/releases)
下载安装包。目前提供 macOS(Apple 芯片)和 Windows(x64)版本。Windows 版暂时还没有代码签名,
安装时 Windows 可能会弹出 SmartScreen 警告。
每个版本的变化可查看[更新日志](CHANGELOG.md),或在应用内打开
**设置 → 关于 → 更新日志**。
### 首次运行

OhMyGame 不内置模型。首次启动时,它会带你完成设置:
1. **连接你的 AI。** 登录模型服务商或粘贴 API 密钥,也可以使用你已安装的 Claude Code、Codex
或 OpenCode CLI。点击 **+** 可添加自定义或本地接口。**跳过并开始** 可直接进入工作室。
2. **添加创作工具(可选)。** 现在或稍后在 **设置 → 服务商与模型** 中连接图片、视频、3D
和音频服务商。只用语言模型也能设计和搭建游戏,生成媒体需要另外连接相应服务商:
| 想做的东西 | 需要连接 |
| ----------------------- | -------------------------------------------------------------- |
| 设计文档、代码、试玩 | 任意语言模型服务商 |
| 图片和精灵图 | Codex CLI(本机登录)、OpenAI(API 密钥)、OpenRouter,或火山方舟 / BytePlus ModelArk |
| 视频 | OpenRouter、火山方舟 / BytePlus ModelArk,或 MiniMax |
| 3D 模型、骨骼绑定、动画 | Meshy、Tripo 或 Hyper3D(各服务商支持的能力不同) |
| 配音、音效、音乐 | 豆包语音和 Seed Audio(火山引擎) |
ChatGPT 登录不包含 OpenAI 的图片 API,需要在 OpenAI 服务商的 **图像模型** 区域另外添加
API 密钥。**Codex CLI** 图片服务商则使用本机的 Codex 登录。详见
[OpenAI image connections](docs/custom-models.md#openai-image-connections)。
3. **选择模型,描述你的游戏。** 在首页的输入框里选择模型,然后描述你想做什么。
网页搜索无需配置即可使用。在本地做游戏不需要账号,只有发布时才需要登录。
可在 **设置 → 关于 → 查看入门引导** 中重新打开引导。
### 从源码运行
工具链需要 Bun 1.4.2 或更高版本,守护进程需要 Node.js 22.19 及以上。
```bash
git clone --branch main https://github.com/WhiteTowerAI/ohmygame.git
cd ohmygame
bun install --frozen-lockfile
bun run dev # 网页渲染端 + 本地守护进程
# 或者
bun run dev:desktop # Electron 桌面应用
```
这里用的是发布分支。如果要参与开发,请按照 [CONTRIBUTING.md](CONTRIBUTING.md#fork-and-create-a-branch)
从 `dev` 分支开始。本地开发不需要任何云端配置即可启动;可选的集成配置见
[CONTRIBUTING.md](CONTRIBUTING.md#configuration)。
## 隐私
你的项目和密钥都留在你自己的电脑上。提示词和生成请求直接发送给你选择的模型服务商。
发布游戏需要 OhMyGame 账号,并且只上传游戏的静态构建产物。正式版会检查更新,
并发送匿名使用数据(PostHog,不录制会话)和崩溃报告(Sentry,不含个人数据)。
从源码构建的版本不发送任何遥测数据。
桌面应用会在本机保留已脱敏的日志,只有当你在 **设置 → 关于 → 诊断信息** 中导出并分享文件时,
日志才会离开你的电脑。详见[日志与诊断](docs/diagnostics.md)。
## 路线图
我们正在做通俗易懂的试玩报告、从社区 Remix 游戏,以及 Intel Mac / Linux 版本。
接下来的计划见 [Issues](https://github.com/WhiteTowerAI/ohmygame/issues),
你可以给关心的功能点 👍 投票。想参与的话,可以看看标有
[`help wanted`](https://github.com/WhiteTowerAI/ohmygame/labels/help%20wanted) 的 Issue。
## 参与贡献
欢迎提交 Issue 和 PR。贡献分支请从 `dev` 拉出,普通 PR 也提交到 `dev`;`main` 用于发布。
环境搭建、检查和评审流程见 [CONTRIBUTING.md](CONTRIBUTING.md),
中文简介见[中文快速指引](docs/contributing.zh-CN.md),各模块的说明见[文档索引](docs/README.md)。
安全问题请按照 [SECURITY.md](SECURITY.md) 报告。
## Star 历史
## 许可证
[Apache-2.0](LICENSE)。OhMyGame 的名称和标志不在该许可证的授权范围内。