
ソシャゲのサーバーを作る。第二部まとめ
ブラウザで動くソーシャルゲームを作っています。
第二部の6本で、ひと通り遊べるところまで来ました。
ここでまとめます。

できること
タイトルをタップすると、名前を入れてプロローグが流れる
2回目からはホームに直行する
ガチャを回してヒーローが増える
所持ヒーローを並べて、4人のデッキを組む
ステージを選んで、オートかセミオートで戦う
勝つとゴールド・素材・EXPが入り、次のステージが開く
プレイヤーLvが上がるとスタミナ上限が増える
ショップで素材と回復剤を買い、ヒーローを強化する
ゲームとして最初から最後まで回るようになりました。

6本でやったこと
11. ホームまでたどり着く
チュートリアルの進捗を `user_status` に1列足して、名前入力を出すかどうかをサーバが決める形に。
ホームAPIは起動時に必ず通る入口。ただし太らせない。
12. ガチャを回す
抽選をサーバへ。レアリティ → ヒーローの2段階で引く。
確率はマスタに入っていて、壊れていたらサーバを起動させない。
13. ヒーロー一覧とデッキ編成
所持一覧は全件返す。編成は差分ではなくデッキ全体を送る。
ステータスの計算は整数で。ここがバトルにつながる。
14. ステージ選択とバトル
勝敗はサーバが決める。クライアントの入力の列だけを受け取って、同じバトルを回し直す。
そのためにバトルのコードを1つだけ書いて、サーバとクライアントの両方から読む形にした。
15. バトルの報酬
ゴールド・素材・EXP・Lvアップ・初回クリアボーナスを1つのトランザクションで。
テーブルが増えてきたので、行ロックの順番を一覧にした。
16. ショップと強化
集めたものを使う側。通貨とアイテムの増減を1か所にまとめた。
第二部で決めたこと
第一部は「土台をどう作るか」でしたが、第二部はどこまでサーバが決めるかの連続でした。
サーバが決めるもの
チュートリアルをどこまで進んだか
ガチャで何が出たか
バトルに勝ったかどうか
もらえる報酬と、上がるレベル
買えるかどうか、いくら払うか
クライアントが送るのは「どのガチャを何回」「どのステージ」「どの商品」「必殺を撃ったかどうか」だけです。
金額も結果も、クライアントからは受け取りません。
クライアントに任せるもの
名前やステータスの表示(IDだけ渡して、マスタから引いてもらう)
所持一覧の並び順
バトルの演出
サーバが計算して渡すのではなく、IDと数値だけ渡して、意味はクライアントが引く。
8本目でマスタを配ったのは、このためでした。
1つだけ、両方でやるもの
バトルの計算です。
クライアントは見せるために、サーバは判定するために、同じ計算をします。
同じ計算を2回書くとずれるので、コードは1つだけ書いて共有しました。
サーバもクライアントもTypeScriptなので、こういう形が取れます。

ずれない計算にするために、バトルもステータスも整数だけで計算しています。
失敗したときにどうするか
第二部でいちばん多く考えたのは、たぶんこれです。
通信は失敗します。
サーバでは処理が終わっているのに、応答だけ届かないこともある。
ガチャ:引けたかどうか分からないので、ホームを取り直す
編成:保存できたか分からないので、元に戻さず、サーバから取り直す
バトル:終了は `GETDEL` で1回だけ。2回報酬が入ることは起きない
取り直せば、画面に出ているものが必ずサーバの状態になる。
これが第二部を通しての方針になりました。
DBに書く順番も決めました。
user_status → user_stage → user_currency → user_item → user_deck → user_heroどのAPIも、この順番でしか行を押さえません。
テーブルが7つあると、APIごとに考えるより一覧にして貼っておくほうが確実です。
AIをどう使ったか
第一部と同じで、Claudeが設計、Claude Codeが実装です。
第二部で変わったのは、指示書の書き方ですね。
機能が増えるにつれて、「この回で作らないもの」を書く量が増えました。
やらないことを書いておかないと、気を利かせて作ってきます。
受け入れ条件も、DBの中身まで書くようになりました。
実装後の報告も、毎回もらう形に落ち着きました。
指示書と違う名前や形にしたところ
確認できたことと、できていないこと
次の回の指示書が前の回の実装に依存するので、
違う形にしたところを教えてもらわないと、指示書のほうがずれていきます。
見逃しもありました
14本目で、APIの確認は全部通っているのにブラウザで起動しない、ということがありました。
原因は、マスタの配信キーが古いままだったこと。
サーバの再起動で直ったのですが、「APIが通る」と「画面が動く」は別、というのを一度踏みました。
以降は「ブラウザで確認できない場合は、どの条件が未確認かを明記して」と指示に入れています。
次回
総合まとめです。
第一部と第二部を通して、何を作って、何を作らなかったかを並べます。
作らなかったもののほうが、たぶん面白い回になります。
連番マイグレーション、二重送信の防止、所持上限、購入制限、ランキング。
どれも「今は要らない」で先送りしたもので、運用が始まると必ず必要になるものです。
第一部について
土台の10本は第一部にまとまっています。
Docker、認証、Redis、マスターデータ、ユーザーのテーブル。
今回の6本は、全部その上に載っています。
記事一覧
第二部の6本です。
(記事は巻末のリンクから)
ホームまでたどり着く
ガチャを回す
ヒーロー一覧とデッキ編成
ステージ選択とバトル
バトルの報酬
ショップと強化
【最後まで読んでいただきありがとうございます!】
面白かったと感じた方は、ぜひ「スキ」と「フォロー」をお願いします!