Unity / Godot / JavaScript SDK ガイド

Package Manager の Add package from git URL... に https://github.com/gamerush-cc/grush-sdk-unity.git#v1.11.1 を入れてください。# の後ろが版で、新しい版へ上げるときはここを書き換えます。Unity 2021.3 以降、ビルドターゲットは WebGL です。パッケージ識別子は cc.gamerush.sdk です（ソースは grush-sdk-unity）。

入れると GameRush メニューが増え、Unity から出ずにログインしてビルドを上げられます（14. Unity Editor からアップロードする）。

using GRushSdk;

var self = await GRush.Player.GetSelfAsync();
if (self.Ok) Debug.Log(self.Value.PseudoId);

var joined = await GRush.Net.JoinAsync("duel");
if (!joined.Ok) return;

var room = joined.Value;
room.Message += message =>
{
    if (message.IsStale) return;
    Apply(message.From, message.Payload);
};
room.PeerJoined += peer => Debug.Log(peer.Index);
room.TransportChanged += transport => Debug.Log(transport);
room.Error += error => Debug.LogWarning(error.Code);
room.Closed += reason => Debug.Log(reason);

room.Send(bytes, GRushChannel.Unreliable, GRushRoom.Everyone);
var now = room.ServerTimeMs();
await room.LeaveAsync();

JS からのコールバックは次の Update で発火します。イベントハンドラの中は Unity のメインスレッドなので、そのまま Unity の API を触って構いません。

grush-sdk-godot のリリース（v1.9.1）を取得し、addons/grush_sdk/ をプロジェクトの addons/ へコピーし、Project Settings > Plugins で有効にしてください。autoload シングルトン GRush が自動登録されます。書き出しは Web です。

var self_result: Dictionary = await GRush.player.get_self()
if self_result["ok"]:
    print(self_result["value"]["pseudo_id"])

var joined: Dictionary = await GRush.net.join("duel")
if not joined["ok"]:
    return

var room: GRushRoom = joined["value"]
room.message_received.connect(func(message: Dictionary) -> void:
    if message["is_stale"]:
        return
    apply(message["from"], message["payload"]))
room.peer_joined.connect(func(peer: Dictionary) -> void: print(peer["index"]))
room.transport_changed.connect(func(transport: String) -> void: print(transport))
room.error_received.connect(func(error: Dictionary) -> void: push_warning(error["code"]))
room.closed.connect(func(reason: String) -> void: print(reason))

room.send(bytes, GRush.CHANNEL_UNRELIABLE, GRush.EVERYONE)
var now := room.server_time_ms()
await room.leave()

結果はすべて {"ok": bool, "value": Variant, "code": String, "message": String} の形で返ります。Unity 版と同じ形を GDScript の慣習（snake_case・Dictionary・signal）に置いたものです。

grush-sdk-js の grush-sdk.js（グローバル版）か grush-sdk.mjs（ES Modules 版）をゲームのフォルダへコピーするか、CDN から読んでください。依存はありません。CDN から読むときは版を固定してください。版を固定しないと、アップロード済みのビルドの挙動が後から変わります。

<script src="https://cdn.jsdelivr.net/gh/gamerush-cc/grush-sdk-js@v0.11.0/grush-sdk.js"></script>
<script>
  GRush.leaderboards.submit("high_score", 12000).then((result) => {
    if (result.ok) console.log("rank", result.value.rank);
    else console.log("not sent", result.code);
  });
</script>

グローバル版は window.GRush に入ります。同じ名前の変数が既にあるときは上書きせず、window.GRushSdk だけに入ります。

<script type="module">
  import GRush from "./grush-sdk.mjs";

  const self = await GRush.player.getSelf();
  if (self.ok) console.log(self.value.pseudoId);
</script>

const self = await GRush.player.getSelf();
const profile = await GRush.player.requestProfile();

const saved = await GRush.cloudSave.save({ stage: 3 }, "default");
const loaded = await GRush.cloudSave.load("default");

