Mopuru Gamesのゲームは、CodexやClaude CodeといったAIコーディング支援を使って作っています。AIに頼むと実装は速く進みます。そのぶん、「動いているように見えて、実は間違っている」ものも速く増えます。
この記事では、実際に起きた問題を6つ取り上げます。不具合の修正に加え、説明文や実装の選び方も扱います。日付は変更履歴に残っているものです。
| 起きたこと | ゲーム | 今の確かめ方 | 直し方 |
|---|---|---|---|
| iPhoneで部屋を作ると画面エラー | CODE TRACE | 保存が失敗するブラウザを想定したテスト | 保存の失敗と、遅れて届く古い応答に対応 |
| 計算結果が最後の桁だけ違う | Mopuru Cannon | サーバーとテスト環境の比較テスト | 比べ方を環境ごとに分けた |
| 踏んでいない妨害が発動する | ウラギリ・シグナル | 盤面を1通りずつ用意するテスト | 判定する範囲を「その行動で進むマス」に限定 |
| 切断した人の手番で全員が止まる | ヨナカノ商店街 | 切断を再現するテスト | 90秒待ったあと、残りの人の投票で手番を飛ばせるようにした |
| サイトの説明が実装とずれる | サイト全体 | 公開ページの読み直し | 文章に数字を直接書かず、ゲームのデータから作る |
| 同じ機能の実装が2通りできた | CODE TRACE | 2つの差分を読み比べ | 項目ごとに比べて、片方を正式版にした |
1. iPhoneで部屋を作ると画面エラーになった
CODE TRACEの2人対戦で、iPhoneのSafariから最初の部屋を作ると画面エラーになることがありました。9月28日の修正履歴には、保存失敗への対処と、別の部屋から届く応答を除外する修正が残っています。
原因は2つ重なっていました。
1つ目は、ブラウザの保存領域です。対戦に戻るための情報をブラウザに保存しているのですが、設定や状態によっては、保存しようとした時点でブラウザがエラーを返します。当時の実装では、保存時の例外を処理していない箇所がありました。
2つ目は、応答の順番です。部屋を作り直したとき、前の部屋についての応答が遅れて届き、新しい部屋の状態を上書きしていました。
直し方も2つです。保存の読み書きはすべて失敗しても止まらないようにし、失敗したことを画面側が分かるようにしました。届いた応答は、今の部屋と今のプレイヤーのものだけを受け取ります。どちらも「保存が必ず失敗するブラウザ」と「別の部屋の応答が届く場合」をテストに追加して、同じ問題が戻らないようにしました(9月28日)。
2. サーバーとテスト環境で、計算が最後の桁だけ違った
Mopuru Cannonは、弾道やダメージをサーバーとブラウザの両方で同じ式で計算します。同じ入力なら同じ結果になることを前提に、サーバーが決めた結果を各ブラウザが再生するしくみです。
ところが、サーバーを動かすworkerdと、テストを動かすNode.jsとで、三角関数の結果が最後の桁だけ違うことがありました。テストは「完全に一致すること」を求めていたので失敗します。
誤差を許容する範囲は、比較する環境によって分けました。同じ環境の中では結果は完全に一致していました。そこで、同じ環境どうしは完全一致のまま確認し、環境をまたぐ比較だけ10億分の1程度の誤差を認める形に分けました。ダメージや物理の計算式には手を入れていません。
3. 踏んでいない妨害が発動していた
ウラギリ・シグナルには、ウラギリモノが仕掛ける秘密のJAM(妨害)があります。ルートを進める行動がJAMのあるマスに届いたときに発動します。
10月10日に見つけたのは、1マスだけ進む「接続」を使うと、JAMがまだ先のマスにあるのに発動した扱いになる、という不具合です。2マス進む「ブースト」は正しく判定されていました。接続だけが、進む範囲を見ずに「当たった」と数えていました。
これは画面を触っているだけでは気づきにくい間違いです。妨害が発動すること自体は、ゲームとして自然に見えるからです。判定を「その行動で実際に進むマスの中にJAMがあるか」に統一して直し、盤面の並びを1通りずつ用意して結果を確かめるテストを追加しました。
4. 切断した人の手番で、全員が待ち続けた
ヨナカノ商店街は3〜5人で20〜40分かかるゲームです。途中で通信が切れても続行できる仕組みが必要です。
最初の実装では、切断した人の席を残して再接続を待つようにしていました。席を消さないのは正しいのですが、その人の手番が来ると、戻ってくるまで全員が何もできなくなります。
10月11日に、90秒待っても戻らないときは、残りの人の投票でその手番だけを飛ばせるようにしました。飛ばしても、席・資源・店はそのまま残ります。戻ってくれば次の手番から続けられます。誰か1人の判断で他人の手番を消せないように、投票にしています。
5. サイトの説明が、実装とずれていった
AIは文章も書けるので、ゲームの紹介文やよくある質問もAIと一緒に書いています。問題は、ゲームを更新しても文章は自動では変わらないことです。
- 10月6日:ゲームを追加したのに、トップページやよくある質問が古い公開数のままでした。文章の中に数を直接書いていたのが原因です。公開中のゲームの一覧から数えて表示するように変えました。
- 11月15日:NOQUA ARCUSの紹介に「17種類のカードはイラスト制作中」と残っていました。実際には42種すべてのイラストが入っていました。カード一覧をゲーム本体と同じデータから作るように変え、文章と実物がずれないようにしました。
どちらも、公開しているページを読み直して見つかりました。今は、数や名前のように実装で決まるものは、できるだけ文章に直接書かないようにしています。
6. 同じ機能を2つのAIに作らせて、比べた
CODE TRACEのDAILY TRACE(1日1問、全員が同じ問題を解くモード)は、CodexとClaude Codeの両方に実装させ、差分を読み比べました。
比べたのは、失敗したときに正解を見せるか、URLで指定された問題と今日の問題のどちらを優先するか、連続記録の数え方、共有用の画像、テストの範囲です。2つの良いところを混ぜるのではなく、項目ごとにどちらが仕様に合っているかを決め、片方を正式版として残しました。混ぜると、どちらのテストも通らない中間の状態ができやすいためです。
6つの問題から、進め方として残したこと
- 頼む範囲を小さく区切る。 画面の変更が通信のしくみまで変えてしまうと、影響を追えなくなります。「サーバーは変更しない」「ルールは変えない」のように、変えてはいけない範囲を先に書いてから頼みます。
- 計算や判定は、画面から切り離してテストする。 3番のような間違いは、画面を見ているだけでは気づきにくいものです。
- 画面と実機の確認を分ける。 375〜390px幅のブラウザ表示と、実際のスマートフォンでの操作は別の確認です。保存失敗や通信の競合は自動テストで再現し、実機確認を行ったかどうかとは分けて記録します。
- 決めるのは人。 どのルールを採用するか、何を事実として書くか、いつ公開するかは、AIではなく運営者が決めています。
AIを使うと、作る速さは確かに上がります。同じ速さで確かめる手段を増やしていかないと、間違いのほうが先に積み上がる、というのが実際に作ってみた感想です。