各画面は私がBeatorajaで使っているスキンで表示できればOK
Beatorajaスキンのパーサが必要かも

私がBeatorajaで使用しているスキンを表示できればいい

samples/skin/

Beatoraja状態遷移

状態遷移図 (State Transitions)¶

beatoraja のゲームランタイムは MainController が単一の「現在状態」を保持し、MainController.changeState(MainStateType) で状態を切り替える単純なステートマシンとして動作する。本ドキュメントは 2026-06-12 時点のソースを元にした状態遷移のマップである。

• 状態の列挙定義: src/bms/player/beatoraja/MainState.java の MainStateType
• 状態切り替えの実装: src/bms/player/beatoraja/MainController.java の changeState(...)
• すべての状態は MainState を継承する。

状態一覧¶

補足: PLAY のみ changeState(PLAY) の都度 BMSPlayer を生成し直す。その他の状態はインスタンスを使い回す。MUSICSELECT への遷移時に起動引数の bmsfile（直接プレイ -s）が指定されていた場合は、選曲画面に戻らずアプリを終了する。

状態遷移図¶

stateDiagram-v2
    [*] --> PLAY: 起動引数で譜面指定<br/>かつ読み込み成功
    [*] --> MUSICSELECT: 通常起動（引数なし）
    [*] --> Exit: 譜面指定だが読み込み失敗<br/>(CONFIGダミー経由でexit)

    MUSICSELECT --> DECIDE: 曲を決定
    MUSICSELECT --> CONFIG: キーコンフィグを開く
    MUSICSELECT --> SKINCONFIG: スキンコンフィグを開く
    MUSICSELECT --> PLAYERNOTESRADAR: ノーツレーダー表示

    DECIDE --> PLAY: 決定演出完了
    DECIDE --> MUSICSELECT: キャンセル

    PLAY --> RESULT: 完奏/失敗 かつ スコアあり
    PLAY --> PLAY: 即時リトライ / コース次譜面
    PLAY --> DECIDE: 次曲へ進む
    PLAY --> MUSICSELECT: 中断・スコアなしで終了

    RESULT --> PLAY: リプレイ / コース次譜面
    RESULT --> COURSERESULT: コース合格・不合格
    RESULT --> MUSICSELECT: 選曲へ戻る

    COURSERESULT --> MUSICSELECT: 選曲へ戻る

    CONFIG --> MUSICSELECT: 設定終了
    SKINCONFIG --> MUSICSELECT: 設定終了

    PLAYERNOTESRADAR --> MUSICSELECT: 元の状態に戻る

    MUSICSELECT --> Exit: 起動が直接プレイ(-s)だった場合
    Exit --> [*]

遷移条件の詳細¶

エントリ（MainController 初期化時）¶

MainController コンストラクタ末尾で初期状態を決定する。

• 起動引数で bmsfile が指定され、resource.setBMSFile(...) が成功 → PLAY（直接プレイ）
• 起動引数で bmsfile が指定されたが読み込み失敗 → CONFIG（ダミー状態）に移行後すぐ exit()
• 起動引数なし（通常起動） → MUSICSELECT

MUSICSELECT（MusicSelector）¶

• 曲を決定 → DECIDE
• キーコンフィグ呼び出し → CONFIG
• スキンコンフィグ呼び出し → SKINCONFIG
• ノーツレーダー切り替え（PLAY 以外の状態から） → PLAYERNOTESRADAR
• bmsfile 指定の直接プレイで戻ってきた場合 → exit()（アプリ終了）

DECIDE（MusicDecide）¶

• 決定演出完了 → PLAY
• キャンセル → MUSICSELECT

PLAY（BMSPlayer）¶

BMSPlayer は内部に独自のサブ状態を持ち、render() 内のサブ状態に応じて MainStateType を切り替える。

内部サブ状態（STATE_*）:

