How To Publish

`work.zip` を作って、
投稿して、
そのまま公開する。

このページでは、`scenario.json` の基本、フォルダ構成、ZIP化して投稿する手順、そしてつまずきやすいエラーをまとめて確認できます。

Quick Flow

シナリオを書く
画像や音声を配置する
`scenario.json` を ZIP 直下に置く
`work.zip` を投稿する

1. Folder Structure

まずはこの形で作る

最低限必要なのは、ZIP直下の `scenario.json` と、そこから参照する素材ファイルです。

work.zip
├── scenario.json
├── bg/
│   └── room.png
├── character/
│   └── hero.png
└── audio/
    ├── bgm-theme.mp3
    └── click.ogg

2. Rules

最初に押さえる4つ

`scenario.json` は ZIP 直下に 1つだけ置く
画像や音声のパスは `scenario.json` と完全一致させる
使える素材は `png`, `jpg`, `jpeg`, `webp`, `mp3`, `wav`, `ogg`
アップロードする `work.zip` は 2MB 以下にする

3. scenario.json

基本はシンプルです

`metadata` に公開用の情報を書き、`config` に初期設定を書き、`scenes` に物語を積みます。まずは最小構成で通してから、画像や音声を足していくのがおすすめです。

{
  "metadata": {
    "title": "はじめての作品",
    "summary": "短いサンプルADVです",
    "rating": "全年齢"
  },
  "config": {
    "start_scene": "opening"
  },
  "scenes": [
    {
      "id": "opening",
      "background": "bg/room.png",
      "bgm": "audio/bgm-theme.mp3",
      "commands": [
        {
          "type": "message",
          "speaker": "主人公",
          "text": "ようこそ、retro-advへ。"
        }
      ]
    }
  ]
}

`scenario.json` の詳細仕様へ

4. Upload Steps

投稿までの流れ

投稿ユーザー登録をする
作品情報を登録する
ローカルで `work.zip` を作る
投稿画面から ZIP をアップロードする
自動検証が通ったらプレビューで確認する
問題なければ公開する

Sample

まずは動く ZIP から試す

最低限のゲームが動く `sample.zip` を用意しています。構成を見ながら触ると、最初の1本をかなり早く作れます。

サンプルZIPをダウンロード

5. Common Errors

よくある詰まり方

`scenario.json は ZIP 直下に 1 つだけ配置してください`

サブフォルダ内に置いているか、2つ以上入っています。

`scenario.json が参照しているファイルが見つかりません`

ファイル名の大文字小文字や拡張子違いを確認してください。

`work.zip は 2MB 以下にしてください`

画像や音声を圧縮し、不要ファイルを外してください。

Start

作りながら覚えるならここから

サンプル一式を見ながら進めると早いです。まず作品登録を作って、最小構成の ZIP から試すのがおすすめです。

ログイン

`work.zip` を作って、 投稿して、 そのまま公開する。