const joined = await GRush.net.join({ mode: "duel" });
if (joined.ok) {
  const room = joined.value;
  room.on("message", (message) => {
    if (message.isStale) return;
    apply(message.from, message.json());
  });
  room.on("peerjoin", (peer) => console.log(peer.index));
  room.on("error", ({ code }) => console.warn(code));
  room.on("close", ({ reason }) => console.log(reason));
  room.sendJson({ x: 1, y: 2 }, { channel: GRush.CHANNEL_UNRELIABLE, to: GRush.EVERYONE });
  const now = room.serverTimeMs();
  await room.leave();
}

結果はすべて { ok, value, code, message } の形の Promise で返り、reject しません。code は Unity の GRushErrorCode と同じ名前を小文字始まりにした文字列（invalidParams など）です。JavaScript 版だけにある conflict は、クラウドセーブの版ずれ（baseRevision の不一致）です。

• 送れるのは ArrayBuffer・型付き配列・文字列です。sendJson は値を JSON 文字列にして送ります。受け取ったメッセージは text() と json() で読めます。
• GRush.cloudSave は、本人だけが読むクラウドセーブです。他プレイヤーへは見えません。ゲストは signInRequired になります。ゲストの分を端末に置くときは、下の「クラウドセーブの端末への保存」の fallback: "local" を使います。
• GameRush は、プレイヤーが次のゲームへ送り始めたときや一覧を開いたときにゲームを止めます。止めている間は document.visibilityState が hidden になり、visibilitychange が届きます。セーブはこのときに送ってください。次のゲームへ送った後のゲームはまもなく閉じられるので、時間を置いてからの保存は届かないことがあります。
• 止めている間は Date.now() も止まり、再開すると止めていた時間の分だけ進みます。フレームの経過時間は requestAnimationFrame の時刻か performance.now() で測ってください。こちらは止めていた時間を含みません。
• GRush.backend は、GameRush 上では web、localhost・127.0.0.1・file:// では mock、それ以外のサイトでは none になります。none のときは、どの呼び出しも unsupported を返します。

load・save・remove の最後の引数に { fallback: "local" } を渡すと、GameRush がプレイヤーのサインインを確かめられないとき（渡さなければ signInRequired になるとき）だけ、セーブを端末に読み書きします。JavaScript 版だけの機能です。

const loaded = await GRush.cloudSave.load("default", { fallback: "local" });
if (loaded.ok) {
  const revision = loaded.value?.revision ?? 0;
  const saved = await GRush.cloudSave.save({ stage: 3 }, "default", {
    baseRevision: revision,
    fallback: "local",
  });
  if (saved.ok) console.log(saved.value.storage); // "cloud" か "local"
}

• 返る項目の storage は、クラウドに置いたときは cloud、端末に置いたときは local です。local は、GameRush がサインインを確かめられず端末に保存したことを表します。端末のセーブの revision は常に 0 です。
• 端末のセーブは、その端末のそのアプリ（ブラウザ）の中にだけあります。別の端末やアプリからは読めず、ブラウザが消すこともあります。
• サインインしても、端末のセーブは自動ではクラウドへ上がりません。サインイン後の load でクラウドに無ければ端末のセーブが返るので、それを save するとクラウドへ上がります。クラウドにあればクラウドのセーブが返ります。
• 端末のセーブには、保存した時点で GameRush が分かっていたアカウントを記録します。サインイン済みの load では、別のアカウントのものと分かっている端末のセーブは返りません。どのアカウントか分からないまま保存した端末のセーブは、サインインしたどのアカウントにも返ります。
• サインインを確かめられないときの load と remove は、どのアカウントで保存したかに関係なく、その端末のセーブを返し、消します。共用の端末では、前に使った人の端末のセーブが返ることがあります。
• fallback: "local" 付きの save と remove がクラウドで成功すると、同じスロットの、そのプレイヤーの端末のセーブと、どのアカウントのものか分からない端末のセーブが消えます。別のアカウントのものは残ります。
• 一度サインインを確かめられなくなった後でサインインが戻ると、クラウドのセーブが優先されます。その間に端末へ保存した新しい分は、クラウドにセーブがあれば load で返りません。fallback: "local" 付きの保存がクラウドで成功すると、そのプレイヤーの端末のセーブは消えます。
• 端末への書き込みでは baseRevision を見ず、最後の書き込みが残ります。端末のセーブの revision（0）をそのまま baseRevision に渡すと、クラウドが空なら書け、クラウドにあれば conflict になります。
• サインインの直後の save が conflict になったら、load してから保存し直してください。
• 切り替えるのはサインインを確かめられないときだけです。通信の失敗・版ずれ・上限超えなど、ほかの失敗では端末に保存せず、そのまま失敗を返します。
• fallback に "local" と null 以外の値を渡すと invalidParams です。null は渡さないときと同じです。protocolVersion が 5 未満の GameRush では fallback を無視し、渡さないときと同じ呼び出しになります（ゲストは signInRequired）。

