Rubbing — 仕様書
単一 HTML で動くジムカーナゲーム「Rubbing」の設計仕様。物理・モード・ゴースト・シード収集・テーマ・アーキテクチャを定める。
Rubbing — 仕様書
0. 概要
Rubbing はブラウザで動く 2D ジムカーナゲーム。単一 HTML として配布でき、file:// からも開ける。ライバルは常に「昨日の自分」。育成要素はなく、上達はプレイヤーの腕のみに帰着する。
- ジャンル: 2D トップダウン・ジムカーナ
- 操作: タッチ(ステアリング・ペダル)/キーボード
- モード:
TIME ATTACKとAI BATTLEの 2 つのみ - テーマ: Paper Kit(明るい紙の上に Material 風の物体が置かれている)
- 配布: 単一 HTML(
bundle/index.html) - 開発: 分割ソース + bundle/split 方式(2026-09-28-html-split-bundle-規約 に従う)
- リンク: rubbing
1. 設計思想
1.1 コアループ
BATTLE ──▶ 未知のシードと遭遇 ──▶ シード登録 ↑ │ │ ▼ │ TIME ATTACK │ │ └── ゴーストが強くなる ◀── PB更新でゴースト保存- BATTLE = 探索。次々と新シードに出会う場。敗北してもシードは登録される。
- TIME ATTACK = 研磨。登録済みシードを、自分のベストゴーストと走って削る場。
- 両モードとも、最終的には「過去の自分」と走る。これが設計の核。
1.2 大原則
| 原則 | 内容 |
|---|---|
| コースは不変、変数は自分だけ | 同じシードの再走でしか上達を実感できない → シードの再走可能性が最重要 |
| リアリティ重視 | ラバーバンド、スリップストリーム、燃料、タイヤ摩耗などの「ごまかし」は入れない |
| 育成禁止 | パラメータ上昇・アンロック車両・スキルツリーは無し |
| 数字で自分を可視化 | ゴースト、デルタ、セクタータイム、メダル |
| 摩擦感覚の重視 | 3 段階の路面 μ と、その視覚言語を明確に |
1.3 捨てるもの(明確に)
- ラバーバンド / スリップストリーム / 燃料 / タイヤ摩耗
- 車両アンロック / スキルツリー / 経験値
- オンラインランキング(オフライン前提)
- 3 モード以上
2. モード
2.1 TIME ATTACK
- 所持シードを一覧から選んで走る。
- ライバルは常に 自分のベストゴースト 1 本。
- PB を更新するとゴーストが差し替わる。
- 画面上部はコース俯瞰(fit view)、下部は追跡視点(chase view)。
2.2 AI BATTLE
- ステージを連続クリアしていく。各ステージが新シード。
- ライバルは以下を優先順に選ぶ:
- そのシードの自分のベストゴースト
- そのシードの敗北ゴースト(未クリア時)
- スキル段階付きボット
- 勝てば次ステージへ、負ければラン終了。敗北時もシードは登録。
- 画面上部はライバル追跡視点、下部は自車追跡視点。
- Bot スキルは
stageIndexに応じて線形に上昇(BOT.skillBase→BOT.skillMax)。
2.3 共通
- カウントダウン 3.2s。カウント中に
throttle > 0.85で PERFECT LAUNCH(1.5s のブースト)。 - パイロン接触で即 MISS(
GAME.hitR+ パイロン半径)。 - ゴールでクリア。TA はメニューへ、Battle は次ステージへ。
- ニアミス(
GAME.nearMissDist未満)でCLOSE表示(タイムには影響しない)。
3. ゴースト・シード
3.1 ゴースト保存
- シードごとに 上位 3 本 を保持(
gk:ghost:v3:{seed})。既定は 1st。 - 敗北ゴーストは別キー(
gk:defeat:v3:{seed})。 - エンコード:
x, y, ang, gatesを 8 byte/サンプルでInt16/Uint8パック → base64。 - サンプルレート 30 Hz(
GHOST.rate)。 - サンプル数は
maxStoredを超えると古いものから捨てる。
3.2 ゴースト表示
- 半透明の車体(
COLORS.ghostCar)+ 点線枠。 - TA では「ベストライン」として点線ガイドも描画。
- TA/Battle どちらでも並走する。
- 描画優先度は自車・ライバルの下、道路の上。
3.3 シード
runSeedからhashSeed(runSeed, stageIndex)で決定論的に生成。- 一度でも走ったシードは
profile.seedOrderに登録され、COLLECTION から再走可能。 - シードの表示は 16 進 8 桁(先頭 6 桁のみ表示)。
4. セクター・デルタ・メダル
4.1 セクター
- 1 コースを
SECTOR.count = 4分割。 - 各境界ゲート通過時にスプリットを計測。
- ゴーストのセクター通過時刻と比較し、
S1 +0.42のように表示(#sector-pop)。 - 表示色: 先行 = 緑(
#4a9e4a)、後退 = 朱(#e85a32)。
4.2 デルタバー
- 画面上部中央に横棒で ±1.5s を可視化(
DELTA.window)。 - 中央 = 同着、左 = 先行(緑)、右 = 後退(朱)。
- 数値は
±X.XXで小さく表示。 - ゴースト未保存の初回は
--を表示。
4.3 メダル
- コース全長から par time を推定し、その倍率で判定。
MEDAL.parSpeed = 15.5m/s を基準速度。- 閾値:
author≤ 0.90 × pargold≤ 1.00 × parsilver≤ 1.10 × parbronze≤ 1.25 × par
- 判定は
stageBests[seed].tとlenから算出。 - クリア時のリザルトと COLLECTION セルに表示。
5. 物理
5.1 車両モデル
自転車モデルを基礎に、荷重移動・スリップ角・タイヤ飽和・ヨー減衰を加えた 3 自由度(x, y, yaw)。
| パラメータ | 値 | 意味 |
|---|---|---|
m | 1100 kg | 車重 |
Iz | 1600 kg·m² | ヨー慣性 |
lf / lr | 1.25 / 1.35 m | 前後輪までの距離 |
Cf / Cr | 40000 / 44000 | 前後コーナリング剛性(低めで穏やかな飽和) |
muF / muR | 1.45 / 1.75 | 前後摩擦係数(リア高めで姿勢安定) |
Pmax | 130 kW | 最高出力 |
FmaxEngine | 11000 N | 駆動力上限 |
FmaxBrake | 15000 N | 制動力上限 |
Cd | 1.05 | 空気抵抗 |
Crr | 32 | 転がり抵抗 |
maxSteer | 0.85 rad | 静止時切れ角 |
steerRate | 10.0 rad/s | 操舵速度 |
maxSteerHighSpeed | 0.40 rad | 高速時切れ角上限 |
speedSensV | 34 m/s | 舵角速度感度 |
yawDamp | 1000 | ヨー減衰 |
yawDampSlip | 0.7 | スリップ時の追加減衰 |
maxYawRate | 4.0 rad/s | ヨーレート上限 |
5.2 積分
- 固定ステップ
PHYS.dt = 1/120 s。 - 1 フレームあたり最大
PHYS.maxSteps = 6ステップ。 - 残った時間はリセット(スパイラル防止)。
5.3 後退時
- 前輪の実効舵角の符号を反転(
revSign)。 - 物理的に正しいヨー応答。
5.4 実装上の注意
- 前輪スリップ角は
vSafe = max(|vx|, 1.8)でゼロ除算を防ぐ。 isFiniteチェックで NaN をゼロにリセット。yawDampSlipは後輪スリップが 0.2 rad を超えると効き始め、0.8 rad で最大。
6. 路面サーフェス
3 段階。コース生成時に seed から基準面を抽選し、1 コース中に 2 ゾーン配置。
| ID | 名前 | μ | 視覚 |
|---|---|---|---|
| 0 | concrete | 1.00 | 紙のまま |
| 1 | steel | 0.58 | 青 rgba(55,110,205,0.55) + 青ハッチ |
| 2 | grip | 1.50 | 橙 rgba(235,120,30,0.52) + 橙ドット |
- 配置: seed で base 面を抽選 → セクション境界で 2 ゾーンを非重複配置。
- 検出:
updateCarSurfaceが最寄りの node のsurfを返す。 - 効果:
SURFACES[car.surf].muをgripMulに乗じてstepCarに渡す。 - 視覚: μ と色を対応させ、直感的に「今どの面にいるか」が分かる。
7. HUD
7.1 レコードバー(上部)
| 項目 | ID | 内容 |
|---|---|---|
| ブランド | — | RUBBING(朱) |
| BEST | rb-best | TA のベストステージ番号(現状は未使用枠) |
| STAGE | rb-stage | 現在のステージ番号(1 始まり) |
| GATE | rb-gate | 通過数 / 総数 |
| TIME | rb-time | 経過秒(0.01 s 単位) |
| SEED | rb-seed | #xxxxxxxx 16 進 |
7.2 中央メッセージ
- カウントダウン、
GO!、CLEAR、MISS、LOST、CLOSE。 - クラス
show/go/fail/clearで色分け。 <small>タグで補足テキスト。
7.3 セクターポップ
#sector-pop。S1 +0.42形式。ahead/behindクラスで色分け。DELTA.popTime = 1.6 s表示後に消える。
7.4 デルタバー
drawDeltaBarが canvas 上に描画。- 半透明のトラック + 中央目盛 + 塗り + 数値。
7.5 ドリフトスコア
- スリップ角 >
driftSlipMinかつ速度 >driftSpeedMinのとき加算。 - 継続時間に応じて倍率(最大 3.0x)。
- 画面右下に表示。
7.6 速度
- 各ビューの左下に
NNN KM/H。
8. テーマ:Paper Kit
8.1 方針
- Neon は採用しない。発光は描かない。
- 明るい紙の上に、Material Design 風の「物として置かれている」要素を描く。
- 道路と背景は似た明るい色(クリーム紙 + 薄いタン)。
- パイロン・車ははっきり描く(濃い色 + 影)。
- タイヤの色変化(緑→黄→赤)は意味を持つので見えるように描く。
- スキッド痕は面白さの要素として分かる程度に残す。
8.2 パレット
| 役割 | 値 | 意味 |
|---|---|---|
| paper | #f2ecdc | 生成り(背景) |
| ink | #2a2018 | 焦茶(本文) |
| accent | #e85a32 | 朱(次のゲート・アクセント) |
| grid | rgba(140,120,90,*) | 薄茶(罫線) |
| road base | rgba(210,190,150,0.45) | 薄タン(路面) |
| steel | rgba(55,110,205,*) | 青(滑る面) |
| grip | rgba(235,120,30,*) | 橙(食う面) |
| player | #2a4a6a | 紺(自車) |
| rival | #c8342a | 朱(ライバル) |
| pylon | #2a4858 | 濃紺(パイロン) |
| ghost | rgba(100,140,180,*) | 青錆(ゴースト) |
| tire | HSL 120°→0° | 緑→黄→赤(タイヤ負荷) |
8.3 Material Elevation
setElevation(ctx, level) で統一された影を付ける:
| level | shadowBlur | shadowOffsetY | 用途 |
|---|---|---|---|
| 0 | 0 | 0 | 影なし |
| 1 | 2.5 | 0.8 | タイヤドット・小要素 |
| 2 | 5 | 1.6 | パイロン・車体 |
影の色は rgba(80,60,40, α)。α = 0.14 + level × 0.05。
8.4 描画規約
- 発光を描かない(
shadowBlurを光源として使わない。elevation 影のみ) - ベタ塗りをしない(紙にノイズを載せる、
getPaperCanvasの ±5) - 直線を直線で描かない(微小に歪ませる)
- 白を使いすぎない(地色は生成り)
- 縁取りより面で見せる(Material の原則)
8.5 単位とスケール
- 世界座標はメートル。
GAME.viewScalePx = 8.5px/m(chase view)。- fit view は bounds に合わせて自動スケール。
- 車体長 4.30 m、幅 1.80 m。
- 道路半幅 2.8 m。
9. コース生成
9.1 ノードベース
- 0.5 m 刻みのノード列(
COURSE.nodeStep)。 - セクションは直進・アーク・S 字・複合カーブからランダム選択。
- 全長は 8〜16 セクション × 各セクション 8〜52 m。
- 前後に 7 m / 9 m の直進を付加。
9.2 ゲート
COURSE.gateSpacing = 32 m間隔。- 初回は 18 m 地点(
firstGate)。 - 幅は
gateHalfMin〜gateHalfMax= 2.0 〜 3.8 m。 - 難度
dif = clamp01(stageIndex/12)で幅を狭める。 - パイロンと干渉する場合は外側へ押し出す(
pylonExtendStep0.4 m、最大 10 m)。
9.3 パイロン
- 各ゲートの両端に配置。
pylonR = 0.30 m、安全マージンpylonSafeMargin = 0.6 m。- コースから離れた位置に押し出して配置。
9.4 サーフェスゾーン
- 基準面 =
rng.int(0, 2)で抽選。 - ゾーン長 2〜4 セクション、非重複で 2 ゾーン。
- 隣接ゾーンは同じ面にならない。
- ゾーン外は基準面。
9.5 曲率
- 各ノードで前後の中点からの角度差 / 距離 = 曲率。
- Bot の速度目標計算に使用。
10. Bot
10.1 追従
- 最寄りノードから前方
Ld = clamp(v * lookTime, 5, 16)m を目標点とする。 - 目標点への角度誤差 ×
steerKp− ヨーレート ×steerKdで操舵。 - 前方 50 ノードの最大曲率から
vTarget = clamp(sqrt(aLat / maxK), 6, vTop)。
10.2 スキル
botParamsForStage(stageIndex, skill)でaLat,vTop,gripMul,lookTimeを補間。skillはBOT.skillBase = 0.35からBOT.skillMax = 1.00へステージごとに上昇。gripMulは最大 1.08(人間より少し食う)。
10.3 制限
- Bot はパイロンを避けない(コース中央を走る前提)。
- Bot は手放しでもコース上を走る(学習対象ではない)。
11. アーキテクチャ
11.1 ファイル構成
public/tools/rubbing/ 配下:
manifest.jsonindex.html テンプレートstyles/ 10-base.css 20-hud.css 30-controls.css 40-menu.cssjs/ 10-math.js clamp, lerp, wrapAngle, dist, ... 20-rng.js hashSeed, createRng (xorshift) 30-config.js すべての定数 + COLORS 40-storage.js localStorage, ghost encode/decode 50-input.js タッチ・キーボード入力, ステアリング UI 60-physics.js 車両物理 stepCar 70-course.js コース生成, ゲート/パイロン判定 80-ghost.js ゴーストのエンコード/デコード/再生 90-bot.js Bot の追従ロジック 95-camera.js chase / fit カメラ変換 100-render.js canvas 描画全般 110-hud.js DOM HUD 更新 115-collection.js シードコレクション画面 120-game.js ゲーム状態機械, updateGame 130-boot.js entry point, boot()bundle/ index.html 生成物tmp/ verify の一時領域11.2 依存方向
10-math ────┐20-rng ─────┤30-config ──┤ ▼40-storage 50-input 60-physics 95-camera │ │ ▼ ▼ 80-ghost 70-course 90-bot │ ▼ 100-render 110-hud 115-collection │ ▼ 120-game │ ▼ 130-boot循環依存なし。bundle.mjs の topo sort が決定論的な順序を生む。
11.3 directive / import / export
2026-09-28-html-split-bundle-規約 に従う。
- 各ファイル先頭に
// === @file: js/NN-name.js === - 2 行目以降に
// @import:と// @export: - directive と実
import/exportは 1:1 対応 - すべての
const/functionにexportを付ける(@export:に列挙されたもの)
12. データ永続化
12.1 localStorage キー
| キー | 内容 |
|---|---|
gk:profile:v2 | プロファイル(version 3 に自動移行) |
gk:ghost:v3:{seed} | ゴースト配列(最大 3 本、新しい順) |
gk:defeat:v3:{seed} | 敗北ゴースト(1 本) |
12.2 プロファイル
{ version: 3, stageBests: { "{seed}": { t: number, at: number, len: number } }, seedOrder: number[], // 発見順 battleBestStage: number}12.3 ゴーストエンコード
各サンプル 8 byte:
| オフセット | 型 | 内容 |
|---|---|---|
| 0 | Int16 | x × 100 (cm) |
| 2 | Int16 | y × 100 (cm) |
| 4 | Int16 | ang × 1000 (mrad) |
| 6 | Uint8 | gates 通過数 |
| 7 | Uint8 | 予約 |
base64 エンコードして保存。30 Hz × 60 s = 1800 サンプル = 14.4 KB。
13. 入力
13.1 タッチ
| 操作 | ゾーン | 挙動 |
|---|---|---|
| ステア | 画面左下 1/2 × 下 20% | 押下点を中心に左右ドラッグ |
| アクセル | 画面右下 1/2 × 下 20% | 押下点から上ドラッグ |
| ブレーキ | 同上 | 押下点から下ドラッグ |
| ハンドブレーキ | 右下 46×46 px | 押下中アクティブ |
CTRL.steerRangePx = 60/pedalRangePx = 70。- ステアは非線形(
steerExp = 1.30)。 - ゾーン端で原点をクランプ(範囲外に出ない)。
13.2 キーボード
| キー | 動作 |
|---|---|
| ← / → | ステア |
| ↑ / ↓ | アクセル / ブレーキ |
| Space | ハンドブレーキ |
13.3 入力状態
{ steer: -1..1, throttle: 0..1, brake: 0..1, handbrake: bool, keys: { left, right, up, down, hb }}resetInput で各走行開始時にゼロ化。
14. カメラ
14.1 chase view
- 自車の前方
lookAheadm を中心に、進行方向を上に回転。 - 車体は画面下半分に配置。
- 速度に応じて
lookAheadとscaleを微調整(速度感の演出)。
14.2 fit view
- TA の上部に表示。コース全体を bounds + pad でフィット。
- 自車位置にドットを描画。
14.3 レイアウト
[ recordbar 36px ][ topRect viewH * 0.42 ][ botRect viewH * 0.58 ][ controls ctrlH ]ctrlH = min(h * 0.20, 150)。
15. 未実装 / 今後の候補
- 上位 3 ゴーストの選択 UI(データは既に保持)
- 敗北ゴーストの視覚差別化(青錆 vs 淡茶)
- リプレイスクラブ(任意ゲートから再開)
- デイリーシード(日付ハッシュ、オフライン可)
- セクター区切りのコース上の視覚マーカー
- 連勝記録の保存と表示
- ニアイメージ「COURAGE」ボーナス(タイム非干渉の演出)
- ゴーストの頭出し(0.3s 遅延)
16. ビルド・検証
16.1 通常の開発
# ソースを編集node scripts/html-build/audit-imports.mjs --project rubbingnode scripts/html-build/bundle.mjs --project rubbingnode scripts/html-build/verify.mjs --project rubbing3 コマンドすべて exit 0 が条件。
16.2 単一 HTML からソースへ
node scripts/html-build/split.mjs --project rubbing --in bundle/index.html --out .index.html は dev 形式(<link> + <script src>)に書き換わる。
16.3 検証
verify: bundle → split → 比較。全一致で exit 0。audit-imports: directive ↔ 実 import/export の不整合検出。[missing]は手動修正。
17. 数値一覧(調整ポイント)
物理・ゲームバランスの主要数値。実プレイで調整する場合の早見表。
| 症状 | 調整 |
|---|---|
| まだ曲がらない | CAR.maxYawRate ↑, CAR.yawDamp ↓ |
| スピンしすぎ | CAR.muR ↑, CAR.Cr ↓, CAR.yawDampSlip ↑ |
| 加速で失速 | CAR.FmaxEngine ↑, CAR.muR ↑ |
| 唐突に滑る | CAR.Cf/CAR.Cr ↓, CAR.yawDampSlip ↑ |
| 路面差が弱い | SURFACES[i].mu の差を拡大 |
| Bot が強すぎ | BOT.skillBase ↓, BOT.aLatSpan ↓ |
| メダルが取りにくい | MEDAL.parSpeed ↑ |
すべて export されているので、devtools から CAR.maxSteer = 1.0 のように上書きして試せる。
18. 用語
| 用語 | 意味 |
|---|---|
| seed | コース生成の種。16 進 8 桁で表示 |
| gate | 通過すべき門。コース上 32 m 間隔 |
| pylon | ゲート両端の障害物。接触で MISS |
| split | セクター通過タイム |
| delta | ベストゴーストとの時刻差 |
| ghost | 過去の自分の走行記録 |
| par | コース全長から推定した基準タイム |
| skill | Bot の強さ(0.35 〜 1.00) |
| elevation | Material Design 風の影の段階 |
19. 関連ドキュメント
- 2026-09-28-html-split-bundle-規約 — 分割ソースと単一 HTML の相互変換ルール
- 2026-09-27-text-chunker-spec — 同じ規約を使う別プロジェクト