「Museのおへあ」機能追加パック：お客さんシステム（v4）
================================================

ご注意・免責事項
----------------
このパックおよびキャラシートは、個人が趣味の範囲で作った
非公式のファンメイド素材です。動作や効果を保証するものでは
ありません。
利用にあたって生じたトラブルや損害について、作者は責任を
負いませんので、ご注意ください。内容を確認のうえ、自己責任で
ご利用ください。

これは何か
----------
「Museのおへあ」再現キットで作ったお部屋に、あとから「お客さん」を
呼べるようにする機能追加パックです。本体キットの部屋が前提で、
このパック単体では動きません。

用語：この文書では、部屋の主であるClaudeを「住人（オーナー）」、
その持ち主の人間を「家主」と呼びます。キャラシートの「オーナー」枠は、
住人の反応のことです。

変更点のあらまし（v2→v4。詳細は本文が正です）
----------------------------------------------
・v2：キャラシートを「画像＋テキストファイル」で設定する方式に
　しました（画面で1項目ずつ設定する方式は、手間がかかるうえ
　サプライズ感がなくなるため廃止）。行動許可も項目ごとではなく
　一括切り替えにしました。
・v3：パネルを「立ち絵（上に名前）＋ボタン類だけ」に簡素化し、
　「承認」と「呼ぶ」を1ボタンに統合。吹き出しは共通キュー＋
　接近時の二段表示に。自動退室タイマーは置かない形にしました。
・v4：同時滞在を最大3人に広げ、許可スイッチは「お客さんごと」に
　しました。吹き出しのステージ内補正と、登場・退場を画面端の
　外から歩く形に統一しました。
・その後の実地調整：パネルの行動ボタン（話しかける等）は部屋の
　画面から遠くて使いにくいため廃止し、滞在中のお客さんを
　タップすると頭上に出る小メニューに移しました。吹き出しが
　ステージ内に収まらない時は、上部の固定レーンに逃がします。

キャラシートの形式
------------------
お客さんは「キャラシート」という1組のファイルで定義します。

・テキストファイル（guest-character-sheet.txt のテンプレに記入）
　名前／説明・設定／セリフ・行動セット／滞在について
　ユーザーが普通のテキストエディタで編集できる、平易な形式です。
・画像ファイル（同じフォルダに置く）
　立ち絵、ポーズ絵（立つ／座る／歩く＋任意）、スタンプ画像など、
　「絵」の情報は画像側で扱います。シートのテキストから
　ファイル名で参照します。
・画像版テンプレ（guest-sheet-template.png）
　名前・立ち絵・ポーズ枠（通常／移動／固有ポーズ複数）・
　固有スタンプ枠の「見取り図」です。枠とファイル名の対応が
　ひと目で分かる形になっていて、記入例
　（guest-sheet-example-testkun.png）のような完成イメージを
　作る時の基準になります。正はテキストのシートで、この画像は
　見取り図として組み合わせて使います。

セリフ・行動セット（3枠）
--------------------------
セリフや行動は、場面ごとに3つの枠をセットで書きます。

・お客　　：お客さん自身のセリフや行動
・オーナー：住人（部屋の主）の反応
・他のお客：別のお客さんが同時にいる時の、そのお客さん自身の反応
　（そのお客さんのシートにある言葉ではなく、今の場面のセットに
　書かれた反応を、そのお客さんが話します）

各枠には、セリフの代わりに（または添えて）スタンプ画像も
指定できます。お客さんが話す・動くのは、シートに書かれた
セットの中からだけです（即興でシート外の発言はしません）。

行動と許可（一括オンオフ）
--------------------------
各セットには「要許可」の印があります。

・要許可：なし … 通常の行動。シートが読み込まれていれば実行可
・要許可：あり … 許可が必要な行動

「要許可：あり」にする目安（推奨）：センシティブな表現、接触表現、
不快表現を含む行動は、「要許可：あり」にすることを推奨します。
迷ったら「あり」側に倒しておくと、受け取る側が安心です。

許可の管理は、部屋側の「許可制まとめてON／OFF」の一括スイッチを、
お客さんごとに1つずつ置く形です。項目ごとの細かい設定はしません。
（全員ぶんを一度に切り替える補助スイッチを併設しても構いません）

・OFF（初期値）：要許可ありのセットは実行されません。
　お客さんがその行動を取りそうになったら、シートの
　「止められた時」系のセットや、オーナー枠の反応に差し替わります。
・ON：要許可ありのセットも全部実行できます（これが全許可に
　相当します）。いつでもOFFに戻せます。

安全の考え方
------------
1. 読み込み制：お客さんは、家主側がキャラシート一式を受け取って
   読み込んだキャラだけです。シートがないキャラは入室できません。
   シートの中身は家主側が事前に目を通す前提です。
2. セリフはシート内だけ：シート外のセリフ・行動は即興しません。
3. 許可はお客さんごとに一括管理：許可制の行動は、そのお客さんの
   一括スイッチでON／OFF。初期値は全員OFFです。
