mcpField
R
remix-upload-game

remix-upload-game

github.com/farworld-labs開発59 回インストール
リポジトリ

remix-upload-game について

完成した HTML ゲームを Remix プラットフォームへアップロードするワークフロースキルです。ファイルを検証し、必要に応じてゲームを登録して、CLI または REST API でコードをアップロードします。

主な機能

  1. 01HTML ゲームファイルの特定
  2. 02Remix ゲーム要件の検証
  3. 03ゲームエントリーの作成
  4. 04CLI または REST によるコードのアップロード
  5. 05バージョンと起動準備の確認

活用シーン

  1. 01完成したゲームの Remix へのアップロード
  2. 02デプロイ前のゲーム検証

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/farworld-labs/remix-skills --skill remix-upload-game

インストール後、Claude Code で/remix-upload-gameを入力して読み込まれたか確認します。

詳細

ゲームのアップロードワークフロー

概要

このスキルでは、完成した HTML ゲームを Remix プラットフォームにアップロードする方法を説明します。ゲームのエントリーの作成（必要な場合）と、コードのアップロードについて解説します。

前提条件

  • アップロード可能な状態の、完成した HTML ゲームファイル。
  • ターミナルで作業する場合は、公式 CLI の利用をおすすめします。
    • remix login
    • remix games create --name "..."
    • remix games versions code update --code-path ./game.html

手順

1. ゲームファイルを探す

アップロードする HTML ファイルのパスを確認します。CSS と JS がインラインで記述された、単一の自己完結型 HTML ドキュメントである必要があります。

2. 検証する

HTML ファイルを読み込み、次の項目を確認します。

  1. <!DOCTYPE html> 宣言がある
  2. <meta name="viewport" ...> タグがある
  3. RemixSDK のスクリプトタグがある：<script src="https://cdn.jsdelivr.net/npm/@remix-gg/sdk@latest/dist/index.min.js"></script>
  4. 古い @farcade/game-sdk スクリプトタグがない
  5. singlePlayer.actions.gameOver( または multiplayer.actions.gameOver( のいずれかを呼び出している（両方ではない）
  6. .onPlayAgain( コールバックを登録している
  7. .onToggleMute( コールバックを登録している
  8. localStorage または sessionStorage を使用していない
  9. インラインイベントハンドラー（onclick=、onload= など）がない

報告された問題があれば、先に修正してください。

3. ゲームを作成する（必要な場合）

まず、タスクのコンテキストまたは以前のツールの結果に gameId と versionId がある場合は、それらを使用します。

ない場合は、最も近い .remix-cli.json を確認します。古いプロジェクトでは、.remix-mcp.json がまだ使われていることがあります。どちらかに gameId と versionId がすでに含まれている場合は、作成をスキップして手順 4 に進みます。

どの情報源にも ID がない場合は、CLI または REST でゲームを作成します。

CLI：

remix games create --name "My Game"

REST：

POST https://api.remix.gg/v1/games
Authorization: Bearer $REMIX_API_KEY
Content-Type: application/json

{ "name": "<game name>" }

レスポンスにはゲーム IDとバージョン IDが含まれます。

作成に成功したら、返された ID を .remix-cli.json に書き込みます。

{
  "gameId": "<returned game ID>",
  "versionId": "<returned version ID>",
  "name": "<game name>"
}
4. コードをアップロードする

タスクのコンテキスト、以前のツールの結果、.remix-cli.json、または古い .remix-mcp.json から gameId と versionId を読み取ります。

CLI の利用をおすすめします。

remix games versions code update --code-path ./game.html
remix games versions validate get
remix games launch-readiness get

HTML ファイルを読み込み、リクエストボディの code フィールドにその内容を渡します。

POST https://api.remix.gg/v1/games/{gameId}/versions/{versionId}/code
Authorization: Bearer $REMIX_API_KEY
Content-Type: application/json

{ "code": "<HTML file contents>" }

レスポンスには、ゲーム ID、バージョン ID、スレッド ID を含む確認情報が返されます。

ヒント

  • 問題を早期に発見できるよう、アップロード前に必ず検証してください。
  • 必要に応じて、同じバージョンに何度でもコードを再アップロードできます。
  • remix games versions status get と remix games versions thread get は、アップロード後の確認に便利なコマンドです。
  • 新しい下書きが必要な場合は、存在しないバージョン作成ルートを考案せず、新しいゲームエントリーを作成してください。

コメント

Markdown 対応