参加からゲーム開始まで
player join
→
loadOrCreate
→
startLobby
→
decideModeAndStart
→
prepThenStart
→
countdownThenStart
→
startGame
周辺
→
ArenaService
→
resource / chart load
開始しない、ロビーから進まない、譜面が見つからない、といった症状はこの列で止まっている位置を見るのが近道です。
リズムゲーム / ミニゲーム実行サブシステム
ミニゲーム群の中でも特に複雑な Rhythm4Key を軸に、アリーナ読み込みから入力ジャッジ、スコア反映、視覚演出、終了掃除までの流れを整理しています。
このページは手書き密度を上げたサブシステム解説です。 クラス単体の一覧では見えにくい、モジュール横断の処理遷移を図と文章で読めるようにしています。
読むときの姿勢
- まず図で境界を把握する
- 次に関連クラスの章立て解説へ降りる
- 最後にメソッド詳細で個別実装を確認する
サブシステム解説
このページの主役
主役は Rhythm4Key です。セッション管理、譜面、入力バッファ、非同期ジャッジ、盤面描画、スコア反映、終了掃除までが一クラスに集まっています。周辺のアリーナ構築は ArenaService などが支えます。
他ミニゲームとの関係
Rhythm4Key は特に巨大ですが、join/leave、arena 読み込み、終了掃除のパターンは他ミニゲームとも共有します。その意味でミニゲーム基盤を理解する入口にもなります。
注意点
入力補助と非同期判定が混ざるため、Minecraft のメインスレッド上でやる処理とバックグラウンドへ逃がせる処理を分けて読むことが重要です。
モジュール横断の処理遷移図
入力から判定・加点まで
keyboard / packet / hotbar
→
queueInputPulse
→
processBufferedInputs
→
chooseBufferedCandidate
→
scheduleAsyncJudge
→
applyPendingJudgments
→
judgeAndReport → addScore
補助
→
Rhythm4KeyProtocolInputBridge
→
same-lane assist
→
visual effect
ズレ吸収・同時押し・長押し補助は pulse 化の前後に分散しています。体感調整を行うときは 1 箇所だけでなくバッファ定数群も一緒に見ます。
終了と後片付け
finishSession
→
removeTrackEntities
→
removeJudgeVisuals
→
clearSprintSuppression
→
snapshot cleanup
→
shutdownAllSessions
このゲームは視覚オブジェクトと移動抑制が残りやすいため、終了時の掃除が特に重要です。再ログイン後までおかしい場合はここを最優先で確認します。
変更時の注意点
- Bukkit オブジェクトを async judge 側へ持ち込まないのが最重要です。非同期で安全なのは計算と候補絞り込みの一部だけです。
- 入力体感は複数定数の合成なので、INPUT_BUFFER_MS だけ触るような変更は副作用が出やすいです。
- 譜面自動生成と sidecar / osu import はファイル配置に依存します。既存アリーナ資産を壊さない前提で変更する必要があります。