個人開発 » Ferrhythm

実装に着手しました。

• ブランチ: feature/365-score
• 対応方針: 判定結果(Judgement)を入力に体力ゲージ・スコア・クリアランプを導出する非依存純ロジック新クレート ferrhythm-score（依存=core/timing）をコンテナTDDで実装。

確定した仕様（音ゲーの肝・ユーザー確定 2026-06-21）¶

• ゲージ値＝LR2準拠（beatoraja _LR2 定数）／TOTALの効き方＝beatoraja モディファイア方式。判定配列順 [PG, GR, GD, BD, PR(見逃しPOOR), MS(空POOR)]、a=TOTAL/N。
• ゲージ6種: ASSIST EASY(border60) / EASY(80) / NORMAL(80) は groove回復型(開始20/床2/上限100)、HARD / EX-HARD / HAZARD は survival即死型(開始100/床0/上限100)。
  • 増減: AEASY=EASY [1.2a,1.2a,0.6a,−3.2,−4.8,−1.6] ／ NORMAL [1.0a,1.0a,0.5a,−4,−6,−2] ／ HARD [0.1,0.1,0.05,−6,−10,−2] guts{{30,0.6}} ／ EX-HARD [0.1,0.1,0.05,−12,−20,−2] guts無し ／ HAZARD [0.15,0.06,0,−100,−100,−10]。
• 確定4論点: (1)HARD低ゲージ補正=コード値 30%/0%（<30%で減少×0.6・0%失敗、調整可能フィールド化）。(2)EX-HARD=HARDのBAD/PRを2倍・空MS据え置き・guts無し。(3)低TOTAL補正=beatoraja方式(回復減)：grooveは回復×TOTAL/N、HARD/EX-HARDは回復のみ低TOTALで逓減（LIMIT_INCREMENT、TOTAL≤160で回復0）、HAZARDは固定。ダメージは常にTOTAL非依存（LR2のダメージ増 MODIFY_DAMAGE は不採用）。(4)段位ゲージ=値表(CLASS/EXCLASS/EXHARDCLASS)だけ定義・コース連結はスコープ外。
• デフォルト#TOTAL（譜面省略時）= beatoraja式 max(260, 7.605·N/(0.01·N+6.5))（24Kのみ300）。
• スコア: EX-SCORE(PG=2/GR=1)、達成率%=EX/(N×2)×100、ランク=IIDX式 MAX+9段（MAX/AAA≥8/9/AA≥7/9/A≥6/9/B≥5/9/C≥4/9/D≥3/9/E≥2/9/F）。コンボ継続=PG/GR/GD・切断=BAD/見逃しPOOR・空POOR不変。
• クリアランプ: NoPlay<Failed<AssistEasy<Easy<Clear<Hard<ExHard<FullCombo<Perfect<Max（ゲージ種別ランプとコンボ品質ランプの高い方）。

出典: beatoraja OSS（GaugeProperty.java/GrooveGauge.java/BMSPlayerRule.java）＋コミュニティ資料、独立調査5本が同一値に収束。実装は Codex 委譲（source-only）、Claude がレビュー・ビルド・テストを担当。

対応が完了しました。

概要¶

判定結果（Judgement）を入力に体力ゲージ・EX-スコア・クリアランプ/ランクを導出する非依存純ロジッククレート ferrhythm-score（依存=core/timing）を追加。#TOTAL・ノート数は入力として受け取り疑結合。コンテナTDDで確定。

変更点¶

• gauge: 6種のプレイゲージ（AssistEasy/Easy/Normal=groove回復型、Hard/ExHard/Hazard=survival即死型）＋段位 Class/ExClass/ExHardClass の値表のみ定義（コース連結はスコープ外）。ゲージ値=LR2準拠・TOTALの効き方=beatoraja方式のハイブリッド。回復は groove で TOTAL/N、Hard/ExHard は LimitIncrement（TOTAL≤160で回復0）、その他固定。ダメージは常にTOTAL非依存（MODIFY_DAMAGE不採用）。HARD補正 30%/×0.6・0%で失敗ラッチ。default_total は beatoraja式 max(260, 7.605N/(0.01N+6.5))。
• score: EX-SCORE(PG=2/GR=1)、達成率%、IIDX式 MAX+9段ランク、コンボ/最大コンボ、各判定カウント、空POORカウンタ。
• lamp: クリアランプ導出。ゲージのクリア可否でゲートし、FC品質（FullCombo/Perfect/Max）はクリア済みランプのみ引き上げる。
• optional serde feature。
• 変更ファイル: crates/ferrhythm-score/（Cargo.toml/src/{lib,error,gauge,score,lamp}.rs）・Cargo.lock。計7ファイル。

テスト¶

• cargo test -p ferrhythm-score : 成功（28）／--features serde : 成功（29）
• cargo test --workspace : 成功（全クレート緑・リグレッションなし）
• cargo clippy --workspace --all-targets : 成功（警告0）／cargo fmt --all -- --check : 成功

関連 MR¶

• !6 (feature/365-score → develop) マージ済み