B-Teck!

お仕事からゲームまで幅広く

three.js で探索できる建物を作るときに工夫したこと

blog.beatdjam.com

で紹介した Sector Dive Extended の、中身の話。 three.js で作ったブラウザのFPSで、スマホでも遊べる。ステージの種類はセクターと呼んでいて、九龍城の路地やショッピングモールなど8つある。 作り直しでは、ステージを何階もある建物にした。その建物をどう作ったかと、スマホでも動くように軽くしたところを書いていく。

階の作り

1つの階は、1辺4mのマス目(タイル)を敷き詰めた平面になっている。壁もマス1つを丸ごと使う。 マスごとに床の高さを持っている。壁のほかは、歩けるか、敵が通れるか、敵からプレイヤーが見えるかを、この高さを比べて決めている。

  • 0.7m より高い段差は登れない。降りるのは自由。これはプレイヤーも敵も同じで、敵はこの決まりで通れるマスをたどって動く
  • 間にあるマスの床が敵の視線より高ければ、敵からプレイヤーは見えない

建物は、この階を3〜5枚重ねて、階段とエレベーターでつないだもの。

モールのフードコートは、床を 0.5m ずつ2段下げた広場にしている。真ん中は周りより 1m 低いけど、どの段差も 0.7m より小さいので、そのまま歩いて降りて登れる。

同じ建物を作り直す

建物は、1つのシードから全部の階をまとめて作っている。渡された乱数から生成の処理をするようにしているので、シードが同じなら同じ建物になる。 中断したときも、建物そのものではなくシードを保存して、再開するときに作り直している。

これはテストでも使っている。8セクター × 3シードの24棟を作って、各階の形や順路から1つのハッシュ値を出し、期待値としてテストに書いておく。

  • 作りを変えないはずのリファクタでは、ハッシュ値が変わらなければ同じ建物ができている
  • 建物の作りをわざと変えたときは、期待値を新しいハッシュ値に書き換える

モールでは、広い店の部屋がスカスカに見えたので、部屋の真ん中に服屋のラックやカフェのカウンターのような遮蔽物を足した。 このときは足した分を専用の乱数で引いて、ほかのセクターが前と同じ建物のままなのを確かめた。

窓と中庭

建物の窓から、外の景色や中庭が見えるようにしたかった。 ただ、壁はマス1つ分なので厚みが4mある。穴を開けると、窓というより4mの穴に見えてしまう。

そこで、壁に穴は開けずに、壁の面にガラスの板を貼っている。板そのものは何も描かず、ステンシルに印を付けるだけ。ステンシルは、画面の点ごとに印を付けておいて、あとで印の所にだけ描けるようにする仕組みだ。そのあとで、印の付いた所にだけ外の景色を描く。 こうすると、窓の向こうがずっと遠くにあるように見える。

旧市街ビル群と廃墟街では、建物の真ん中に、上の階まで吹き抜けになった中庭がある。窓の向こうがこの中庭になっていることもあって、その場合は中庭の複製を窓の向こうに置き、窓越しに見える所だけを描いている。 本物の中庭のほうは、すぐ近くにいるときか、窓越しではなく直接見えるときだけ描く。

壁ぎわの小物

遊んでいて、内装のゴミゴミ感が足りないと感じていた。そこで、壁ぎわに物を置いていく共通の処理を作った。 床のタイルを全部見て、壁に面した所と天井の下を集め、層ごとに乱数を引いて物を重ねて置く。層は、足もとのガラクタの山、屋台や棚などの作り付け、壁沿いの配管と配線、天井の下を渡る配線、路地の裸電球など。

九龍城で作ったあと、ほかのセクターでも使えるようにした。セクターごとに渡すのは、主に置く物の絵と、部屋と路地それぞれで壁の何割に物を置くか。

軽くする

