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を使うと、作る速さは確かに上がります。同じ速さで確かめる手段を増やしていかないと、間違いのほうが先に積み上がる、というのが実際に作ってみた感想です。

公開中のゲームを見る