台湾チキン

ゲーム画面

左右にスワイプしてもっと見る。

技術紹介

Flutter のアプリ本体、Godot のゲーム、Django のバックエンド。スマホとWeb版は同じゲームコードで動きます。

• Flutter アプリ本体

  設定、ログイン、ステージ一覧、記録は Flutter で作られています。ゲーム開始時に言語・画質・操作設定などを設定チャネルでゲームに渡し、終了時に結果を受け取ります。

• Godot 4 ゲーム

  街はステージデータから自動生成され、車の流れや歩行者、違反車は交通 AI が動かします。反則のルールはデータファイルで定義し、スマホとWeb版で同じゲームコードを使っています。

• Django バックエンド

  アカウントと削除、名所の多言語ガイドを担当し、ステージ設定ファイルに署名して公開します。アプリは署名を確認してから使い、失敗した場合は前回成功した版に戻します。

• Web 版：1 ステージの体験版

  Web 版は蓮池潭・龍虎塔の 1 ステージのみで、インストールなしで試遊できます。ステージパックのファイル名には内容のハッシュが入り、ダウンロード後に SHA-256 で検証、2 回目以降はブラウザのキャッシュを使います。全ステージはアプリで遊べます。

• 品質

  Godot と Flutter の両方に自動テストがあり、ステージには回帰チェックとスクリーンショット比較もあります。修正はテストに合格してからマージします。

Flutter によるクロスプラットフォーム開発の利点

• 1 つの Dart コードから iOS と Android のアプリを作れるため、設定、ログイン、ステージ一覧、記録、3 言語の画面を一度書くだけで済みます。
• 両プラットフォームで見た目と動作がそろい、1 つの修正が両方に反映され、テストも 1 セットで済みます。
• AdMob、Firebase、共有、ログインなどのネイティブ機能には公式または実績あるパッケージがあり、Swift と Kotlin を別々に書く必要がありません。
• ホットリロードで画面の変更を数秒で確認できます。Flutter は過去の複数のプロジェクトで実績があり、性能にも開発効率にも満足しています。

ゲームに three.js や Flutter ではなく Godot を使う理由

• three.js は 3D 描画だけを担当し、物理、衝突、サウンド管理、シーンエディタがありません。車の操作、交通、衝突をすべて一から作る必要があります。
• Flutter は UI フレームワークで、3D シーン、物理、衝突を内蔵していません。アプリの外枠には向いていますが、3D の運転ゲームには向きません。
• Godot は完全なオープンソースのゲームエンジン（MIT ライセンス、ライセンス料やロイヤリティなし）で、3D 描画、物理、サウンド、アニメーション、入力を内蔵しています。
• シーンとスクリプトはテキストファイルなので、Claude Code が直接読み書きでき、git で差分も確認できます。画面なしモードで自動テストも実行できます。
• 同じゲームを WebAssembly に書き出し、アプリは WebView 内で、Web 版はブラウザで直接動かします。代わりに WebView では性能に余裕がなく、ローエンドのスマホでは画質を下げる必要があります。

デプロイの判断：サイトとゲーム素材を Cloudflare Workers に置く

初版の公式サイトと龍虎塔の Web 版はすべて静的ファイルで、Cloudflare Workers の静的アセットとして配信し、Worker のコードは実行しません。静的アセットへのリクエストは無料・無制限で、転送量の追加料金もありません。アプリと API は引き続き findmo のバックエンドを使うため、Web のアクセスがバックエンドに負荷をかけることはありません。

前提：1 回の閲覧はトップページを開いて最後までスクロールすること。遊ぶ人は別途ゲームをダウンロードします。リスク：Cloudflare のサービス規約では、CDN で動画や大きなファイルを大量に配信する場合は有料サービス（開発者プラットフォームを含む）を使う必要があり、Workers 無料プランが該当するかは明記されていません。そのため、アクセスが増える前に Workers 有料プランへ移行します。有料プランでも静的アセットへのリクエストは無料・無制限です。index.pck とステージパックは Cloudflare で圧縮配信するようにし、Web 版の初回ダウンロードは約 19.7 MB から約 14.4 MB に減りました。

全ステージをアプリに同梱する理由