建物や小物を足していくと、そのぶん重くなる。 重さの目安には、2つの数を使った。1フレームのあいだに描く命令を出す回数(描画の回数)と、描く三角形の数だ。3Dの物は小さい三角形を組み合わせてできているので、三角形が多いほど描くのに時間がかかる。 この2つを開発用画面に出すようにして、削る前にまず測るようにした。

測ってみると、思い込みと違うこともあった。窓のあるステージが重いと感じていたけど、実際は窓の無い溶融炉区画のほうが重い条件もあった。

描画の回数を減らす

やったことと、それぞれ効いた場面での回数はこのくらい。行ごとに測った場面が違うので、足し合わせる数ではない。数字は、敵の行のほかはヘッドレスの Chrome で測ったもの。

やったこと 描画の回数
敵の部品を材質ごとにまとめる 敵1体あたり。32 → 7、58 → 25 など種類によって差異あり
エレベーターでつながる階は、乗っている間だけ描く 289 → 152
本物の中庭は、見えるときだけ描く 377 → 266
中庭のベランダの手すりと橋を、材質ごとにまとめて描く 271 → 198
閉まったドアの向こうにしか無い物は描かない 283 → 150

色だけで描いている小物も、階ごとに1つにまとめて描いている。 まとめきれずに残ったのは、絵を貼った小物。絵ごとに種類が分かれるので、まとめるには、絵を1枚の大きい画像に並べたもの(テクスチャアトラス)が要る。 次に絵を使って小物を作るときは、最初からテクスチャアトラスで描くのも選択肢に入れておきたい。

三角形の数を減らす

同じ形の物がたくさんあるときは、three.js の InstancedMesh でまとめて1回で描いている。ただ、使っている three.js(r128)では、まとめた物が画面の外にあっても全部描いてしまう。 まとめるほど描画の回数は減るけど、画面に映らない三角形まで描くことになる。

そこで、階を 8×8 マスの区画に分けた。 たとえば同じ形の物が階に100個あるとき、今までは100個まとめて1回で描いていた。これを区画ごとにまとめ直して、画面に入っている区画の分だけを描く。 その代わり、描画の回数は増える。その形の物が画面に入っている5つの区画に散らばっていれば、1回で済んでいたものが5回になる。

物の形は何種類もあるので、最初に全部を区画に分けたら、描画の回数が最大で2倍になった。 なので、区画に分けるのは三角形が多い形(1つの階で合計 3000 以上)だけにした。三角形が少ない形は、今までどおり階まるごと1回で描いている。

測った場面では、描画の回数はほぼそのまま(335 → 342)で、描く三角形が25.4万から9.5万に減った。

ほかに

HP・スタミナのバーやボスの体力などの画面の表示は、値が変わったときだけ書き直すようにした。元は値が同じでも毎フレーム書き直していた。

スマホの 120Hz の画面だと、120 出る所と 60〜100 に落ちる所があって、戦闘中に重いと操作が滑る感じがあった。そこで、スマホは1秒に60フレームまでに揃えた。

まとめ

  • 1つの階はマス目と床の高さで持っていて、段差も見通しも高さを比べて決めている
  • 建物は1つのシードから作るので、中断からの再開もテストも、同じ建物を作り直して済ませている
  • 窓は壁に穴を開けず、ステンシルで外の景色や中庭を見せている
  • 重くなったぶんは、描画の回数と三角形の数を測ってから削った

www.youtube.com

beatdjam.github.io

Claude Code の利用枠が足りなくなったので、ゲームの実装を部分的に OpenCode に任せるようにした

ローグライトFPS「Sector Dive」を作り直して、「Sector Dive Extended」として公開した - B-Teck! で紹介した Sector Dive Extended を作っていたときの、開発の進め方の話。

Claude Codeに作ってもらったゲームが面白かったので、AIに作り続けてもらう仕組みを整えた - B-Teck! では、壊れずに作り続けるためにテストや CI を足していった話を書いた。 今回も実装は AI に任せていて、自分は遊んで感想を返したり、方針を決めたりしている。

