このガイドはAIが生成したものです。
制作者による十分な内容確認が済んでいないため、記載内容に誤りが含まれている可能性があります。実際の動作と異なる箇所を見つけた場合はご報告ください。
mimipy とは

mimipy は、ブラウザ上で動くかんたんペットゲームを作るためのツールです。用意した画像・音声ファイルを読み込み、HTMLファイルとして書き出すだけで、自分だけのペットゲームが完成します。外部サービスは不要で、すべてブラウザ内で完結します。

サンプル(実際に動きます)
動作確認環境: デスクトップの Mac / Brave(Chrome でも動作)。フォルダ選択にはフォルダ読み込み対応ブラウザが必要です。
操作: マウス・ペンタブレット・タッチに対応しています(書き出したゲームはスマホ・タブレットでもつつく/撫でる/プレゼントの操作ができます)。
クイックスタート

1. フォルダを用意してクリックで選択する

フォルダ構成に従って画像・音声を用意し、全般タブ左側のエリアをクリックしてフォルダを選択します。画像がなくてもオレンジ色のキャラクター(blob)で動作します。

2. プレビューを確認する

読み込んだ素材は即座にプレビューに反映されます。時刻ボタン(朝・夕・夜・自動)で背景の時間帯を切り替えられます。

3. HTMLを書き出す

「HTML書き出し」ボタンを押すとゲームHTMLが生成されます。そのまま公開できます。

自動保存: 作業データはブラウザ内(IndexedDB)に自動保存されます。画像や音声を含む大きなデータも保存できます。
Cmd+S: 手動で保存することもできます(保存できなかった場合はメッセージが出ます)。
バックアップ: 大切な作品は「JSON書き出し」でファイルに保存しておくと安心です。
フォルダ構成

フォルダ名・ファイル名は固定です。大文字・小文字は区別しません。

同名ファイルの注意: 振り分けはファイル名で行うため、別フォルダに同じ名前のファイルがあると衝突します。その場合は最初の1つだけが使われ、画面に警告が出ます。同じ名前を重複させないでください。
/pet/
icon.png ← プレゼントボタン用アイコン(任意)
logo.png ← タイトルロゴ画像(任意・縦54px以内推奨)

default/
stop1.png, stop2.png, stop3.png ← stop1・2が通常、stop3がまばたき
stop.gif ← GIF版(任意・あればPNG連番より優先)
stop.mp3
walk1.png 〜 walk8.png
walk.gif ← GIF版(任意)
walk.mp3
run1.png 〜 run6.png
run.gif ← GIF版(任意)
run.mp3

reaction/
click1.png 〜 click3.png ← クリック驚き
click.gif ← GIF版(任意)
clickafter1.png 〜 clickafter3.png ← クリック後リアクション
clickafter.gif ← GIF版(任意)
click.mp3
drag1.png 〜 drag3.png ← ドラッグ中
drag.gif ← GIF版(任意)
dragafter1.png 〜 dragafter8.png ← ドラッグ後リアクション(最大8枚)
dragafter.gif ← GIF版(任意)
drag.mp3

present/
object.png ← プレゼントのオブジェクト
present1.png 〜 present3.png ← 食べているモーション
present.gif ← GIF版(任意)
present.mp3
afterpresent1.png ← 喜んでいるモーション(1枚)
afterpresent.gif ← GIF版(任意)
afterpresent.mp3

background/
morning.png / evening.png / night.png
bgm.mp3 ← BGM(任意・ループ再生)
画像仕様
ステートファイル名最大枚数備考
止まりstop1〜3.png3枚stop3がまばたき用
歩きwalk1〜8.png8枚
走りrun1〜6.png6枚
クリック驚きclick1〜3.png3枚
クリック後clickafter1〜3.png3枚
ドラッグ中drag1〜3.png3枚
ドラッグ後dragafter1〜8.png8枚
食べるpresent1〜3.png3枚
喜ぶafterpresent1.png1枚

用意した枚数だけでループします。1枚でも動作します。足りない枚数は自動的に繰り返して使われるため、画像の間に空白は入りません。

推奨サイズ: キャラクター 250×250px(透過PNG)/ 背景 1240×768px
GIFアニメ(オプション)

各ステートにGIFアニメを追加することができます。GIFはPNG連番と併用可能です。同じステートにGIFとPNG連番の両方がある場合、GIFが優先して表示されます。

GIFだけで全ステートをまかなうことも、PNG連番をベースにしつつ一部だけGIFにすることもできます。

