リファレンス（全項目辞典）

省略した項目は、テンプレート付属の文言（index.htmlの静的な文言）がそのまま使われます。

画像をアイコンにしたい場合は assets.images に同じ id の画像を登録してください（iconの値は無視され、画像が優先されます）。

画像をどの「名前」で探すか（優先順位）：シーンのobjectsに置いたオブジェクトは、obj.itemIdがあればそれを、無ければobj.idを「名前」としてassets.imagesを探します（itemId || id）。decorative: trueのオブジェクトも同じ仕組みで、itemIdは実在する所持品である必要はなく、単に画像を探すためのキーとして使われます。シーンの背景画像はbgAssetIdに書いた文字列が「名前」になります。所持品欄のアイコンは、その所持品自身のidで探します。

assets.soundsで使える名前（この5つ以外は登録しても再生されません）

画像・音声とも、登録しなければ自動でシンプルな図形・合成音にフォールバックします。同じファイル名で中身だけ更新した場合のキャッシュの扱いは、説明書の「11. 公開前のチェックと困ったとき」の「キャッシュについて」を参照してください。

decorative: trueの自作例（壁掛けの絵を見た目だけ配置）：

{ id: "deco-picture", type: "decoration", decorative: true,  itemId: "picture",← assets.images から画像を探すためだけの名前（所持品である必要はない）  x: 400, y: 120, w: 80, h: 100 },

invisible: trueの自作例（背景画像にすでに描き込まれた扉に当たり判定だけ追加）：

{ id: "door-hitbox", type: "exit", invisible: true,  x: 450, y: 250, w: 150, h: 300, requiresItem: "key" },

pickup（拾えるアイテム）

exit（出口・ドア）

requiresItems（自作例。複数アイテムを選択操作なしで一括判定）：

{ id: "door", type: "exit", shape: "door", x: 450, y: 250, w: 150, h: 300,  requiresItems: ["key", "map"], hintLocked: "何かが足りないようだ。" },

zoom（ズームイン）

passcode（暗証番号）

examine（調べるだけ）

danger（即ゲームオーバーの罠）

shape: "trap"にすると、警告色で点滅する専用の見た目になります。スマートフォンでは自動的に「1回目のタップで警告表示、2回目のタップで実行」になります（設定不要）。

同じ座標に「前」「後」の2オブジェクトを重ね、hideOnFlagとrequiresFlagを同じフラグ名で対応させるのが基本形です（説明書の「8. 調べると何かが出てくる仕掛けを作る」参照）。

選択中のアイテムに応じた個別リアクション。requiresItemと違い、不正解アイテムにも専用の反応を返せます。pickup/exit/examineなどどのタイプにも付けられます。

使わない場合はendingsごと省略できます。省略した場合、またはexitのdefaultEndingが指すキーがendingsの中に無い場合は、クリア画面はui.clearの内容（省略時はテンプレート付属の文言）がそのまま使われます。endingsが存在し該当キーが見つかった場合は、そのtitle/messageがui.clear.heading/descriptionを上書きします（eyebrow/buttonはそのまま）。

meta.debug: trueで表示されるDEBUGパネルの「配置編集」ボタンから使えます。

コピーした内容は、config.jsの該当シーンのobjects: [ ... ]を丸ごと置き換える形で貼り付けます。コピーする前にページを再読み込みすると、動かした内容は消えます（ブラウザのメモリ上だけで編集しており、保存は手動のコピー操作が必要です）。

画像を用意しなくても動きます。何も指定しなければ、自動でシンプルな図形が代わりに表示されます。

ここから先は、より作り込んだシナリオ向けの機能です。例は第2弾ゲーム「おでかけ！わすれもの大作戦」のコードの書き方を引用しています（画像・音声ファイルは含みません）。

GAME_CONFIG.inventoryCapacity（所持品の上限と入れ替え）

GAME_CONFIG直下に他の項目（metaやitems）と同じように1行追加します。

const GAME_CONFIG = {  meta: { /* ... */ },  inventoryCapacity: 3,← これを超える pickup はブロックされる  items: { /* ... */ },};

上限に達した状態でitemIdを持つpickupをクリックすると拾えなくなり、obj.hintFull（省略時は既定文言）が表示されます。かわりに、所持品欄の各スロットに「手放す」バッジが表示され、クリックすると一度拾ったアイテムを元の場所に戻せます（入れ替え）。

GAME_CONFIG.routes / obj.scoreByRoute（複数ルート・達成度に応じた結末）

プレイヤーが選んだルートの必須アイテムを何個持っているかを数え、持っている数に応じて結末を変える仕組みです。exitタイプのrequiresItems（全部揃っているかの二択）とは別物で、互いに影響しません。

const GAME_CONFIG = {  meta: { /* ... */ },  routes: {← GAME_CONFIG直下に追加    fishing: {      flag: "routeFishing",           // zoomオブジェクトのsetFlagと対応させる      label: "釣り",      requiredItems: ["fishing-rod", "bait", "bucket"],      bonusFlag: "foundBonusFishing", // 隠しアイテムのフラグ（省略可）    },  },};

{  id: "door", type: "exit", scoreByRoute: true,  hintWrong: "持ち物が違うか、足りないみたいだ。",      // 0〜1個の時（ゲームオーバーにはならない）  hintSuccess: "よし、行ってきます！",  perfectEnding: "perfectEnd", // 全部揃っている時（省略時は"perfectEnd"）  okEnding: "okEnd",           // 一部だけの時（省略時は"okEnd"）}

route.bonusFlag（省略可）を使うと、別枠の隠しアイテムを見つけていた場合に、okEnding止まりの評価をperfectEndingへ1段階格上げできます。