Player Two

Player Two SDK

ゲーム開発者とAIエージェント向けのPlayer Twoのオープンソース部分です。ゲーム SDK （playertwo-sdk）、スターター （create-playertwo-game）、サンプル、Markdown 形式のドキュメントを提供します。

Player Two はゲームストアであり、ゲームを公開するためのプラットフォームです。ゲームはブラウザーでプレイするか、ダウンロードしてプレイでき、有料または無料で販売されます。また、ゲームの開発中にプレイヤーが出資でき、開発者が進捗の証拠を投稿すると、開発段階ごとに報酬が支払われます。Player Two でホストされるウェブゲームは、playertwo.cc 上の専用アドレスで動作し、プレイヤーごとに 1 つのアカウントを通じて、トロフィー、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」でエージェントキーを作成してから、次のコマンドを実行します。

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）、ルームのサーバーコード用の TypeScript 型（playertwo-sdk/room、room.d.ts）
packages/create-playertwo-game	npm create playertwo-game@latest my-game
starters/threejs	これを使って作成できる、マルチプレイヤー対応の Three.js + Vite スターター「Press Start」
examples/trophies-and-leaderboard	HTML ファイル 1 つで、script タグを使ってトロフィーとリーダーボードを実装する例
examples/multiplayer-room	room.sync、メッセージ、共有状態、サーバー側の room.js を使ったルーム
docs/	はじめに、SDK の全呼び出し、ルーム、ゲーム内購入、ホスティング、CLI、エージェントと MCP、手数料

AI エージェント向け：MCP サーバー

Player Two は、https://playertwo.lol/api/mcp でリモート MCP サーバー（Streamable HTTP）を稼働させています。これを使うと、エージェントはプレイヤーのゲームを送信し、メディアやウェブビルドをアップロードし、ゲームページを編集し、トロフィー、リーダーボード、商品、ビルド、投稿、ルームを管理できます。

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」で作成できます。

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

キーを使わない方法もあります。サインインするクライアント（Claude と ChatGPT のコネクター、Claude Code、Cursor）では、スタジオツールを初めて呼び出す際に、プレイヤーに Player Two へのサインインと利用の許可を求めます（PKCE を使った OAuth 2.1）。

MCP Registry 名：lol.playertwo/mcp（server.json）。サーバーカード：https://playertwo.lol/.well-known/mcp.json。同じ機能は通常の HTTP でも利用できます。エージェント API（GET https://playertwo.lol/api/v1/agent/guide、POST https://playertwo.lol/api/v1/agent/games）には、https://playertwo.lol/openapi.json で OpenAPI 3.1 仕様が公開されています。詳細：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
• ゲームで利用できるすべての機能を 1 ページで紹介：https://playertwo.lol/developers
• お問い合わせ：[email protected]

問題

SDK、その型、スターター、サンプル、これらのドキュメントに関する問題やプルリクエストを歓迎します。アカウント、お支払い、または Player Two のゲームについてのご質問は、https://playertwo.lol/help をご覧ください。

ライセンス

MIT。詳しくは LICENSE をご覧ください。