ステートGIFファイル名備考
止まりstop.gifループGIF推奨
歩きwalk.gifループGIF推奨
走りrun.gifループGIF推奨
クリック驚きclick.gif
クリック後clickafter.gif
ドラッグ中drag.gifループGIF推奨
ドラッグ後dragafter.gif
食べるpresent.gif
喜ぶafterpresent.gif
GIFは透過の扱いがPNGより粗くなる場合があります。輪郭がギザギザになりやすい点に注意してください。
音声ファイル

音声はMP3形式を推奨します。歩き・走り・BGM はループ再生、それ以外は各ステートの開始時に再生されます。

ファイル名配置フォルダ再生タイミング
stop.mp3default/まばたきのとき
walk.mp3default/歩いている間(ループ)
run.mp3default/走っている間(ループ)
click.mp3reaction/クリックされたとき
clickafter.mp3reaction/クリック後リアクションのとき
drag.mp3reaction/ドラッグされたとき
dragafter.mp3reaction/ドラッグ後リアクションのとき
present.mp3present/プレゼントを食べているとき
afterpresent.mp3present/プレゼントをもらって喜んでいるとき
bgm.mp3background/常時(ループ再生)
音量調整: プレビュー上部と書き出したゲームの ⓘ から、BGM と SE(効果音)の音量・ミュートを個別に調整できます。デフォルトは BGM 25 / SE 40 です。
ステート一覧

キャラクターは以下の状態(ステート)を持ちます。それぞれに対応するアニメーションファイルを用意します。

ステート名内容音声
IDLE(止まり)デフォルト状態。まばたきあり。一定時間後に歩きや走りに遷移stop.mp3
WALK(歩き)左右にゆっくり歩くwalk.mp3
RUN(走り)左右に速く走るrun.mp3
CL_SHOCK(クリック驚き)クリックされた直後の驚きモーションclick.mp3
CL_REACT(クリック後)驚きの後のリアクション
DR_PET(ドラッグ中)ドラッグされているとき。体が傾くdrag.mp3
DR_REACT(ドラッグ後)放された後のリアクション
PR_EAT(食べる)プレゼントを食べているモーションpresent.mp3
PR_HAPPY(喜ぶ)プレゼントをもらった後の喜びモーションafterpresent.mp3
プレゼントの渡し方: ゲーム右上のプレゼントアイコンをキャラクターの上にドラッグ&ドロップすると、プレゼントを渡せます。
キーボード操作: Tab でキャラクター/プレゼントボタンを選べます。キャラクターに合わせて Enter でつつく、矢印キーで撫でる、プレゼントボタンで Enter を押すとプレゼントを渡せます。
動きを減らす設定: OS の「視差効果(動き)を減らす」がオンのときは、キャラクターは自動で歩き回らず止まったまま待機します(つつく・撫でるなどの操作には反応します)。
左右の向き

画像はすべて右向きで描いてください。左向きの動きは自動ミラーリング(水平反転)で対応します。

左右非対称のキャラクター(服のロゴ、髪の分け目など)は鏡像が不自然に見える場合があります。左右別画像への対応は将来の機能として予定しています。
HTML書き出し

「HTML書き出し」ボタンを押すと、すべての素材を埋め込んだ単一のHTMLファイルが生成されます。生成されたHTMLはそのままブラウザで開くか、Webサーバーにアップロードして公開できます。外部依存なし・単一ファイル完結です。

色の設定: 「ゲーム情報」内の色設定で、書き出すHTMLの背景色・文字色・サブカラー(リンク色)を指定できます。これらは書き出したゲームの ⓘ モーダルにも反映されます。
JSON保存・読込

右上のアイコンからJSONファイルの書き出し・読み込みができます。画像・音声データを含む作業データ全体を保存します。別のPCやブラウザで作業を続けたいときや、バックアップを取りたいときに使います。

自動保存との違い: 自動保存はブラウザ内(IndexedDB)に保存されるため、ブラウザのデータを消去すると失われます。また保存容量には上限があり、超えると保存できません(設定画面で使用量を確認できます)。JSONに書き出しておくと安全です。
将来の機能(予定)

以下は現時点では未実装ですが、将来的に対応予定の機能です。

機能内容
左右別画像対応現在は自動ミラーリング。左向き専用画像を別途設定できるようにする
リアクション種類の追加クリック・ドラッグ以外のインタラクションを増やす
プレゼント種類の追加複数種類のプレゼントを切り替えられるようにする
寝る・座るモーション長時間放置後などの特殊状態を追加する
時間帯別特殊アイドル夜は眠そうにするなど、時間帯に連動した動きを追加する
書き出しHTMLのスリム化モード別に不要なコードを含まない軽量な書き出しに対応する