ビー玉1000個を坂から流す — 衝突と分布を3Dで見るシミュレーターを公開しました - 開発ログ

作ったもの
「ビー玉1000個を坂から流したらどうなる?」を、ブラウザの中で確かめられるシミュレーター。 長さ3m・幅1mの坂にビー玉を一斉に流し、ゴールまでの時間と、どこを通ったかを見られる。 パラメータを触る物理シミュレーション集「Physics Playground」の10本目で、これが最後の1本。
障害物のない18°の坂なら、転がるビー玉は計算上1.67秒で下りきり、坂の下で秒速3.60mになる。 でも同じ坂でも、杭を打ったコースに300個流すとゴールする順番はばらばらになる。 1個ずつの結果は予測できなくても、全体の分布は条件ではっきり変わる。
主な機能
- コース(Straight・Slalom・Chaos・Pinball)・ビー玉の数(10〜1000個)・坂の角度・障害物の数を変更
- ビー玉の大きさ・質量・摩擦・反発係数・重力も変更
- 4つのコースと「1000個」のプリセット、ランダム、極端な設定
- ゴール到達数、平均・最速・最遅の到達時間、平均速度、理論値を表示
- 到達時間の分布と、ゴール線を通過した横位置の分布をグラフで表示
- ビー玉が通った場所をヒートマップで表示
- 「このシミュレーションの仕組み」で、使った式・仮定・現実との差を公開
使用技術
- React + TypeScript + Vite
- Three.js(React Three Fiber / drei)
- Rapier(剛体物理エンジン)
- Vitest(物理モデルのテスト)
- Cloudflare Pages + GitHub
- Claude Code と一緒に開発
開発時の工夫
ビー玉とコースはすべて剛体として Rapier で計算し、1/120秒の固定ステップで進めている。 処理が重いときはステップ数を制限して、時間の進みを遅くする。こうすると結果の再現性が保てる。 描画はインスタンシングで1回にまとめて描くので、1000個でも表示は軽い。
理論値も一緒に出している。滑らずに転がる球は、エネルギーの一部が回転に取られるので 加速度が g sinθ ではなく 5/7 g sinθ になる。18°なら2.17m/s²。障害物がないコースで、 物理エンジンの結果と理論値を見比べられる。
ビー玉が通った場所は坂の座標に戻して数え、ヒートマップで描いている。 Chaos コースは障害物12の設定で杭が48本立ち、どこに玉が集まりやすいかが色で見える。 Pinball コースは21本の杭のうち7本がよく弾むバンパー(反発係数1.4)で、順位が大きく入れ替わる。
今後の改善
- 1個のビー玉を選んで追いかけるカメラ
- 自分で障害物を置けるコースエディタ
- 到達時間の分布を前回の結果と重ねて比べる表示