• Web 版はインストール不要の体験版として龍虎塔の 1 ステージのみ。高雄のほかの名所ステージの素材はすべてアプリに同梱しています。
• 転送料金がかからない：アプリは App Store／Google Play からダウンロードされ、転送はストアが負担します。プレイ中にサーバーからステージ素材をダウンロードすることもありません。
• 待たずにステージを開始：素材はすでにスマホにあるため、オフラインでも遊べ、読み込み画面で止まりません。
• バックエンドは小さなファイルだけ：アプリが取得するのは署名付き設定ファイルと名所ガイドのみ。ステージの内容はアプリの更新とともに、ストア審査を経て配信されます。

運営費：AdMob 広告

• サーバー、Cloudflare 有料プラン、ストアの年会費などの運営費は、アプリの Google AdMob 広告でまかないます。
• 広告枠は 3 つ：アプリ起動時の広告、名所一覧の下部のバナー、数ステージ遊んで一覧に戻ったときのインタースティシャル広告。
• 運転中の画面には広告を出しません。インタースティシャル広告には 1 日の上限と最短間隔があり、管理画面からいつでも調整・停止できます。
• Web 版には広告がなく、まず試遊してもらい、アプリのダウンロードへ案内します。

開発ストーリー

プロジェクト作成から 0.1.0 まで、コードとテストの大部分は Claude Code が書き、人は要件の提示、判断、実機での確認を担当しました。以下の数字はビルド時に git の履歴から自動で集計しています。

使用したツールとモデル

• VS Code

  IDE

  開発に使う統合開発環境。

• Open Bull

  Harness プラグイン

  修正課題とプロジェクト文書を管理します。

• Claude Code

  200 ドルのサブスクリプション

  コード開発、統合テスト、デプロイ作業を主に担当。モデルは主に Claude Opus、サブタスクは Sonnet と Haiku。

• Codex

  Pro サブスクリプション

  主に画像生成を担当：特集画像、街並みの要素、看板、アイコン。

• OpenAI

  効果音

  物売りのアナウンスやクラクションなどの音声効果音を生成します。

マイルストーン

1. プロジェクト作成：企画、Godot 試作版、Flutter アプリ本体Godot は本プロジェクトが初めての採用です。Flutter は過去の複数のプロジェクトで実績があり、実行性能にも開発効率にも満足しています。
2. 3言語対応（繁体字中国語、英語、日本語）
3. 最初の高雄の街ステージ
4. Web 版を独立ビルド：龍虎塔 1 ステージの体験版
5. 0.1.0 審査提出

作業の流れ

1. 人欲しい機能や気づいた問題を一文で伝える
2. AI現在の動作、期待する動作、受け入れ条件を書いた課題に分ける
3. AI課題ごとにブランチを作って実装し、テストを追加
4. AI静的チェックと自動テストを実行し、合格したらマージ
5. AIテスト環境にデプロイして実際に動作を確認
6. 人判断する：AI が決めるべき事項を3つの選択肢とおすすめにまとめ、人が選ぶ
7. 人人が実機で試遊し、スクリーンショットに問題を書き込んで AI に修正を依頼する
8. AIストア申請と本番デプロイは AI が Ego Lite ブラウザで行い、アカウントとパスワードは人が入力する

全自動ではありません。製品の方向性、選択肢の判断、本番公開は人が決めます。

人と Claude Code の役割分担

• ゲームのシナリオとルール：大まかな方向は人が決め、細かいルールは Claude Code が決め、人が試遊して課題としてフィードバックします。
• 音が心地よいか、操作がなめらかか：人がスマホで実際に遊んでテストします。
• 英語と日本語：まだネイティブのチェックは受けておらず、当面は Claude Code の翻訳を採用しています。
• 実機での性能、発熱、タッチ操作の感触：シミュレーターでは測れないため、人が実機でテストします。
• ストアのアカウント、管理画面、本番サーバー：Claude Code が Ego Lite ブラウザのスキルで操作し、アカウントとパスワードは人が入力します。
• 開発中の納品は Claude Code が行います：ブランチ作成、テスト、マージ、デプロイ。納品ルールは CLAUDE.md に定めています。