ビルドのいちばん上（index.html と同じ階層）に grush.json を置くと、そのビルドが最新になったときに中のランキングの定義が反映されます。Studio からアップロードするだけで定義でき、API トークンは要りません。公開中のゲームでは、新しいビルドは審査で承認されてから配信されるので、定義もそのビルドが承認されて配信される時点で反映されます。それまでは、配信中のビルドの定義がそのまま使われます。

{
  "leaderboards": [
    {
      "key": "high_score",
      "title": "ハイスコア",
      "sort": "desc",
      "valueType": "int",
      "aggregation": "best",
      "period": "all_time",
      "minValue": 0,
      "maxValue": 1000000
    },
    {
      "key": "weekly_time",
      "title": "今週のタイムアタック",
      "sort": "asc",
      "valueType": "duration_ms",
      "aggregation": "best",
      "period": "weekly",
      "minValue": 0,
      "maxValue": 3600000,
      "enabled": true
    }
  ]
}

最上位に書けるのは leaderboards と $schema だけです。知らない項目・重複した key・21 個以上の定義・64KB を超えるファイルは、綴りの誤りを見逃さないよう拒みます。Studio はアップロードの前に同じ規則で確かめます。

反映は key ごとで、同じ内容なら何も書きません。grush.json に書かなかった key の枠は、消えも止まりもしません。止めるときは "enabled": false と書きます。消すときは、Studio の画面か API で行ってください。grush.json に書いた key の枠の title・値域・enabled は、Studio の画面や API で変えても、grush.json を含むビルドを次に上げたときにファイルの値へ戻ります。

スコアが投稿された枠の sort・valueType・aggregation・period を変える宣言と、すでにある枠と合わせて 1 ゲーム 20 個を超える宣言は、ビルドごと失敗になります。変えたいときは新しい key で宣言してください。

grush.json はほかのファイルと同じく配信されるので、ゲームから読んでも構いません。gzip で事前圧縮したものは読めますが、brotli で圧縮したものは受け付けません。API トークンで grush.json を含むビルドを上げるときは、builds:write に加えて leaderboards:write が要ります。

エディタとローカルのモックも同じ grush.json を読み、最初のランキングの呼び出しの前にその枠を宣言します。JavaScript 版が読むのはローカルサーバから開いたときだけで、3 秒以内に読めなければ読まなかったものとして扱います。file:// では GRush.mock.loadLeaderboards(manifest) に中身を渡してください。中身を渡すときは Unity が GRushMockLeaderboards.LoadManifest(json)、Godot が GRushMockLeaderboards.load_manifest(json_text) で、どれも読むのはアップロードと同じ規則です。

モックは書式の誤りをアップロードと同じ文言で警告し、その中身を使いません。中身を渡したときの誤りは、Unity の LoadManifest が GRushErrorCode.InvalidParams、Godot の load_manifest と JavaScript の loadLeaderboards が invalidParams で返します。enabled: false の枠は一覧に出ず、投稿と取得は宣言していない key と同じ失敗（Unity は InvalidParams、Godot と JavaScript は invalidParams）です。grush.json で minValue / maxValue を書かなかった枠は、GameRush と同じく投稿を受けません。period が daily / weekly / monthly の枠は GameRush と同じ期間キー（UTC）を返し、期間が変わると空からやり直します。ファイルを自動で読むときは、同じ key を Define / define / defineLeaderboard で宣言してあればそちらを使います。LoadManifest / load_manifest / loadLeaderboards に渡した定義は、それらの宣言を置き換えます。