動くものができて、やりたいことが増えた。前作よりもコードやタスクの規模が大きくなり、Claude の制限に頻繁に当たるようになった。 Max プランへのアップグレードや、ほかの AI エージェントのサブスクも検討して、コスト面で優れる OpenCode Go を採用した。

実装を任せられる量が増えると、今度はレビューと確認が追いつかなくなる。別の AI エージェントが書くので、これまで Claude Code に任せていれば守られていた書き方や作りの決まりも、守られるとは限らない。 そこを、タスクの書き方と確かめる道具で少しずつ補っていった。その流れを振り返ってみる。

OpenCode Go

10月の終わりから、実装は OpenCode に任せるようになった。OpenCode は、Claude Code と同じようにターミナルで動くコーディングエージェントで、いろいろな会社のモデルを選んで使える。

OpenCode Go は月10ドルのプランで、決まった枠の中で DeepSeek などのモデルを使える。主に使っている DeepSeek V4.1 Flash は、枠が API の料金に直して月80ドル分あり、5時間あたり約3万5千回まで投げられる(2026年10月時点)。今の使い方では、まず使い切れない。

Claude Code と比べると、コストはかなり安い。 ファイルを6つ直して3つ足すくらいのタスクで、実装1本が約0.025ドルだった。毎回、長いやりとりを送り直しているけど、そのほとんどがキャッシュから読まれる。別の日に見たときは約99%がキャッシュで、安さのほとんどはここから来ている。 半日回した日で比べると、Claude の週の枠を約23%使ったのに対して、OpenCode の月の枠は約5%しか減っていなかった。

OpenCode を入れる前と後で比べると、こうなっている。

入れる前 入れた後
PR の本数(稼働日あたり) 7.7本 9.9本
追加した行のうち、テストの割合 8% 35%

テストの割合が上がったのは、タスクの完了条件に挙動のテストを書くようにしたから。

分担

最初に渡した7本は、Claude が作業範囲と完了条件をタスクとして書いてから渡した。変える箇所まで指定したものから、何を変えるかの判断まで任せたものまであったけど、どれも差し戻しなしで通った。

その後、別のゲームの試作で、これまでのようにざっくりとやりたいことを Markdown にまとめて渡してみた。動くものは出てきたけど、かなり時間がかかった。出てきた実装もいまひとつだった。 なので、Claude が要件からタスクを分けて、作業範囲と完了条件を書いてから渡す形に揃えた。

今の分担はこんな感じ。

大きいタスクは Flash に下書きさせて、事実を確かめてから渡す。小さいタスクは、下書きを通さずに Claude が直接書いている。範囲の決まった調査も、Flash に任せて結果をファイルに書かせている。

比較のために、上位のモデル(DeepSeek V4.1 Pro)にも同じタスクをやらせてみた。

タスク Flash Pro 結果
文書の組み直し 365秒 777秒 どちらも完了条件を満たした。範囲の解釈も同じ
1600行のファイルを分ける(分け方も任せる) 504秒 2243秒 骨組みはほぼ同じ形。同じ設計の穴が両方に残った

Pro は2〜4.5倍遅く、出来は少し丁寧な程度だった。明確なタスクを渡す分には、実装を Flash で回して、気になった所を差し戻すほうが速い。

一次レビューでは、作業内容がタスクどおりか、テストに抜けがないかを Haiku や Sonnet に見てもらう。最後に Opus が、動かしてみないと分からない穴を中心にレビューする。 下書きの事実確認を書いたのとは別のモデルに任せているのは、同じモデルで確かめても漏れが見つかりにくかったから。

タスクとキュー

Claude の枠が切れているあいだもタスクを進められるように、まとめて回すスクリプトを作った。 キューに並べたタスクを、タスクごとに作業用のフォルダ(git の worktree)を分けて順に実装させ、終わったらコミットまでしてくれる。

