ペットの投稿方法

始める前に

すべて PicoPixel アプリ内で行います。提出画面へ進むには：

1. app.picopixel.io でアプリを開きます。
2. Google または GitHub アカウントでログインします。ログインしていない場合は、投稿前に案内が表示されます。
3. 左サイドバー下部のアカウントをクリックします。
4. "Your account" を選びます。
5. "Submit Sprite" を開きます。

Submit Sprite 画面には、以下の 2 つの方法が表示されます。

Petdex で提出する

これは推奨される最速の方法です。Petdex は petdex.crafter.run にある外部ペットディレクトリで、ペットを閲覧、作成、ホストできます。各ペットには https://petdex.crafter.run/pets/<pet-id> の形の共有 URL があります。

提出手順：

1. Petdex でペットを見つけるか作成し、その URL をコピーします。
2. Submit Sprite 画面で "Submit via Petdex" を選びます。
3. "Petdex URL" フィールドにペット URL を貼り付けます。
4. 任意の "Notes" フィールドに役立つ情報を追加します。
5. 送信します。

GitHub で提出する

スプライトを自分でホストする場合に使います。Petdex リンクではなく、元ファイルを提供します。

1. スプライトシート画像と対応する sprite.json を公開 GitHub リポジトリに置きます。
2. Submit Sprite 画面で "Submit via GitHub" を選びます。
3. リポジトリ URL（https://github.com/...）を貼り付けます。
4. "Credits / Author" を入力して、作品にクレジットが付くようにします。
5. 任意の "Notes" フィールドに役立つ情報を追加し、送信します。

スプライトシートと sprite.json は特定の形式に従う必要があります。次のセクションで説明します。

独自のペットを作る

既存の Petdex ペットを使うほかに、オリジナルを作ることもできます。OpenAI Codex や AI 画像生成ツールなどの AI ツールは、キャラクタースプライトシートをゼロから作る実用的な方法です。

スプライトシートは、均一なグリッドに並べられた 1 枚の画像（PNG または WebP）で、"atlas" とも呼ばれます。1 行に 1 つのアニメーションを配置し、すべてのフレームを同じサイズにしてください。

sprite.json にはスプライトシートの構成を記述します。主な項目は 2 つです。

• atlas：グリッドのレイアウト：columns、rows、frameWidth、frameHeight。
• states：アニメーションの配列。各状態には id、label、配置されている row、frames 数、任意の durationMs、group、caption があります。

代表的な状態には idle、wave、jump、run-right、run-left、running、waiting、failed、review があります。スプライトには最低 2 つの状態が必要なので、少なくとも idle ともう 1 つの動きを生成してください。

よいワークフローは、同じサイズでフレームを生成し、1 行 1 アニメーションの規則的なグリッドに並べ、sprite.json でグリッドと状態を説明して、Petdex または GitHub から提出することです。

投稿後の流れ

提出後、PicoPixel チームがペットを確認し、必要に応じて追加確認をします。承認されたペットは ペットギャラリー に掲載され、あなたのクレジットが表示されます。そこから、コミュニティの誰でもあなたの作品を見つけて使えます。

次のステップ

• LVGL スプライト、スプライトの状態とフレームの仕組み。
• イベントエディタ、デザインにインタラクションを追加する。
• テンプレートの投稿方法、他の人が出発点にできる PicoPixel デザインを共有する。
• コンテンツの報告方法、ルール違反のペットやテンプレートを報告する。
• ペットギャラリー、コミュニティのペットを見る。