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"]    "chaser" / "swarm" / "shooter" / "boss"

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 は面で防ぐ

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 より前に定義しておくと、読む順番とコードの順番が揃って分かりやすくなります。