SubmitAsync(key, value, metadataJson, operationId) / submit(key, value, metadata, operation_id) の第4引数は、同じ投稿の再送を弾くための識別子です。

加算は冪等ではありません。

投稿がサーバに届いて保存された後で応答だけが失われた場合、そのまま送り直すと二重に足され、集約後の値からは元へ戻せません。再送するなら同じ operationId を渡してください。best と last は同じ値を再適用しても結果が変わらないので、省略して構いません。

非同期対戦の相手を探すために、同じゲームの他プレイヤーの公開状態をランダムに引けます。公開状態には相手探しに使う数値 rating を持たせられ、rating の範囲で絞れます。

// Unity
await GRush.PlayerState.SetMineAsync("{\"deck\":\"fire\",\"level\":12}", -1, 1520);
var found = await GRush.PlayerState.SampleAsync(5, 1400, 1600);
if (found.Ok)
{
    foreach (var rival in found.Value.States) Debug.Log(rival.PseudoId + " " + rival.Rating);
}

# Godot
await GRush.player_state.set_mine({"deck": "fire", "level": 12}, null, {"rating": 1520})
var found: Dictionary = await GRush.player_state.sample({"count": 5, "min_rating": 1400, "max_rating": 1600})
if found["ok"]:
    for rival in found["value"]:
        print(rival["pseudo_id"], rival["rating"])

// JavaScript
await GRush.playerState.setMine({ deck: "fire", level: 12 }, undefined, { rating: 1520 });
const found = await GRush.playerState.sample({ count: 5, minRating: 1400, maxRating: 1600 });
if (found.ok) for (const rival of found.value) console.log(rival.pseudoId, rival.rating);

• 1 回に引けるのは 1〜20 件で、省略すると 10 件です。自分の状態と運営が伏せた状態は返りません。
• 返るのは疑似ID・payload・rating などの状態だけで、名前とアイコンは返りません。
• rating の範囲は最小と最大を一緒に渡します。範囲を渡すと、rating を書いていない状態は返りません。
• rating は -1e9 より大きく 1e9 より小さい数値です。null を渡すと消え、渡さなければ今の値のまま payload だけを書き換えます。
• rating を書いていない状態の rating は、Unity では HasRating が false、Godot と JavaScript では null です。
• 相手探しは protocolVersion 7 以上の GameRush で使えます。それより古い GameRush では、相手探しは Unsupported になり、rating は送らずに payload だけを書きます。Unity は GRush.IsMatchmakingAvailable で確かめられます。
• protocolVersion が 7 以上でも、アプリの更新の間などは rating が書かれないことがあります。そのときも書き込みは成功し、payload は書かれます。rating が書けたかは、setMine が返す状態の rating で確かめてください。

ゲームは通報の画面を描けません。通報を呼ぶと GameRush が確認を出し、プレイヤーが承諾したときだけ送られます。返るのは「送られたか」の真偽値です。ゲストは SignInRequired です。

通報すると送り手をブロックします。その相手からのメッセージと、その相手の出品は見えなくなります。確認には、GameRush が取り直したメッセージの中身と、送り手の疑似IDの先頭 8 文字と受け取った日時が出ます。

通信が途中で切れても、アイテムが消えたり増えたりしないよう、次の順で使ってください。

• 1. 出品の前に、出すアイテムを手元のセーブで仮置き（使えない状態）にします。
• 2. 出品の識別子 operationId（英数字と . _ : - の 64 文字まで）をセーブに保存してから出品します。
• 3. 応答が失われたら、同じ operationId で出品を呼び直します。同じ operationId の再送には、中身によらず先に作った出品が返ります。
• 4. 自分の取引（Unity は MineAsync、Godot と JavaScript は mine）の、終わった取引（pending）をセーブに反映し、クラウドセーブに保存してから、その取引 ID で受け取りを確かめます（ack）。ack するまで、終わった取引は pending に残ります。
• 5. 反映済みの取引 ID をセーブに持ち、同じ取引を二度反映しないようにします。

