文档 · 开始

快速开始

三条路径,任选其一:在浏览器里用 Origin 做游戏;让你自己的 Agent 做游戏并发布;用脚本或 API 发布一个已经做好的网页游戏。

准备

  • 一个 OriginGame 账号:在 /login 登录或注册。
  • 路径三(脚本或 API)还需要账号 API token(og-...),在 /me/access 创建。
  • 发布任何游戏都需要:根目录有 index.html 的静态网页构建、一个标题、一张 16:9 的封面图(PNG 或 JPEG)。用 Origin 时,这些由 Origin 准备。

路径一:在浏览器里用 Origin 做游戏

  1. 在电脑或手机浏览器打开 origingame.ai/agent 并登录。
  2. 如果页面显示「Origin 正在内测」,说明你的账号还没加入内测:点「申请内测」,通过后会收到通知。
  3. 在游戏库里选一种开始方式:「描述」用一句话说出想法;「Remix」从已发布的作品出发;「发现」从六个玩法原型开始;「给我惊喜」先看三个不同玩法的概念。
  4. Origin 在一个会话里开始工作。你可以随时发消息引导它、回答它的问题,或者停止当前这一轮。
  5. 命令在执行器里运行:默认是「自动」,你的 Origin Runner 在线且具备所需工具时用它,否则用平台的云沙箱。不装 Runner 也能直接开始。
  6. 打开「预览」试玩当前构建。手机上点「开始游玩」,当前构建会在全屏游玩页打开,返回即回到会话。
  7. 准备发布时,在「发布」里点「发布…」:输入框里会填好一条消息,请 Origin 发布最新的打包,并先给你看商店页文案和封面图。也可以直接在对话里说要发布。

工作区、检查点和 Runner 的完整说明见 Origin。

路径二:让你自己的 Agent 做游戏并发布

先把 Origin MCP 接进你的 Agent,再用自然语言让它做游戏和发布。有两种接法。

用 Origin Kit 一次配置多个 Agent

  1. 下载 Origin Kit(macOS、Windows)并打开。
  2. 点「登录 Origin」,在浏览器里确认授权。回到 Kit 后,「Agent」页会列出这台电脑上的 Agent。
  3. 可选:在 Agent 那一行的模型菜单里选一个 Origin 模型,然后重启这个 Agent。标着「仅自有模型」的 Agent(如 Cursor)跳过这步。
  4. 在「MCP」页点 Agent 旁的「配置」,重启 Agent,再按提示在浏览器里登录 Origin。

习惯用终端的话,也可以运行安装脚本。它会检测本机的 Claude Code、Codex 和 Grok,让你选择要配置的 Agent,并写入 Origin MCP:

curl -fsSL https://origingame.ai/install.sh | sh

Kit 支持哪些 Agent 见 接入 Agent。

用 MCP 地址接入单个客户端

  1. 在客户端的 MCP 设置(常叫「连接器」「集成」或「MCP Servers」)里新建一个远程服务器。
  2. 名称填 origin,传输方式选 Streamable HTTP,地址填 https://mcp.origingame.ai/mcp。
  3. 第一次使用时,客户端会打开 Origin 登录页,登录并确认授权即可,不需要复制密钥。只能填固定请求头的客户端请改用 Origin Kit 或安装脚本。
  1. 第 1 步 ·添加 Origin

    在终端运行这一行,为你的所有项目添加 Origin MCP。

    claude mcp add --transport http --scope user origin https://mcp.origingame.ai/mcp
  2. 第 2 步 ·在浏览器里登录

    启动 Claude Code,输入 /mcp,选中 origin 后选择 Authenticate。浏览器会打开 Origin 授权页,登录并确认即可。

    /mcp
  3. 第 3 步 ·开始使用

    再输入一次 /mcp,origin 显示已连接(connected)后,直接用自然语言提出需求。

让 Agent 做游戏并发布

连接好以后,在 Agent 里这样说:

  • 做一个霓虹风格的躲避游戏,手机能玩,做完发布到 Origin
  • 把这个游戏发布到 Origin,标题叫“霓虹闪避”,用 cover.png 做封面

Agent 会通过 Origin MCP 的 deploy_create 发布新游戏。Origin MCP 的发布指引要求 Agent 在公开发布前征得你同意;发布成功后,它会给出游戏 ID、游玩链接和作品页链接。

路径三:用脚本或 API 发布已有的游戏

适合已经有网页构建、想在终端或 CI 里发布的情况。

先创建账号 API token。每个账号有一个 token,可以随时在 /me/access 复制或轮换:

获取 API Token
  1. 构建游戏,确认输出目录的根有 index.html。
  2. 准备一张 16:9 封面:PNG 或 JPEG,至少 640×360,不超过 5 MB。
  3. 用发布脚本或 HTTP API 发布,二选一。

用发布脚本(需要 bash、curl 和 Bun):

git clone https://github.com/fran0220/origingame-skill
export OG_HOST=https://origingame.ai
export OG_API_KEY=og-...
origingame-skill/scripts/deploy.sh ./dist --title "Neon Dodge" --cover cover.png

直接调用 HTTP API(先把构建打成 ZIP):

curl https://origingame.ai/api/deploy \
  -H "Authorization: Bearer $OG_API_KEY" \
  -F "title=Neon Dodge" \
  -F "cover=@cover.png" \
  -F "file=@dist.zip"

成功时返回 201,响应里的 playUrl 是游玩地址,portalUrl 是可分享的链接 https://origingame.ai/g/<slug>,gameId 用于以后更新。发布出的游戏可以在 /me/games 管理。

下一步

  • 发布游戏:更新、版本上线与回滚、全部上传字段。
  • 游戏协议:让游戏接入排行榜、云存档和多人房间。
  • Origin MCP:Agent 还能用的素材检索、媒体生成和代码模块。
  • 脚本页面:脚本和 API 发布的示例。