roblox-game-ux

Roblox ゲームの UX

UX の原則

• プレイヤーを 10～30 秒以内にゲームの中心となるアクションに導きます。
• 説明文を並べるのではなく、目標マーカーや状況に応じたプロンプトを使い、プレイしながら学べるようにします。
• 最初の画面はメニューや説明ではなく、プレイに集中させます。
• 報酬は理解しやすいようにはっきり示しつつ、勢いを保てるよう短く提示します。
• まずスマートフォン画面向けに設計し、その後デスクトップとタブレットに対応させます。

モバイル優先の操作

• タッチ領域を大きくし、十分な間隔を設けます。
• ゲーム全体が精密なドラッグ操作を中心に設計されている場合を除き、精密なドラッグを必要とする操作は避けます。
• 有用な場面では、自動ターゲット、エイムアシスト、スナップ、または簡略化したアクションを追加します。
• 重要なボタンは画面端やシステムジェスチャー領域から離して配置します。
• HUD のテキストは小さな画面でも読みやすくし、重要な情報は親指で隠れやすい領域に置かないようにします。

HUD とメニュー

• 現在の目標、通貨、進行状況、体力／エネルギー、次の報酬を表示します。
• 最初のセッションでは、詳細なメニューを任意で開けるようにします。
• 分かりやすいアイコンを使い、ボタンの配置に一貫性を持たせます。
• ゲームプレイのループ中に、進行バーや収集メーターが見えるようにします。
• 特に最初の 5 分間は、中心となるアクションを中断するポップアップを避けます。

オンボーディングの流れ

最初のセッションでは、次の順序を推奨します。

1. 最初に操作できる対象または目標のほうを向いてスポーンさせます。
2. 1 つのアクションを促します。
3. すぐにフィードバックと報酬を与えます。
4. 次の短い目標を表示します。
5. プレイヤーがすでに行動した後で、ソーシャル要素や進行状況の背景を提示します。

UX レビューの出力

Roblox の UX をレビューするときは、次の項目を報告します。

• 最初のアクションまでの時間。
• ゲームプレイ開始前の摩擦点。
• モバイル操作上のリスク。
• 不足している進行状況の手がかり。
• ソーシャル要素の可視性に関する不足。
• マネタイズによる中断。
• リテンションへの影響度順に並べた優先修正項目。

UI の構築前にデザインする

重要な UI 画面については、roblox-ui-implementation が構築する前に、UI デザイン成果物を作成して承認を得ます。これはビジュアル面での合意事項であり、構築中に Claude がレイアウト、状態、モバイルでの挙動をその場で決めてしまうのを防ぎます。Roblox の UI は Studio で構築するため、成果物は HTML モックアップではなく、Markdown のデザイン概要（必要に応じて参考画像やスクリーンショットを含む）とします。

design/features/<feature-slug>/design.md に作成します（全体で使うパターンは design/DESIGN.md に記載されています。docs/agents/design.md を参照してください）。概要には次の内容を含める必要があります。

• ユーザーの目的と、対象となる画面／フロー（HUD、ショップ、報酬、メニューなど）。
• モバイル、タブレット、デスクトップそれぞれのレイアウトとレスポンシブな挙動。セーフエリアと親指の操作範囲も含めます。
• 関連するすべての状態：デフォルト、空、読み込み中、エラー、権限／ロック中。
• 操作と文言のルール。
• Status: 行。ユーザーの承認を得るまでは draft、承認後は approved とします。

ユーザーが承認するまでやり取りを重ね、その後 Status: approved に設定します。この成果物が承認されるまでは、UI の作業単位を ready-to-build にすることはできません（roblox-to-issues／roblox-triage 内）。

次のステップ

デザイン概要の承認後、roblox-ui-implementation に渡して構築します。UI がより大きな機能の一部である場合は、roblox-to-issues で作業を分割します。構築した結果は roblox-mobile-playtest と roblox-playtest-qa で検証します。