知らない action は反映せず、ack もしないでください。ゲストのときに出品・受諾した取引の pending は、同じゲストとして開いたときに返り、サインインしている間は返りません。

• 出品は、誰でも受けられる公開の出品と、相手の疑似IDを指定する指名の出品の2種類です。
• offerKey / wantKey は一覧の絞り込みに使う識別子（英数字と . _ : - の 32 文字まで）で、省略できます。
• 期限は 600〜604800 秒（10 分〜7 日）で、省略すると 3 日です。受付中の出品は 1 人 10 件までです。
• 受付中の出品が 10 件あるときの出品は InvalidParams です。待っても直らないので、取り下げるか、成立・期限切れを待ってから出品してください。
• 出品は 1 人毎日 30 件、成立させた受諾は毎時 30 件までで、超えると RateLimited です。時間が経てば回復します。待つ時間が分かるとき（ゲストの短い間の送りすぎ）は、JavaScript の結果に待ち時間 retryAfterMs が入ります。
• 一覧に出るのは、他人の公開の出品と自分宛ての指名の出品のうち、受付中のもの（新しい順、1 回 1〜50 件）です。
• give は当事者（出品者と受けた側）にだけ入り、ほかの人には null です。

受諾の結果はエラーではなく outcome で返ります。成立した取引は matched のときだけ一緒に返ります。2人が同時に受けても、成立するのは片方だけです。

ゲームは通報の画面を描けません。通報を呼ぶと GameRush が確認を出し、プレイヤーが承諾したときだけ送られます。返るのは「送られたか」の真偽値です。ゲストは SignInRequired です。通報すると出品者をブロックし、その相手のメッセージと出品は見えなくなります。

確認には、GameRush が取り直した出品の中身と、出品者の疑似IDの先頭 8 文字と出品の日時が出ます。プレイヤーは画面の出品と見比べて通報します。自分の出品は通報できず、確認を出さずに InvalidParams です。

共有に起動パラメータを添えると、GameRush が付ける URL に ?gp.dungeon=3 のように載ります。受け取った人がその URL からゲームを開くと、ゲームは 12. 起動パラメータ の呼び出しで値を読めます。

// Unity
var launchParams = new Dictionary<string, string> { { "dungeon", "3" } };
var shared = await GRush.Share.ShareScreenAsync("ダンジョン3に挑戦", launchParams);
if (!shared.Ok && shared.Code == GRushErrorCode.Unsupported)
{
    shared = await GRush.Share.ShareScreenAsync("ダンジョン3に挑戦");
}

# Godot
var shared: Dictionary = await GRush.share.share_screen("ダンジョン3に挑戦", {"dungeon": "3"})
if not shared["ok"] and shared["code"] == "unsupported":
    shared = await GRush.share.share_screen("ダンジョン3に挑戦")

// JavaScript
let shared = await GRush.share.share({
  text: "ダンジョン3に挑戦",
  image: "screen",
  launchParams: { dungeon: "3" },
});
if (!shared.ok && shared.code === "unsupported") {
  shared = await GRush.share.share({ text: "ダンジョン3に挑戦", image: "screen" });
}

• キーと値の制限は 12. 起動パラメータ と同じです。キーは英数字と _ - で 1〜32 文字（__proto__ は使えません）、値は英数字と . _ ~ : , - で 0〜128 文字、8 個までです。
• URL から読むときと違い、1つでも合わない項目があると共有を開かずに InvalidParams を返します。合わない項目だけを落として共有することはしません。
• 空の起動パラメータは、渡さないときと同じです。
• 起動パラメータに対応する前の古い GameRush（protocolVersion 9 未満）では、共有を開かずに Unsupported を返します。起動パラメータを外して呼び直せば共有できます。