回したとき 本数 かかった時間 止まった本数
最初 11本 約3時間 1本(先に回したタスクと同じファイルを触っていた)
10/31 夜 6本 約40分 0本
11/1 7本 約37分 0本

タスクの消化が速くなると、今度は Claude 側のレビューが詰まり所になる。7本を40分弱で回したときは、レビュー待ちのタスクが並んだ。タスクの指示に間違いがあると、その上に積んだタスクまで同じ間違いを引き継いでしまう。 繰り返し差し戻されるタスクもあった。差し戻しの傾向を見てタスクに書く内容を見直し、タスク自体をレビューするステップも足した。これで、実装のレビューにかかる手間を下げていった。

それでもレビューで見きれない所は、道具に任せることにした。

確かめる道具

ゲームの難しさなどは、挙動のテストだけでは確かめられない。 そこで、数値で比べられる仕組みを作って、ある程度までは AI が自分で確かめられるようにした。この仕組み自体は OpenCode を入れる前からあったけど、実装を任せる量が増えてから、使う場面が増えた。

使っているのは、ゲームを最後まで自動で遊ぶシミュレーター。 人と同じ入力で操作しながら、型ごとにレベルアップのときの選び方や、敵を狙う腕、避けるかどうかの基準を変えてある。どこまで進めて、どこで負けるかを見られる。 画面を描かずにゲームを進めるので、実時間の数百倍で回る。数時間分のプレイを何本も続けて回して、ログを取れるようになった。

ARCADE の難しさを決めたときは、深度の係数を 2 にすると8本中8本がクリア、3 にすると8本中0本だった。目安は「1回でクリアできるのが3分の1〜半分」だったので、間の 2.5 を試して8本中6本。ボットは人より正確なので、人だと少し下がる見込みで 2.5 にした。

通しで遊ばせたことで、進行不能バグも見つかった。ロックダウンの部屋やボス部屋に入ってすぐ引き返すと、部屋の外に取り残されて先に進めなくなる、というもの。

依存の向き

前回の記事で、engine からゲームは import しない、という決まりにしたことを書いた。 ただ、これはルールとして書いただけで、実際に守られているかを確かめる仕組みは無かった。別の AI エージェントに実装を任せるなら、書いてあるだけでは足りない。

そこで、dependency-cruiser(import の向きを検査するツール)で確かめるようにした。今の決まりは4つ。

  • engine はゲームを読まない
  • 循環させない
  • ゲームは engine の公開の入口(フォルダごとの index.ts)からだけ読む
  • engine の中でいちばん下の層(core)は、ほかのフォルダを読まない

最初の2つを入れてみると、循環の違反が199件あった。Extended・旧作の Sector Dive・engine の中にまたがっていて、いちばん大きいのは Extended の37ファイルが互いに参照し合っているかたまりだった。起動の順番を決めてあるので動いてはいるけど、どこから読んでもたどれてしまう状態だった。

これを全部直すのはタスクとして重いし、先に作業したいタスクもあった。なので、この時点の違反は許可リストに入れて、新しく増えた違反だけを止めるようにした。 lint と一緒に検査しているので、タスクの指示やレビューをすり抜けた違反も見つかる。あるタスクは、指示どおりに import を足すと循環が10件増える内容だった。書いた Claude も、実装した Flash も気づいていなかったけど、レビューで検査を流して見つかり、登録して渡す形に直した。

あとの2つは、次の作品に移る前の整理で足した。入口からはゲームが使う名前だけを出しているので、engine の中のファイルを変えても、ゲーム側を触らずに済む。

まとめ

Claude の枠は、計画やレビューのような決めることに使い、手を動かす実装は OpenCode に任せるようになった。 タスクの書き方や事実確認、シミュレーターや依存の検査を少しずつ足していったので、任せても実装の質は落とさずに回せている。