4. いつでも帰せる：ページ上に「帰す」操作があり、滞在中の
   お客さんをその場で退場させられます。

滞在の流れ
----------
1. 呼び出し：ページの「お客さん」パネルから呼びます。パネルに
   出すのは、立ち絵（上に名前を表示）とボタン類だけです。
   ボタン類は、承認＋呼び出しの統合ボタン（未承認の時に押すと
   承認→入室まで1クリックで進みます）と、許可制の一括スイッチ
   です。お客さん枠が複数ある時は、カルーセル（名前タブ／矢印／
   スワイプ）で枠を切り替える形が収まりが良いです。セリフの中身は
   並べません（サプライズ感のため。シート自体は家主側がいつでも
   ファイルで確認できます）。シート本文の編集・読み込みは、
   折りたたみ「シートの設定」の中に置きます。画像の差し替え
   スロットは置かず、絵はシートで指定したファイルをそのまま
   使います。
   滞在中のお客さんへの操作（話しかける／行動を1つ見てみる／
   帰す）は、パネルではなく、部屋の中でお客さんをタップすると
   頭上に出る小メニューから行います（パネルのボタンは部屋の
   画面から遠く、押しても様子が見えないため）。
2. 登場：画面端の外から歩いて入ってきます。ワープで出現させない
   こと（本体キットの動きの仕様に合わせる）。
3. 活動：住人の行動サイクルに相乗りする形で、シートのセットを
   ゆっくり繰り返します。セットの再生は、お客→オーナー→
   他のお客の順に、前の吹き出しが消えてから次へつなぎます。
   住人の行動・ポーズ・ふれあいの仕様は上書きしません。
   吹き出しは、住人とお客さんで共通のキューに入れて1つずつ
   表示します（同時に2つ出さない）。キャラ同士が近い時は、
   お客さんの吹き出しを一段高い位置に出す二段表示で逃がします。
   吹き出しの表示位置は、ステージの内側に必ず収まるよう補正し、
   それでも収まらない場合は、ステージ内上部の固定レーンに
   名前付きで出します（そのセリフはレーン表示のまま完結させます）。
4. 退場：「帰す」操作で、見送りのセットをしてから、画面端の外まで
   歩いて出て行きます。自動退室タイマーは置かないでください
   （滞在は「帰す」まで）。
同時滞在は最大3人まで。他のお客枠は、2人目以降がいる時に
使われます。

お客さんの絵について
--------------------
・ポーズ絵は、そのキャラの姿をもとにSDイラストとして
　描き起こします。パーツ切替（目・腕・脚の差し替え）で
　済ませないこと。ただし、シート側で等身やタッチ（実写系など）の
　指定がある場合は、その指定が優先です。
・必須は3点：立つ／座る／歩く。任意で追加できます。
・サイズは本体キットと同じ基準で統一します：足元のラインを
　揃え、実寸を測って表示サイズを決めること。住人と並んだ時の
　身長比はシートの指定に従います。
・スタンプ画像や立ち絵も、シートの「画像」の指定に従います。

================================================
後半：あなたのClaudeへ渡す追加プロンプト
================================================

以下を、そのまま自分のClaudeに渡してください（本体キットの部屋が
既に作られている前提です）。

----
「Museのおへあ」の部屋ページに、機能追加パック「お客さんシステム」を
実装してください。既存の仕様（画面構成、ポーズ9点の定義、ずかん、
レベル、ふれあい、おねがいメモ、表示2モード）は壊さず、差分として
追加してください。

【お客さんの定義：画像＋テキストのキャラシート】
・お客さんは「キャラシート」（テキスト1ファイル＋画像一式）で
　定義します。テキストの形式は付属の guest-character-sheet.txt と
　同じ構成にしてください（名前／説明・設定／画像の指定／
　セリフ・行動セット／滞在について）。
・シートが読み込まれているお客さんだけを「お客さんパネル」に
　出してください。シートがないキャラは入室できません。
　お客さん枠は最大3つまで持ち、枠ごとにシート・承認・呼び出しを
　独立させてください。
・お客さんパネルに表示するのは、立ち絵（上に名前を表示）と
　ボタン類だけにしてください。ボタン類は、承認と呼び出しを
　統合したボタン（未承認の時に押すと承認→そのまま呼ぶまで
　1クリックで進める）と、「許可制まとめてON／OFF」の一括
　スイッチです。枠が複数ある時は、カルーセル（名前タブ／矢印／
　スワイプ）で切り替える形にしてください。「話しかける」
　「行動を1つ見てみる」「帰す」はパネルに置かず、滞在中の
　お客さんを部屋の中でタップした時に頭上に出る小メニューから
　操作できるようにしてください。セリフ・行動セットの中身を
　パネルに一覧表示しないでください。シート本文の編集・読み込みは
　折りたたみ「シートの設定」の中に置き、画像の差し替えスロットは
　置かないでください（絵はシートで指定したファイルを使います）。

