CODE SURVIVOR

1. 受け取るもの: snapshot

snapshot["time"]                  経過秒数
snapshot["player"]["x"]           自機のX座標
snapshot["player"]["y"]           自機のY座標
snapshot["player"]["hp"]          今のHP
snapshot["player"]["maxHp"]       最大HP
snapshot["player"]["level"]       今のレベル
snapshot["player"]["weapons"]     装備中の武器 例: ["shoot", "blast"]
snapshot["player"]["nearbyBullets"]  近くにある敵弾の数
snapshot["player"]["stats"]["attackRange"]  射程
    （他に attackPower / attackInterval / bulletSpeed /
      bulletCount / moveSpeedMultiplier / maxHp）
snapshot["enemies"]               敵のリスト（0体のこともある）
    enemy["id"]      敵の番号。shoot / blast で狙う相手に使う
    enemy["x"]       敵のX座標
    enemy["y"]       敵のY座標
    enemy["hp"]      敵の残りHP
    enemy["maxHp"]   敵の最大HP
    enemy["radius"]  敵の大きさ
    enemy["type"]    敵の種類。次の12種のどれか

1-1. enemy["type"] の12種

同じ倒し方で全部に通るわけではありません。 enemy["type"] を == で比べて狙う相手や武器を変えると、 下の4種（deflector / healer / seeker / absorber）が一気に楽になります。

"chaser"     まっすぐ追ってくる。いちばん普通の敵
"swarm"      小型で速い。まとまって来るので範囲攻撃が効く
"shooter"    離れた位置から弾を撃つ
"turret"     動かない。射程900から3発の斉射（0.6秒の予兆が出る）と、
             半径200に触れているだけで削られる近接オーラを持つ
"healer"     1秒ごとに周りの敵のHPを回復する。放置すると敵が減らない。
             for で敵を走査して、この1体を先に倒すと前線が崩せる
"splitter"   倒すと "splitling" が3体出る。1体ずつ倒すだけでは数が減らない
"splitling"  splitter が分裂して出た小型。速いが柔らかい
"deflector"  飛んでいく弾（shoot と intercept）を0ダメージで弾く。
             弾を作らない blast / laser / chain / snipe なら通る
"seeker"     追ってくる弾を撃つ。歩いて振り切れないので、
             intercept / shield / aegis で落とすか、切り返して外す
"absorber"   自分と半径150以内の敵への、まとめて巻き込む攻撃（blast / laser /
             chain / gravity）を 1/4 に吸収する。1体だけを狙う shoot / snipe /
             intercept は通るので、for で探してこの1体を先に倒す
"boss"       ボス。撃破でゲームクリア
"core"       ボスの装甲。第2形態から3体がボスの周りを回り、1体でも残っている間は
             ボスへのダメージが半分になる。for で探して、ボスより先に倒す

2. 返すもの: Action のリスト

[{"type": "idle"}]                                    何もしない
[{"type": "shoot", "targetEnemyId": id, "angle": a}]  単体射撃（いつでも使える）
[{"type": "blast", "targetEnemyId": id}]              範囲爆発（装備が必要）
[{"type": "laser", "angle": a}]                       貫通ビーム（装備が必要）
[{"type": "intercept"}]                               自動迎撃（装備が必要）
[{"type": "snipe", "targetEnemyId": id, "angle": a}]  長距離狙撃（装備が必要）
    射程が無く必ず当たる。硬い1体を安全な距離から削る
[{"type": "chain", "targetEnemyId": id}]              連鎖放電（装備が必要）
    起点から近い敵へ最大5回飛び移る。1回ごとに威力が下がる
[{"type": "gravity", "x": px, "y": py}]               引力場（装備が必要）
    その点へ敵を引き寄せる。ダメージはほぼ無く、集めてから撃つための武器
[{"type": "shield"}]                                  防御膜（装備が必要）
    2秒間、触れた敵弾を消す。intercept は1発ずつ、shield は面で防ぐ

進化武器（素材の武器がLv3になり、相方を装備していると
レベルアップに進化カードが出る。素材は装備から外れて1枠に畳まれる）