共有した URL は誰にでも見え、そのまま転送されます。招待コードのような、プレイヤーを識別できる値を入れないでください。

受け取る側のゲームは値を信用せず、確かめてから使ってください。共有した URL の起動パラメータは、受け取った人が書き換えられます。

• Unity は画像ファイルのバイト列（Texture2D.EncodeToPNG() など）を渡します。
• Godot は Image を渡します。SDK が PNG にしてから渡します。
• JavaScript は Blob・ArrayBuffer・型付き配列・data URL・HTMLCanvasElement・{ base64, mimeType } を渡せます。
• どれも "screen"（Unity は ShareScreenAsync、Godot は share_screen）でゲームの画面のスクショを送れます。
• 受け付ける形式は PNG・JPEG・GIF・WebP です。SVG などほかの形式は InvalidParams になります。
• 4MB まで、縦横それぞれ 4096px まで、総画素数 16MP までです。GameRush が長辺 1600px の JPEG に作り直してから送ります（GIF は 1 コマ目、透過は黒）。

"screen" に写るのはゲームの canvas だけです。DOM で描いた文字や画像は "screen" に写りません。

HTML の要素でスコアや名前を重ねているなら、canvas に描いた画像を自分で作って渡してください。ゲームが最初に描画するより前の "screen" は Unavailable です。

画像が実際に送り先へ付くかは、プレイヤーの端末と送り先で決まります。どう送るかはシートに出ます。

• 画像ファイルを付けられるスマホの端末共有では、画像ファイルを付けます。
• LINE の送信先選択、画像ファイルを付けられないスマホの端末共有、PC の X 投稿画面では、画像と本文を載せた共有ページを作ってその URL を送ります。LINE には画像と「遊ぶ」ボタンの付いたメッセージで届き、X ではリンクのカードに画像が出ます。共有ページを作れなかったときは本文と URL だけになります。
• PC の X 投稿画面には画像ファイルを付けられません。画像つきのポストにしたいプレイヤーは、シートで画像を保存して投稿画面で添付できます。
• Android アプリでは本文と URL だけになります。

共有ページは 90 日間、URL を知っている人なら誰でも見られます。ゲームが渡した本文がそのまま載るので、プレイヤーに見られて困る文字を入れないでください。載せる画像は長辺 1024px・1MB までの JPEG に作り直されます。

URL は形で判定するので、Lv.MAX のような英字どうしのドット表記も弾かれます（v1.5 のように数字を挟むものは通ります）。ハッシュタグは使えます。

X へ送るときは、GameRush が本文の末尾に #GameRush を付けます。本文に #GameRush があれば付けません。

結果が返るまで、プレイヤーがシートで迷うあいだ待ちます。14 分でシートは閉じて cancelled が返ります。opened を報酬の条件にするなら、同じ報酬を何度も渡さないようゲーム側で数えてください。

Unity を使うなら自分で実装する必要はありません。14. Unity Editor からアップロードする の Editor 拡張がこの手順を持っています。ここは自前の CLI やエディタ拡張を書く人向けです。

手元でループバックのサーバを立てて /studio/authorize を開き、承認後に戻ってきたコードを交換します（RFC 8252 + PKCE）。手順とパラメータは API リファレンスの loopback 承認 にあります。

• redirect_uri は http://127.0.0.1:<port> / http://localhost:<port> / http://[::1]:<port> だけ。ポートは任意で、クエリもフラグメントも付けられない
• code_challenge_method は S256 のみ。code_verifier は 43〜128 文字
• コードはワンタイムで 5 分。code_verifier を間違えた時点でそのコードは死ぬので、失敗したら承認からやり直す
• こうして取ったトークンは Studio の一覧に発行元のクライアント名つきで並ぶので、手発行と見分けられる
• games:create はゲームの許可リストと併用できない（発行時に 400、使用時に 403）。まだ無いゲームは許可リストに載せられないため

