メインコンテンツへスキップ
見出し画像

全てをAI任せでシンプルな縦スクロールシューティングゲームを作ってみた

    どうも、マゲです。
    暇過ぎて、上記の通り、AI任せでシンプルな縦スクロールシューティングゲームを作ってみました。

    最終作成環境

    IDE
    PyCharm
    AI
    Gemini CLI

    ゲームはitch.ioにアップロードしてるので、こちらから見てね。
    そして、ゲームの仕様は以下の通り。
    これをAIに読み込ませて動作環境で画面とか操作について追記していけば、似たゲームはできるんじゃないかな。

    # ゲーム仕様書: GALAXY FRONTIER
    
    ## 1. ゲーム概要
    
    ### 1.1. タイトル
    GALAXY FRONTIER
    
    ### 1.2. ジャンル
    縦スクロール型 2Dシューティングゲーム
    
    ### 1.3. コンセプト
    懐かしい8-bit/16-bit時代を彷彿とさせる、レトロフューチャーなSFシューティング。プレイヤーは出撃を繰り返すことでスコアを稼ぎ、新たな武器をアンロックしていく。アンロックした武器をデッキ(格納庫)で購入・装備し、次第に激化する敵の波に挑み、ハイスコアを目指す。
    ピクセルアートによるシンプルなグラフィックと、Pyxel内蔵音源で作成されたチップチューン風のサウンドが特徴。
    
    ### 1.4. プラットフォーム
    Python (Pyxelライブラリ使用)。デスクトップおよびウェブブラウザでの動作を想定。
    
    ## 2. ゲームフロー
    ゲームは以下の画面遷移で進行する。
    
    1.  **タイトル画面**: ゲームの開始点。
        ↓
    2.  **デッキ画面**: 出撃準備を行うハブ画面。ここから「武器ショップ」と「ゲームプレイ」に分岐。
        ↓
        2a. **武器ショップ**: デッキ画面から遷移。武器を購入し、デッキ画面に戻る。
        ↓
        2b. **ゲームプレイ画面**: デッキ画面から「出撃」を選択して遷移。メインのシューティングパート。
        ↓
    3.  **プレイヤー死亡演出**: ゲームプレイ中にプレイヤーが被弾すると遷移。
        ↓
    4.  **ゲームオーバー画面**: 死亡演出後に遷移。スコアの精算などを行う。
        ↓
    5.  **タイトル画面**: ゲームオーバー画面から遷移し、ループする。
    
    ## 3. 各画面仕様
    
    ### 3.1. タイトル画面 (`STATE_TITLE`)
    - **表示**:
        - ゲームタイトル「GALAXY FRONTIER」
        - 「Press SPACE to start」のテキスト
        - ハイスコア
        - 所持コイン総額
    - **操作**:
        - 「スペースキー」「マウス左クリック」「コントローラBボタン」のいずれかでデッキ画面へ遷移。
        - 「Rキー」でセーブデータのリセット。
    - **BGM**: `title`
    
    ### 3.2. デッキ画面 (`STATE_WEAPON_SELECT`)
    - **概要**: プレイヤー機を操作し、「SHOP」「LAUNCH」のエリアに入ることでアクションを実行するハブ画面。
    - **表示**:
        - 画面左側に「SHOP」エリア
        - 画面右側に「LAUNCH」エリア
        - プレイヤー機
    - **操作**:
        - **移動**: 矢印キー、ゲームパッド十字キー/アナログスティック、タッチ(タッチした位置へ追従)でプレイヤー機を操作。
        - **SHOPへ**: プレイヤー機を「SHOP」エリアに入れると武器ショップ画面へ遷移。
        - **出撃**: プレイヤー機を「LAUNCH」エリアに入れるとゲームプレイ画面へ遷移。
    
    #### 3.2.1. 武器ショップ (`substate: 'shop_open'`)
    - **概要**: アンロック済みの武器をコインで購入し、その周回でのみ使用する武器を2つまで選択する。
    - **表示**:
        - 購入可能な武器のリストと価格
        - 現在の所持コイン総額
        - この周回で購入済みの武器リスト(最大2つ)
    - **操作**:
        - **選択**: 矢印キー上下、十字キー上下
        - **購入**: エンターキー、コントローラAボタン
        - **閉じる**: スペースキー、コントローラBボタン
    - **武器アンロック条件 (累計スコア)**:
        - Twin Shot: 500
        - Side Shot: 1500
        - Homing Shot: 2500
        - Laser: 4000
        - Mine: 6000
        - Rocket: 10000
        - Missile: 20000
        - Bit: 40000
    - **武器価格 (コイン)**:
        - Twin Shot: 50
        - Side Shot: 50
        - Homing Shot: 100
        - Laser: 200
        - Mine: 200
        - Rocket: 400
        - Missile: 400
        - Bit: 600
    
    ### 3.3. ゲームプレイ画面 (`STATE_PLAYING`)
    - **概要**: 敵を倒し、スコアを稼ぐメインパート。
    - **表示**: スコア、ハイスコア、現プレイでの獲得コイン、ボム所持数、難易度レベルなど。
    - **操作**:
        - **移動**: 矢印キー、ゲームパッド十字キー/アナログスティック、タッチ(タッチした位置へ追従)。
            - ※タッチ操作は、仮想コントローラとの衝突を避けるロジックが組み込まれている。
        - **メインショット**: 自動で連射される(Rapid Shot)。
        - **ボム**: スペースキー、Bキー、コントローラBボタンで使用。
    - **BGM**: `gameplay`。ボス出現時に`boss`へ遷移。
    
    ### 3.4. ゲームオーバー画面 (`STATE_GAME_OVER`)
    - **表示**:
        - 「GAME OVER」テキスト
        - 死亡理由
        - 最終スコア、累計スコアの変動
        - 次にアンロック可能な武器と、そこまでの必要スコア
    - **操作**: 「スペースキー」「マウス左クリック」「コントローラBボタン」でタイトル画面へ戻る。
    - **処理**: この周回で得たスコアとコインがセーブデータに加算される。
    
    ## 4. ゲームシステム
    
    ### 4.1. プレイヤー
    - **移動速度**: ゲームプレイ時 `2.2` / デッキ画面時 `2.0`
    - **当たり判定**: 4x4 ピクセル (機体中央)
    - **初期状態**: ボム1個所持。ゲーム開始後90フレームは無敵。
    
    ### 4.2. 武器システム
    - **基本**:
        - `Rapid Shot`は常時装備の基本武器。
        - デッキ画面で購入した武器(最大2種)が追加される。
        - 同じ武器を複数回購入するとレベルアップし、性能が向上する。
    - **武器一覧**:
        - **Rapid Shot**: 自動連射の基本ショット。
        - **Twin Shot**: 2連ショット。レベルUPで連射数増加。
        - **Laser**: 持続ダメージを与えるレーザー。レベルUPで本数増加。
        - **Rocket**: 着弾時に爆発する高威力ロケット。レベルUPで連射数増加、クールダウン短縮。
        - **Wide Shot**: 前方3方向へ弾を発射。レベルUPで連射数増加。
        - **Side Shot**: 左右真横へ弾を発射。レベルUPで連射数増加。
        - **Homing Shot**: 敵を追尾するミサイル。レベルUPで連射数増加、クールダウン短縮。
        - **Missile**: 前方へ直進し、敵を貫通するミサイル。レベルUPで連射数増加、クールダウン短縮。
        - **Mine**: 後方へ設置する機雷。敵が近づくと爆発。レベルUPで連射数増加、クールダウン短縮。
        - **Bit**: プレイヤーに追従し、自動で弾を発射するオプション。レベルUPでビットの数が増加。
    
    ### 4.3. 敵
    - **種類**: Zako(小型)、Medium(中型)、Large(大型)、Boss(ボス)の4種類。
    - **出現ロジック**:
        - 時間経過と難易度レベルに応じて、出現間隔が短くなる。
        - 難易度が上がるにつれて、Zakoの出現比率が下がり、Medium/Largeの比率が上がる。
        - Zakoは編隊(Squad)を組んで、多様な攻撃パターンで出現する。
    - **ボス出現条件**:
        - Zakoの撃破数をカウントし、規定数(`zako_needed_for_boss`)に達すると出現。
        - 規定数は難易度レベルに応じて変動する。
    - **行動パターン**: `zigzag`, `wave`, `cycle`, `tornado`など、16種類のZako用攻撃パターンが存在する。
    
    ### 4.4. スコアとコイン
    - **スコア**: 敵を倒す、敵弾をボムで消す等で加算。累計スコアは武器アンロックに使用。
    - **コイン**: 敵を倒すとスコアと同時に加算。武器の購入に使用。
    
    ### 4.5. 難易度
    - **レベル**: ボスを1体倒すごとに1上昇。
    - **影響**: 敵の移動速度、弾速、出現間隔などが上昇する。
    
    ## 5. アセット仕様
    
    ### 5.1. グラフィック
    - **コンセプト**: 8-bit風のシンプルなピクセルアート。Pyxelの16色カラーパレットを基本とする。
    - **データ構造**: 全てのグラフィックは`assets/graphics.json`にテキスト形式で定義。各ドットの色番号を文字列として記録し、起動時に読み込んで画像(テクスチャアトラス)を生成する。
    - **アセットリスト**: `player`, `enemies` (各種), `bullets` (各種), `explosions`, `power_ups`, `particles` など。
    
    ### 5.2. サウンド & BGM
    - **コンセプト**: Pyxel内蔵の波形ジェネレータで作成されたチップチューン。
    - **データ構造**: 全てのSEとBGMのフレーズは`game_logic.py`内の`_create_audio_assets`メソッドで定義される。
    - **SEリスト (抜粋)**:
        - `sounds[0]`: プレイヤーショット
        - `sounds[1]`: 武器ショット
        - `sounds[2]`: ロケット/ミサイルショット
        - `sounds[4]`: 敵被弾
        - `sounds[5]`: 敵破壊
        - `sounds[6]`: プレイヤー被弾/死亡
        - `sounds[7]`: パワーアップ取得
        - `sounds[8]`: ボム発動
    - **BGMリスト**:
        - `musics[0]`: タイトル画面 (`title`)
        - `musics[1]`: ゲームプレイ画面 (`gameplay`)
        - `musics[2]`: ボス戦 (`boss`)
        - `musics[3]`: ゲームオーバー (`game_over`)

    さて、ここからは作り上げての所感。
    最終的に環境を決めるまでよりはこれで行こうと環境決めて落ち着いてからの方が長かったとかあるので、思い出せる限りでの時系列にて。

    初期

    ChatGPTやClaudeでコード書ける様になってるよって話を多方面から伺って、じゃあってんで無料でどこまでできるかな?ってのが始まり。
    実行環境が容易に用意できる、重いことはそもそもしない、という2点から開発環境を探してた。
    最終候補はGodotとPython、最初はGodotを使い、ChatGPTとClaudeで開発を始めた。
    で、速攻で挫折。
    理由はAIのトークン数が少な過ぎてコード生成が全然できなかったから。
    まあ、無料だったらこんなもんか程度に思って、少しずつ進めるかと思っていたら、ヤツが登場して状況が一変。

    中期

    Geminiの登場ですよ。
    というかGemini自体はあったんですけど、こいつの処理トークン数がアホほど増えたので、結構な量のコードを投げてもいいし出力もOKって状態に。
    更に、この頃になるともう直接ファイルをいじってコード修正してもらった方がいいなと思い始めており、LM studioやMCPでのファイル作成にも取り掛かっていた。
    で、そんなところにGemini CLIの登場ですよ。
    MCPもローカルAIも忘れ、Gemini CLIでやることに決めた。
    ついでに、色々と出力させた結果どうもGodotよりPythonの方がこいつちゃんとしてそうだな?となって、開発環境も整っているPythonで最後まで作ることに決めた。
    バージョンも余程のことがない限りは出来上がるまでは今触ってるものから動かさないと決め、Pyxelも導入。
    ここからPyCharmを使い、Pyxelライブラリを使ってやっていくことにした。

    難航

    最初の方は仕様を読み込ませつつ、プロンプトで作業箇所を指示して作ってもらう、ということを繰り返していたが、途中でこれがめちゃくちゃ難航し始める。
    急に過去に修正したものをもう一度直そうとしたり、突然一つのことに固執し始め、コードにそれだけ書いて全消去したりと、このヤロウ!wwwと思うことが続く。
    この時は気づいていなかったんだけど、これトークン数が多過ぎたんよね。
    何度もその不具合にぶち当たってはファイルをロールバックさせて試したが、なかなか前に進めない日々が続いた。
    PyCharmを使っていた理由は実行の手軽さもあるが、ローカル履歴を用いて簡単に破壊前のコードに戻せることが大きい。
    Gitとか使ってないので、こういうコードを守る動きをしてくれるIDE、重要。
    そんな感じでコードは保持できていたが、どうにも扱いづらい日々が続いた。

    解決策

    いくつかあるが、一つずつ、解決するのに役立ったことを。
    まず、一番重要だったのは一回のプロンプトで「考える、修正案を出す、コードを修正する」をいっぺんにさせないこと。
    考えさせて修正案を出すところまではいいけど、絶対にコードの変更をさせない、これ重要。
    これだけで急に動作が安定する様になった。
    いいと思ったらじゃあそれで修正してね、ってお願いする、この流れ、重要。
    次に効果的だったのは、コードを主なクラスごとにファイル分けしたこと。
    ChatGPTに聞いたらお前のコードデカすぎだからGeminiこまっとるぞ?とのことだったので、解決のためにファイルを分割することにした。
    分割はGeminiに考えさせて、分割。
    考えを誘導させてもいいけど、まず考えさせる、このプロセスまじで大事だった。
    最後はGeminiがちょっとでも詰まったなと思ったらもうしばらく触らない。
    Flashになったり回答が戻ってこない時間が長かったり、ループしてたら即終了。
    この状態の時にAI使ってもろくなことにならない、実際、それでかなり苦しんだ。
    肌感的には午後から夕方にかけてはダメだなって思った。
    朝と夜は結構調子いいので、こいつ徹夜好きな夜型人間かもしれねぇ。

    後期

    やった作業を仕様として出力させ、その後のアップデートでおかしなことになっても仕様通りにもう一度やって?って言ってぶっ壊れを防ぎつつ、なんとか形になっていった。
    しかし、ゲームルーチンはできてもグラフィックとサウンドはどうしようもない。
    色々と頑張ってみたが、これはもうこれで限界だった。
    次回の課題にしようと決意し、もう触らないことにした。
    で、ここまで来たら、じゃあってんで公開する方法を色々と確認し、itch.ioに登録、出力するデータのうち、html版だけを公開した。
    今手元にはMac用のパッケージがあり、これはキーボードでもゲームコントローラでも動く唯一のバージョン。
    htmlだと、Safariで動かすとコントローラしか使えなくて、Chromeでやるとキーボードでだけ動かせて、iPhoneだとバーチャルコントローラとコントローラのどちらでもOK、というもう本当によくわからない状態。
    まあ、それでもいいか、ってことで今は公開している。
    公開する方法も、ファイル作成の自動化も、Gemini CLIに解決してもらった。
    ファイルまとめる用のspecファイル作ったり、自動化用のシェルスクリプト作ってもらったり。
    扱う場所がターミナル上ってだけで、別に普通にGeminiとして使えないわけではない。

    終わって

    で、まあAI100%でゲーム作った感想なんだけど、無料でもここまでできるなら、もうお金払ってる人たちのサイクルってAIと検討し続ける>方向性を決める>結構詳細なプランを立てる>AIに実行してもらう(自分は飯)という流れに確実になってるよな、と。
    オートメーションやオーケストレーションで、最初の書類一枚を完璧に作ったらあとは電気とお金が許される限りAIに仕事させてる人はいると思うし、その電気代が人件費より安かったら多少のミスとか許容範囲でしょ。
    あと、仕様をちゃんと切れる人ならセキュリティ面も問題なさそうだなと。
    今それくらい使えるものになってると実感してる。
    自分が見えてないだけかもしれないけど、課題はもっともっとでかいプロジェクトの中で作業者としてどう立ち回せられるか、だよなあ。
    でもこれも情報をちゃんと伝えることさえできれば解決しそう。

    取り急ぎの修正課題

    操作系、これ解決しないといけないんだよなあ。
    WASDで試すか?
    あと、レベル7くらいからボスの動きが怪しい。
    これも修正するか。
    あと、デバッグモードを残したままにしてるから、それ使った時は画面にそうとわかる様な表示させないとだな、この辺まではやろう。

    やろう、というか、やらせるんだけど。
    だって俺、Pythonのコードとか全くわからんのよ。

    AIに作ってもらう上で気をつけること

    Gemini CLIみたいに直接修正できるものだと、平気でファイルとか環境をぶっ壊す可能性があるので、ロールバックできる機能は必須です。
    それが人によってはGitなんだろうけど、自分はローカルでいいやとなって開発環境にPythonでできて履歴も追えるPyCharmを選んだ。
    何をするにしても、CLIやMCP使うならマジでこれだけは重要。
    ここだけ抑えていれば、何でもいいと思う。

    この記事が参加している募集

     
     
    ゲーム系よろず屋さん。ディレクターより仕様書きたい方の人。趣味でApple製品積極的に触ったりしてます。多分ゲーム系とMac関連の記事が多くなる、予定。

    あなたへのおすすめ