Player Two

Player Two SDK

面向游戏开发者和 AI Agent 的 Player Two 开放部分：游戏 SDK （playertwo-sdk）、入门项目 （create-playertwo-game）、示例和 Markdown 文档。

Player Two 是游戏商店和启动平台。游戏可以出售或免费游玩，玩家可以在浏览器中游玩，也可以下载。筹资功能让玩家在游戏开发期间支持游戏；开发者每发布阶段性成果证明后，便可获得相应款项。在 Player Two 上托管的网页游戏使用自己的 playertwo.cc 地址；每位玩家只需一个账号，即可获得：奖杯、XP 和等级、统计数据、排行榜、云存档、在线状态、邀请、附加内容、游戏内购买（开发者可保留 80%）、玩家头像、游戏间跳转，以及无需自建服务器的多人游戏房间，其中包括服务端房间代码、语音聊天、世界和回放。

此仓库包含 SDK、入门项目及其文档。Player Two 平台本身不是开源的。

快速开始

npm create playertwo-game@latest my-game
cd my-game
npm install
npm run dev      # open it in two tabs: each tab is a player

或者将 SDK 添加到自己的游戏中：

<script src="https://playertwo.lol/sdk/v1.js"></script>
<script>
  PlayerTwo.init()
    .then(async (p2) => {
      await p2.trophies.unlock("first-win");
      await p2.scores.submit("time-attack", 83400);
      const room = await p2.rooms.join({ mode: "arena", size: 16 });
      room.on("message:emote", (kind, from) => console.log(from, kind));
      room.send("emote", "wave");
    })
    .catch((e) => { /* not on Player Two (e.code "not-on-player-two"): play on without services */ });
</script>

npm install playertwo-sdk

import { init } from "playertwo-sdk";
const p2 = await init();

将游戏发布到 Player Two：在 https://playertwo.lol/submit 提交游戏，在工作室的 Agents 中创建 Agent 密钥，然后

curl -fsSLO https://playertwo.lol/cli/p2.mjs
P2_AGENT_KEY=p2_agent_... node p2.mjs push dist --game your-game

内容一览

路径	内容
packages/sdk	npm 上的 playertwo-sdk：供打包代码使用的 init()、页面的 TypeScript 类型（index.d.ts）和房间服务端代码的类型（playertwo-sdk/room、room.d.ts）
packages/create-playertwo-game	npm create playertwo-game@latest my-game
starters/threejs	Press Start，这是它生成的多人游戏 Three.js + Vite 入门项目
examples/trophies-and-leaderboard	单个 HTML 文件：使用 script 标签展示奖杯和排行榜
examples/multiplayer-room	一个房间，包含 room.sync、消息、共享状态和服务端 room.js
docs/	入门指南、全部 SDK 调用、房间、游戏内购买、托管、命令行工具、Agent 和 MCP、费用

面向 AI Agent：MCP 服务

Player Two 在 https://playertwo.lol/api/mcp 提供远程 MCP 服务（Streamable HTTP）。Agent 可以借助它提交玩家的游戏、上传媒体和网页构建版本、编辑游戏页面，以及管理奖杯、排行榜、产品、构建版本、帖子和房间。

claude mcp add --transport http player-two https://playertwo.lol/api/mcp

公共工具（get_submission_guide、check_game、search_games、list_games、get_game_facts、get_sdk_docs、where_to_publish）无需密钥。对于会更改游戏的工具，请添加玩家在 playertwo.lol 工作室的 Agents 中创建的 Agent 密钥：

claude mcp add --transport http player-two https://playertwo.lol/api/mcp --header "Authorization: Bearer p2_agent_..."

也可以完全不使用密钥：登录型客户端（Claude 和 ChatGPT 的连接器、Claude Code、Cursor）会要求玩家登录 Player Two，并在首次调用工作室工具时征求授权（OAuth 2.1 with PKCE）。

MCP Registry 名称：lol.playertwo/mcp（server.json）；服务卡片见 https://playertwo.lol/.well-known/mcp.json。也可通过纯 HTTP 使用相同功能：Agent API（GET https://playertwo.lol/api/v1/agent/guide、POST https://playertwo.lol/api/v1/agent/games），其 OpenAPI 3.1 规范见 https://playertwo.lol/openapi.json。详情请参阅：[docs/agents-and-mcp.md](./docs/agents-and-mcp.md)。

链接

• Player Two：https://playertwo.lol
• 文档：https://playertwo.lol/docs（SDK：https://playertwo.lol/docs/sdk，托管：https://playertwo.lol/docs/hosting）
• 面向语言模型：https://playertwo.lol/llms.txt，以及此仓库中的 llms.txt
• 单页了解游戏可获得的一切：https://playertwo.lol/developers
• 联系方式：[email protected]

问题

欢迎提交有关 SDK、其类型、入门项目、示例和这些文档的问题与拉取请求。有关你在 Player Two 上的账号、付款或游戏的问题，请访问：https://playertwo.lol/help。

许可证

MIT，详见 LICENSE。