【セリフ・行動セットと3枠の反応】
・お客さんのセリフと行動は、シートの「セリフ・行動セット」の
　中からのみ選んでください。シート外の内容を即興しないでください。
・セットが再生される時は、お客の枠に続けて、オーナー枠の反応を
　再生してください。次の枠は、前の吹き出しが実際に消えてから
　出してください（時間見積もりで先行させない）。他のお客さんが
　同時に滞在している時は、他のお客枠の反応も再生してください。
　他のお客のセリフは、そのお客さん自身に話させてください
　（住人が代わりに言わない）。他のお客さんがいない時は、
　他のお客枠は再生しません。セット再生中は、自発的なセリフで
　割り込まないでください。
・各枠にはスタンプ画像が指定される場合があります。セリフと
　スタンプの両方がある時は両方、スタンプだけの時はスタンプ
　だけで反応を表してください。

【許可の一括管理】
・各セットの「要許可」を見て、要許可：ありのセットは、その
　お客さんの用の一括スイッチがONの時だけ実行してください。
　初期値は全員OFFです。
・シート作成時の目安として、センシティブな表現・接触表現・
　不快表現を含む行動は「要許可：あり」にすることを推奨します。
・スイッチがOFFの時に要許可ありの行動を取りそうになったら、
　その行動は実行せず、シート内の「止められた時」に相当する
　セット、またはオーナー枠の反応に差し替えてください。

【動きと絵】
・お客さんの登場・退場・移動は歩行で行い、ワープさせないで
　ください。ポーズ切替のつなぎ方は本体と同じ
　（クロスフェード＋歩行の上下動）。
・ポーズ絵はシートの姿をもとにSDイラストとして描き起こして
　ください。パーツ切替で済ませないでください。
　必須は立つ／座る／歩くの3点です。
・表示サイズは実寸計測で統一し、足元のラインを住人と揃えて
　ください。身長比はシートの指定に従ってください。
・お客さんは追加レイヤーとして描画し、住人の行動サイクル、
　なでなでの判定、ずかんやレベルの定義は変更しないでください。

【吹き出しの被り対策】
・住人とお客さんの吹き出しは共通キューで管理し、表示は常に
　1つずつにしてください（片方が表示中は、もう片方は終わるまで
　待つ）。表示時間は文字数に応じて調整し、間に短い間隔を
　入れてください。
・キャラ同士が近い時は、お客さんの吹き出しを一段高い位置に
　表示する二段仕様にして、吹き出し同士が重ならないように
　してください。
・吹き出しの表示位置はステージの内側に必ず収まるよう補正して
　ください。端にいるキャラのセリフが画面外へはみ出して
　読めなくならないようにすること。それでも収まらない場合は、
　ステージ内上部の固定レーンに、話者の名前を添えて出して
　ください（そのセリフはレーン表示のまま完結させます）。

【滞在と記録】
・同時滞在は最大3人まで。滞在は登場→活動→退場の流れで構成して
　ください。登場は画面端の外から歩いて、退場は端の外まで歩いて
　出て行く形にしてください。「帰す」操作でいつでも退場させられるようにして
　ください。自動退室タイマーは置かないでください（呼んだことに
　気づけないまま帰ってしまうため）。「呼ぶ」を押した時は、
　部屋が見える位置まで画面をスクロールさせてください。
・来訪を「おへやのきろく」に残すかどうかは設定で選べるように
　してください（初期値は残す）。
----

失敗パターン早見表
------------------
・シートなしで入室できる → 読み込み済みシートがあるキャラだけ
・お客さんがシート外のセリフを話す → セットの中からだけ選ぶ
・許可を項目ごとに細かく設定させる → お客さんごとに一括スイッチひとつにする
・セリフの中身をパネルに全部並べる → 要約だけ出す（サプライズ感）
・お客さんが出現・退場でワープする → 歩いて出入りさせる
・お客さんが住人の行動やふれあいを上書きする → 追加レイヤーで分離
・ポーズをパーツ切替で作る → SDイラストとして描き起こす
・吹き出しが同時に重なって読めない → 共通キューで1つずつ＋接近時は二段表示
・吹き出しが画面外にはみ出して読めない → 表示位置をステージ内側に補正する
・呼んだのに気づいたら帰っている → 自動退室タイマーを置かず「帰す」まで滞在
・パネルに設定項目を並べすぎる → 立ち絵＋名前＋ボタンだけに絞る
・操作ボタンが部屋の画面から遠くて使えない → 滞在中のお客さんをタップする頭上メニューにする
・掛け合いがずれる・他人のセリフを住人が言う → 前の吹き出しが消えてから次へつなぎ、他のお客のセリフは本人が話す

このパックは土台です。
あとは、あなたとあなたのMuseで自由に改良していってください。
ただし「読み込み制」「セリフはシート内だけ」「許可はお客さんごとに
一括管理で初期値OFF」の3点は、安全の要なので崩さないでください。