• Unity で WebGL に書き出す（index.html が直下にあること）。15. 推奨設定でビルドする を使うと、書き出した先がそのまま次の手順に入る
• GameRush ウィンドウでゲームを選ぶ。新規作成もできる（games:create を要求したトークンが要る。作成の前に、ゲームと第三者アセットの権利を確認するチェックを入れる。unlisted で作るときは、全年齢向けの内容であることを申告するチェックも入れる）
• 書き出しディレクトリを選ぶと、上げる前に手元で検査する — 拡張子・パス・ファイル数・総量がサーバと同じ規則で見られるので、2000 ファイル上げ切ってから弾かれることがない
• アップロードする（進捗が出る。途中で止められる。失敗したファイルだけ再送する）

新規作成ではタイトル・説明・遊び方を入れ、可視性を選べます（private か unlisted）。遊び方は操作方法・目的・コツなどを複数行で書けます。既存ゲームの説明・遊び方・公開設定は Studio か API の PATCH /api/games/:id で変えてください。

unlisted は審査を経ずに選べます。アップロードが終わった時点で、URL を知っている人がすぐ遊べます。フィードと検索に載る public は審査を通るので、Studio か API で申請してください。

• 書き出しディレクトリの直下に grush.json を置くと、そのビルドが最新になったときにランキングの定義も反映される（書式は 5. ランキング）。公開中のゲームでは、ビルドが審査で承認されて配信される時点で反映される。このときトークンに leaderboards:write が要る
• 公開中のゲームに上げたビルドは審査に積まれ、審査の間は前に承認されたビルドの配信が続く。承認されると新しいビルドに差し替わる
• Brotli / gzip で書き出したファイルはそのまま上げる。Build/x.wasm.br は .br が付いた名前のまま登録され、配信側がその名前で Content-Encoding を決める
• 作成の失敗を機械的に再試行しない。ゲームとビルドの作成には冪等キーが無く、再試行が2つ目を作る（個別ファイルの送り直しは安全）
• Editor 拡張が古いとサーバが操作を止める。止まったらパッケージを更新する

• GameRush > GameRush ウィンドウ の「推奨設定でビルド」に、いまの設定とおすすめの値が並ぶ。ログインしていなくても使える
• 推奨設定を適用 で、変わる項目を確かめてから適用する。推奨設定でビルド は適用してから WebGL でビルドする
• ビルドが終わると、出力先がそのままアップロード欄に入る（14. Unity Editor からアップロードする）
• メニューの GameRush > 推奨設定を適用 / GameRush > 推奨設定でビルド からも呼べる
• Build Settings で有効にしたシーンをビルドする。出力先の既定は Build/GameRush で、ビルドのたびに中身を作り直す（Assets/ などプロジェクトの中の大事なフォルダは選べない）

Unity -batchmode -quit -projectPath . -buildTarget WebGL \
  -executeMethod GRushSdk.Editor.GRushBuild.BuildRecommended \
  -grushOutput Build/GameRush

ログは [grush-build] で始まり、変えた設定は set <項目>: <前> -> <後> の形で1行ずつ出ます。

• grush-sdk-godot の addons/grush_sdk_build/ もプロジェクトの addons/ へコピーし、Project Settings > Plugins で GameRush SDK Build を有効にする（grush_sdk とは別のプラグイン）
• Project > Tools > GameRush: 書き出し設定を確認 で、いまの設定とおすすめの値を比べて適用できる
• Project > Tools > GameRush: 推奨設定で書き出す で、「GameRush Web」プリセットを作って書き出す。出力は index.html / index.js / index.wasm / index.pck の名前になるので、改名せずにそのまま上げられる
• Godot 4.3 以降と、Web の書き出しテンプレートが要る
• Export の画面を開いたままだと新しいプリセットが見えないので、開き直す

godot --headless --path . \
  --script res://addons/grush_sdk_build/grush_build_cli.gd \
  -- --output build/gamerush

--no-mobile-textures を付けるとスマホ向けのテクスチャ圧縮（ETC2 / ASTC）を入れません。--preset-only を付けるとプリセットを書くだけで書き出しはしません。