手が空いた分で、これまで据え置いていた改善やドキュメントの整備も、ゲームの開発と合わせて進められた。OpenCode を入れた最初の週は、マージした78本の PR のうち48本がリファクタやドキュメント、開発まわりの整備だった。

ローグライトFPS「Sector Dive」を作り直して、「Sector Dive Extended」として公開した

www.youtube.com

スマホでもサクッと遊べるローグライトFPSがやりたかったので作った - B-Teck! で紹介した Sector Dive を作り直して、「Sector Dive Extended」として公開した。

Claude Codeに作ってもらったゲームが面白かったので、AIに作り続けてもらう仕組みを整えた - B-Teck! に書いたように、前作は Claude Code に任せたらどこまで作ってもらえるのかを試したものだった。

バランス調整などを経て、それなりに遊べるものは出来た。 ただ、ゲームとしての目的やゴールがなく、グラフィックも簡単な図形や色の組み合わせなので単調になってしまっていた。 作り終わった段階で「ワープではなく上下につながったステージで遊びたい」「見た目をもっとゲームっぽくしたい」など、やってみたいことも出てきた。 そこで、ベースのゲームはスナップショットとして残し、別のゲームとして作り直すことにした。前作も今まで通り遊べる。

Sector Dive

建物を潜る

前作は区画をゲートで3つ抜けるとボス、という構成だったが、今作は3〜5階の建物を探索しつつ、ボス部屋を目指す形になった。 探索感を出すために、階段・エレベーターでの上下移動や、一度上の階に戻るような経路の設定などを入れた。 マップも、今いる階の 2D に加えて、建物全体を立体で回して見られるようにしている。

九龍城の中庭やショッピングモールの吹き抜けのように、上下の階を見通せる場所がある建物もある。

歩く時間が増えたのに合わせて、スタミナ消費で走り続けられる機能も追加した。

見た目

セクター・武器・敵・UI まで、見た目をまるごと作り直した。

セクターは、九龍城の路地や製鉄所、サーバールームなど、廃棄された施設をモチーフにした。 前作の6種類に、ショッピングモールと閉鎖病院を足して8種類ある。ボス部屋もセクターごとに作り分けている。

ステージ以外では、手に持つ銃を実際の銃らしい形にして、敵とボスは装甲をまとった機械にした。 UI と効果音も、ゲームのトーンに合わせて作り直している。

敵とギミック

敵は2種類増えた。 迫撃砲は、遮蔽物の裏に隠れていても足もとへ山なりの弾を落としてくるので、物陰で待つだけでは凌げない。 修理ドローンは攻撃してこない代わりに、こちらから距離を取りつつ周囲の敵を回復する。 ボスも2体加わって8体になった。 天井クレーンの HOIST は吊った荷を落としてきて、手術ロボの SURGEON はメスのビームや針で攻めてくる。


建物によっては「ロックダウン」の部屋がある。 予告なしで入ると、ドアが閉まって警報が鳴る。BGM も切り替わり、敵が2回湧いてくる。抜けると良い報酬がもらえる。

ARCADE と ENDLESS

前作に無かったゴールとして最深部にラスボスを置き、遊び方を2つのモードに分けた。 ARCADE はこのゲームの一通りの要素に触れてもらうため、ENDLESS はもっと長く遊びたい人のため(主に自分用)に作っている。

ARCADE は、8つのセクターを順に抜けていき、最深部でラスボスと戦うモード。 1回45分〜1時間で遊べる長さにしている。

ENDLESS は、前作と同じく拠点で強化しながら潜り続けるモード。 ラスボスを倒したあとも、周回や縛りプレイでやり込めるようにした。


開発はいったんここで区切りにして、次は別のゲームを作り始めている。今回の作り方の話は、また別の記事に書く予定。 数値はまだ調整中のところもあるので、遊んでみて気になったことがあれば、結果画面のフォームやSNSでフィードバックください。