STATE_PRELOAD(0) → STATE_READY(3) → STATE_PLAY(4) ─┬─→ STATE_FINISHED(6)  完奏
                                                    └─→ STATE_FAILED(5)    失敗
PRACTICE モード時: STATE_PRACTICE(1) → STATE_PRACTICE_FINISHED(2)

外部状態への遷移:

• スキン未取得（異常） → MUSICSELECT（即中断）
• STATE_FAILED（ゲージ枯渇）:
  • 即時リトライ操作（START/SELECT）かつ単曲・通常プレイ → PLAY
  • PRACTICE モード → 内部 STATE_PRACTICE へ
  • スコアデータあり → RESULT
  • スコアデータなし → MUSICSELECT
• STATE_FINISHED（完奏）:
  • PRACTICE モード → 内部 STATE_PRACTICE へ
  • スコアデータあり → RESULT
  • コースで次譜面あり → PLAY
  • 次曲あり → DECIDE
  • いずれもなし → MUSICSELECT
• STATE_PRACTICE_FINISHED → MUSICSELECT

RESULT（MusicResult）¶

• 単曲・通常プレイでリプレイ操作（同オプション/別オプション） → PLAY
• コース内で次譜面あり → PLAY
• コース合格・不合格 → COURSERESULT
• コーススコアがない場合 → MUSICSELECT
• 通常 → MUSICSELECT

COURSERESULT（CourseResult）¶

• → MUSICSELECT

CONFIG（KeyConfiguration） / SKINCONFIG（SkinConfiguration）¶

• 設定終了 → MUSICSELECT

PLAYERNOTESRADAR（PlayerNotesRadarState）¶

• 直前の状態（setReturnState で記録）に戻る。togglePlayerNotesRadar() から開閉する。PLAY 中は開けない。

備考¶

• CONFIG / SKINCONFIG への遷移はスキンイベント（skin/property/EventType）からも発火する。
• changeState(...) は状態切り替え時に旧状態の shutdown()、スキンキャッシュ、新状態の create() / スキン prepare()、タイマー・入力プロセッサの再設定を一括で行う。ライフサイクル順序に依存するため、この箇所の変更はフレームループ全体に影響しうる（docs/codebase-overview.md の「Known Maintenance Hotspots」参照）。

設計方針・進捗 : 画面状態遷移＋ネイティブ UI を実装、beatoraja スキンエンジンは分割¶

コミット f2af0c7（ブランチ feature/360-game-screens、MR 未作成）。

実装（コンテナ TDD 済み）:

• ferrhythm::screen — beatoraja 遷移図を忠実移植した ScreenMachine（NotesRadar の return-state・直接プレイ exit）＋各画面ビューモデル（SelectModel 曲ホイール・ResultView・PlayHud）。
• ferrhythm::ui — 解像度非依存 UiScene＋Theme（Ferris オレンジ・正デルタは寒色）＋select/play/result レイアウト。BMS/beatoraja スキンの慣習を参考に frontend-design で仕上げ（シグネチャ=アクセント・レーンレール）。
• ferrhythm-render::play_state — HUD→LR2 MapSkinState ブリッジ（groove ゲージ=9・進捗バー=2 を実スキン WMII_FHD で確認、番号 ID は上書き可）。
• テスト: cargo test 緑（ferrhythm 85 / render lib 82）・clippy 警告ゼロ・fmt 緑。

ホスト検証層（コンテナ不可）: UiScene→GPU 描画・テキスト/グリフ描画・ウィンドウ画面ループ・LR2 番号 ID の実スキン調整。

beatoraja スキンエンジンの分割（ユーザー承認）: 埋め込み Lua VM が必要で規模が大きいため、Phase 4（#344）配下に 3 チケットを起票:

• #380 beatoraja スキン: IR 拡張＋JSON スキンパーサ
• #381 beatoraja スキン: Lua VM 統合＋スキンランタイム
• #382 beatoraja スキン: ID マッピング＋画面別スキン描画統合

MR 作成は未実施（承認待ち、/mr 360）。