mcpField
R
remix-upload-asset

remix-upload-asset

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

remix-upload-asset について

Remix REST API でゲームアセットをアップロードし、ホスティングするワークフローです。ゲーム HTML で画像、音声、3D モデルを参照する開発者向けに、ゲーム ID の再利用、アップロード、URL の取得方法をまとめています。

主な機能

  1. 01画像・音声・3D モデルのアップロード
  2. 02ゲームコードで使う URL の取得
  3. 03ゲーム内アセットの一覧取得
  4. 04既存ゲーム ID の確認を要求

活用シーン

  1. 01ゲームへの画像や効果音の追加
  2. 02ゲームで使う 3D モデルのホスティング
  3. 03アップロード済みアセットの URL 参照

インストール

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

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

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

詳細

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

概要

REST API を介して、任意のファイル（画像、音声、3D モデル）をホストされたゲームアセットとしてアップロードします。ゲームの HTML から参照できる永続的な URL が返されます。

前提条件

  • Remix プラットフォーム上にゲームがすでに存在している必要があります（ゲーム ID が必要です）。
  • REMIX_API_KEY 環境変数を設定する必要があります。

手順

1. 既存のゲーム ID を確認する

重要：最初に確認せず、新しいゲームを作成しないでください。

利用可能な場合は、タスクのコンテキストまたは以前のツール結果にある gameId を使用してください。

それ以外の場合は、最も近い .remix-cli.json を読み取ってください。古いプロジェクトでは、まだ .remix-mcp.json が使われている場合があります。いずれかに gameId が含まれている場合は、それを再利用してください。

どの情報源にも gameId が含まれていない場合に限り、upload-game ワークフローに従ってゲームを作成してください。

2. アセットをアップロードする

ファイルをマルチパートフォームデータとして送信します。

POST https://api.remix.gg/v1/games/{gameId}/assets
Authorization: Bearer $REMIX_API_KEY
Content-Type: multipart/form-data

Form fields:
  file       (required) — the binary file to upload
  assetName  (optional) — custom display name; defaults to the filename

許可される拡張子： .jpg、.jpeg、.png、.webp、.mp3、.wav、 .hdr、.glb、.gltf

ファイルの最大サイズ： 5 MB

レスポンス：

{
  "success": true,
  "data": {
    "gameId": "...",
    "asset": {
      "url": "https://..."
    }
  }
}

アセットのホスト URL として data.asset.url を使用してください。

3. ゲームの HTML で URL を使用する

返された URL をゲームのコードから参照します。例：

<img src="https://returned-asset-url.png" width="64" height="64" />

const img = new Image();
img.src = "https://returned-asset-url.png";
img.onload = () => ctx.drawImage(img, x, y, w, h);

const audio = new Audio("https://returned-asset-url.mp3");
audio.play();
4.（任意）すべてのアセットを一覧表示する

ゲームにアップロードされたすべてのアセットを取得します。

GET https://api.remix.gg/v1/games/{gameId}/assets
Authorization: Bearer $REMIX_API_KEY

ヒント

  • ファイルには内容がわかる名前を付けてください。 player-idle.png や jump-sfx.mp3 のような明確なファイル名を使用してください。ファイル名がデフォルトのアセット名になります。
  • ゲームプレイの開始前にアセットをプリロードしてください。 アセットの読み込み漏れを防ぐため、ゲームループを開始する前に onload／canplaythrough イベントを待ってください。
  • ファイルごとに 5 MB 未満にしてください。 アップロードする前に画像や音声を圧縮してください。可能な場合は、画像には .webp、音声には .mp3 を使用してください。
  • アセットごとに繰り返してください。 ゲームに必要なファイルごとに、手順 2～3 を実行してください。

コメント

Markdown 対応