[{"type": "singularity", "x": px, "y": py}]           特異点（gravity + blast）
    引き寄せてから爆発するまでを1つの行動に畳む。
    "targetEnemyId": id でも撃てる。レベルで爆発の回数が増える（1→5回）
[{"type": "railgun", "angle": a}]                     レールガン（snipe + laser）
    射程が無制限の貫通。"targetEnemyId": id を足すとその敵へ向く。
    レベルで本数が増え、近い敵から順に別々の敵へ向く（1→5本）
[{"type": "tempest", "targetEnemyId": id}]            テンペスト（chain + blast）
    7回連鎖しながら着弾点ごとに爆発する（着弾した敵にも爆発が入る）。targetEnemyId は省略できる。
    レベルで爆発の半径が広がる（60→140px）
[{"type": "aegis"}]                                   イージス（shield + intercept）
    展開している間、触れた敵弾を落とし続け、落とした弾の数だけ最寄りの敵へ撃ち返す。
    レベルで展開が長くなる（4→6秒。Lv5 は切れ目なし）

angle（向き・ラジアン）  右 0.0 / 下 1.5708 / 左 3.14159 / 上 -1.5708

リストなので、要素を増やせば1回の判断で同時に撃てる。
未装備の武器を返してもその行動は起きない（shoot で戦う）。
今どれを装備しているかは snapshot["player"]["weapons"] で分かる。

3. 使える書き方 / 使えない書き方

安全のため、このゲームのPythonは入門文法だけに絞ってあります。 「使えない」ものは文法として間違っているわけではなく、ここでは受け付けないというだけです。

decide(snapshot) は必ず1つ定義し、必ずリストを返します。 敵が0体のときも [{"type": "idle"}] のように何かを返す必要があります。

4. 使える関数（組み込み関数）

関数(値) と書くと、その関数が計算した結果の値が返ってきます。 x = len(enemies) のように変数へ入れて使います。

len(リスト)

要素の数を数える。len(enemies) は敵の数。0 と比べれば「敵がいない」の判定になる。

abs(数)

符号を外した大きさ。abs(-3) は 3。左右どちらにずれていても「ずれの大きさ」を比べられる。

min(a, b) / max(a, b)

小さいほう / 大きいほうを返す。リストを渡すと min(リスト) でその中の最小・最大になる。

sum(リスト)

数値のリストの合計。sum(リスト) / len(リスト) で平均が出せる。

round(数)

四捨五入して整数にする。round(1.6) は 2、round(1.4) は 1。

int(数) / float(数)

int は小数点以下を切り捨てて整数に（int(1.9) は 1）。float は小数にする。

range(n)

0 から n-1 までの数の並び。for i in range(3): は i が 0, 1, 2 と変わりながら3回繰り返す。

enumerate(リスト)

「何番目か」と「中身」を同時に取り出す。 for i, enemy in enumerate(enemies): と書くと、i に 0, 1, 2… が、enemy に敵が入る。

bool(値)

真か偽かに変換する。0 と空のリストが偽、それ以外は真。

5. 自作関数（def）

同じ計算を何度も書く代わりに、def で名前を付けて切り出せます。 decide 自身も def で作った関数で、違いは呼ぶのがゲーム側だという点だけです。

def get_angle(dx, dy):          # 名前と、受け取る値（引数）を決める
    if abs(dx) >= abs(dy):      # 中身は字下げして書く
        return 0.0 if dx >= 0 else 3.14159
    return 1.5708 if dy >= 0 else -1.5708

def decide(snapshot):
    ...
    angle = get_angle(dx, dy)   # 呼ぶと return した値が返ってくる
    return [{"type": "shoot", "targetEnemyId": target["id"], "angle": angle}]

• 定義しただけでは動きません。呼ばれて初めて中身が実行されます。
• return に届かないまま関数が終わると、値は返らず None になります。
• 関数の中で作った変数は、その関数の中だけのものです。外からは見えません。
• decide より前に定義しておくと、読む順番とコードの順番が揃って分かりやすくなります。