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

ソシャゲのサーバーを作った。総合まとめ(完結)

    サーバから作り始めて、16本になりました。
    ひと通り遊べるところまで来たので、
    ここで完結です。

    ブラウザでタイトルをタップして、名前を入れて、ガチャを引いて、 デッキを組んで、戦って、報酬で強くなる、というところまではいってます。

    画像
    16本で作ったもの

    何を作ったか

    以前オフラインで作った「ぱぱぱのヒーローコレクション」に、サーバを実装しました。

    • WSL2 + Docker の上に、MySQL・Redis・Node.js

    • 端末ごとにアカウントを作り、トークンで認証する

    • マスターデータ18テーブルを起動時にメモリへ載せて、認証済みのクライアントに配る

    • ユーザーのデータは9テーブル。所持ヒーロー、デッキ、進捗、通貨、アイテム、ガチャ履歴

    • ガチャ・編成・バトル・報酬・ショップ・強化のAPI

    • ブラウザ側は Vite + React + Three.js。プロトから移植

    フレームワークは入れていません。
    HTTPサーバは node:http だけ、 依存は mysql2 と redis の2つです。
    ローカル環境で動作します。

    通して決めていたこと

    並べると4つでした。

    1. サーバが決めて、クライアントは表示する

    何が出たか、勝ったかどうか、いくら払うか。
    決めるのは全部サーバで、クライアントが送るのは 「どのガチャを何回」「どのステージ」「どの商品」だけです。

    逆に、名前もステータスも並び順もサーバは返しません。
    IDと数値だけ渡して、意味はクライアントがマスタから引く。
    8本目でマスタを配ったのは、このためでした。

    2. 消せるものと、消せないもの

    マスタは全消しして入れ直す。
    ユーザーデータは1行も消さない。
    Redisは消えても作り直せるものだけ置く。

    同じデータベースでも、扱いを変えるものが3つあった、という話ですね。
    テーブルを api_game_master / api_game_user / api_game_system と 分けたのは、これを間違えないためです。

    3. 壊れていたら起動しない

    マスタが読めなければサーバを起動させない(8本目)
    ガチャの確率が1000になっていなければ起動させない(12本目)

    動いてしまってから気づくより、立ち上がらないほうがいい。
    ゲームのサーバは、おかしなデータで動くとお金やキャラの形で被害が出るので。

    4. 失敗したとき、どちらへ倒すか

    各所で失敗やエラーは起きます。
    通信は失敗しますし、DBとRedisは一緒にコミットできません。

    • ガチャで応答が届かない → 引けたか分からないものとして、状態を取り直す

    • 編成の保存に失敗 → 元に戻さず、サーバから取り直す

    • バトルの開始でRedisに書けない → スタミナは減らさない(払ったのに戦えない、を避ける)

    • バトルの終了でDBが失敗 → 報酬は入らない(2回入る、を避ける)

    どちらに倒れても困るときは、あとから直しやすいほうを選ぶ。
    もらえなかったものは補填できますが、回収は結構大変だったりします(ホントに)

    作らなかったもの

    毎回「今回はやらないこと」を決めてから書いていました。

    画像
    作らなかったもの

    ここに挙げたのは、サーバの作りとして入れなかったものです。

    DBは1つしかないのでマイグレーションは要らない。
    課金が無いので二重送信の対策も後回しにできる。
    ランキングが無いので、バトルの検証だけで足りる。

    逆に言うと、これを全部足したものが「運用できるサーバ」です。
    今回作ったのは、そこに行くまでの土台ということになりますね。

    AIとの分担

    設計はClaude、実装はClaude Codeです。
    Claudeとは何を作るか相談して、実装指示書という文書にまとめます。
    記事のドラフトもこちらで書いています。
    Claude Codeにはその指示書1枚を渡して、コードを書いてもらう。

    変わったのは、指示書の書き方でした

    機能が増えるにつれて、「やらないこと」を書く量が増えました。
    書いておかないと、気を利かせて先回りで作ってきます。

    受け入れ条件も、だんだん細かくなりました。
    最後のほうは「DBがこうなっていること」「このエラーコードが返ること」まで書いています。

    実装のあとに報告をもらう形も、途中で固まりました。

    • 指示書と違う名前や形にしたところ

    • 確認できたことと、できていないこと

    これが無いと、次の回の指示書のほうがずれていくんですよね。
    仕様は docs/spec/ に置いて、実装とズレたらコードではなく仕様を直すようにしていました。

    「APIが通る」と「画面が動く」は別でした

    AIの手元にはブラウザがありません。
    確認できるのはAPIまでで、画面は触れないんですよね。

    全部通りました、という報告をもらって開いたら、 起動した瞬間にエラーで止まった、ということがありました。

    なので途中からは、 「ブラウザで確認できない場合は、どの条件が未確認かを明記して」 と指示に入れるようにしています。
    できていないことを、できていないと書いてもらう。
    そこさえはっきりしていれば、あとは自分で開けば済む話なので。

    書いてみて

    技術的に新しいことは、実はあまりありません。
    やったのは、ソシャゲのサーバが普段やっていることを、順番に並べた感じです。

    書き終えて気づいたのは、自分が手を動かした時間がほとんど無いことです。

    コードはClaude Codeが書いています。
    自分がやっていたのは、こっちで行くと決めることでした。

    • 抽選はサーバに置く

    • 編成は差分ではなく、デッキ全体を送る

    • バトルの勝敗は、サーバで再現して決める

    • 二重送信の対策は、今回は入れない

    どれも、正解が1つに決まる話ではありません。
    どちらでも動くけれど、あとでの困り方が変わる。
    その分かれ道が、16本のあいだ、ずっと出てきました。

    実装を任せるようになって、その部分だけが自分の仕事として残りました。
    手を動かしていないのに、疲れるのはこっちでしたが(笑)

    サービスまで仕上げるなら

    ここまではサーバの中の話です。

    遊んでみると、オーソドックスなソシャゲです。
    と言っても今では普通にあるものがないので伸び代はあります(笑)

    これをサービスまで仕上げるとしたら、
    •法務関連
    •マネタイズのためのロジック、販売物
    •KPI指標と分析ツール、ログ仕込み
    これは間違いなく必要です。

    今はブラウザ版ですが、
    アプリにするならクライアントアプリを作る。
    ストア周りの手続き、審査、ストア対応。

    あとインフラまわり。
    クラウドでやるのか、セルフホスティングなのか。
    デプロイどうする、CI何使う、ドメインなども。

    機能面でも
    •お知らせ、お問い合わせ
    •ログインボーナス
    •フレンド、ギルド
    •リテンション施策
    •イベント
    •プッシュ通知
    •アカウント連携、引き継ぎ
    他もろもろ、たくさんありますね。

    今回ここまで作りましたが、
    製品としては、まだまだ入り口に立ったくらいの段階だったりします。
    意外とやることあるんですよね(汗)

    おわりに

    ひとまずは
    動くものができたこと、
    AI活用していく上でのトレーニング、
    ちょっとした達成感がありました(笑)
    また何か作ってみようと思います。

    【最後まで読んでいただきありがとうございます!】 面白かったと感じた方は、ぜひ「スキ」と「フォロー」をお願いします!

    関連記事


     
     
    泥臭い現場のリアルを語る現役エンジニア ゲーム開発歴30年。会社員・フリーランスの両方で修羅場をくぐり抜けてきた50代現役サーバプログラマです

    あなたへのおすすめ