zombie-escape 1.7.1__py3-none-any.whl → 1.10.0__py3-none-any.whl

zombie_escape/input_utils.py

@@ -0,0 +1,167 @@
+from __future__ import annotations
+
+from typing import Tuple
+
+import pygame
+
+DEADZONE = 0.25
+JOY_BUTTON_A = 0
+JOY_BUTTON_BACK = 6
+JOY_BUTTON_START = 7
+JOY_BUTTON_RB = 5
+
+CONTROLLER_AVAILABLE = hasattr(pygame, "controller")
+CONTROLLER_DEVICE_ADDED = getattr(pygame, "CONTROLLERDEVICEADDED", None)
+CONTROLLER_DEVICE_REMOVED = getattr(pygame, "CONTROLLERDEVICEREMOVED", None)
+CONTROLLER_BUTTON_DOWN = getattr(pygame, "CONTROLLERBUTTONDOWN", None)
+CONTROLLER_BUTTON_A = getattr(pygame, "CONTROLLER_BUTTON_A", None)
+CONTROLLER_BUTTON_BACK = getattr(pygame, "CONTROLLER_BUTTON_BACK", None)
+CONTROLLER_BUTTON_START = getattr(pygame, "CONTROLLER_BUTTON_START", None)
+CONTROLLER_BUTTON_DPAD_UP = getattr(pygame, "CONTROLLER_BUTTON_DPAD_UP", None)
+CONTROLLER_BUTTON_DPAD_DOWN = getattr(pygame, "CONTROLLER_BUTTON_DPAD_DOWN", None)
+CONTROLLER_BUTTON_DPAD_LEFT = getattr(pygame, "CONTROLLER_BUTTON_DPAD_LEFT", None)
+CONTROLLER_BUTTON_DPAD_RIGHT = getattr(pygame, "CONTROLLER_BUTTON_DPAD_RIGHT", None)
+CONTROLLER_BUTTON_RB = getattr(pygame, "CONTROLLER_BUTTON_RIGHTSHOULDER", None)
+CONTROLLER_AXIS_LEFTX = getattr(pygame, "CONTROLLER_AXIS_LEFTX", None)
+CONTROLLER_AXIS_LEFTY = getattr(pygame, "CONTROLLER_AXIS_LEFTY", None)
+CONTROLLER_AXIS_TRIGGERRIGHT = getattr(
+    pygame, "CONTROLLER_AXIS_TRIGGERRIGHT", None
+)
+
+
+def init_first_controller() -> pygame.controller.Controller | None:
+    if not CONTROLLER_AVAILABLE:
+        return None
+    try:
+        if pygame.controller.get_count() > 0:
+            controller = pygame.controller.Controller(0)
+            if not controller.get_init():
+                controller.init()
+            return controller
+    except pygame.error:
+        return None
+    return None
+
+
+def init_first_joystick() -> pygame.joystick.Joystick | None:
+    try:
+        if pygame.joystick.get_count() > 0:
+            joystick = pygame.joystick.Joystick(0)
+            if not joystick.get_init():
+                joystick.init()
+            return joystick
+    except pygame.error:
+        return None
+    return None
+
+
+def is_confirm_event(event: pygame.event.Event) -> bool:
+    if CONTROLLER_BUTTON_DOWN is not None and event.type == CONTROLLER_BUTTON_DOWN:
+        return CONTROLLER_BUTTON_A is not None and event.button == CONTROLLER_BUTTON_A
+    if event.type == pygame.JOYBUTTONDOWN:
+        return event.button == JOY_BUTTON_A
+    return False
+
+
+def is_start_event(event: pygame.event.Event) -> bool:
+    if CONTROLLER_BUTTON_DOWN is not None and event.type == CONTROLLER_BUTTON_DOWN:
+        return (
+            CONTROLLER_BUTTON_START is not None
+            and event.button == CONTROLLER_BUTTON_START
+        )
+    if event.type == pygame.JOYBUTTONDOWN:
+        return event.button == JOY_BUTTON_START
+    return False
+
+
+def is_select_event(event: pygame.event.Event) -> bool:
+    if CONTROLLER_BUTTON_DOWN is not None and event.type == CONTROLLER_BUTTON_DOWN:
+        return (
+            CONTROLLER_BUTTON_BACK is not None
+            and event.button == CONTROLLER_BUTTON_BACK
+        )
+    if event.type == pygame.JOYBUTTONDOWN:
+        return event.button == JOY_BUTTON_BACK
+    return False
+
+
+def read_gamepad_move(
+    controller: pygame.controller.Controller | None,
+    joystick: pygame.joystick.Joystick | None,
+    *,
+    deadzone: float = DEADZONE,
+) -> Tuple[float, float]:
+    x = 0.0
+    y = 0.0
+    if controller and controller.get_init():
+        if CONTROLLER_AXIS_LEFTX is None or CONTROLLER_AXIS_LEFTY is None:
+            return 0.0, 0.0
+        x = float(controller.get_axis(CONTROLLER_AXIS_LEFTX))
+        y = float(controller.get_axis(CONTROLLER_AXIS_LEFTY))
+        if abs(x) < deadzone:
+            x = 0.0
+        if abs(y) < deadzone:
+            y = 0.0
+        if (
+            CONTROLLER_BUTTON_DPAD_LEFT is not None
+            and controller.get_button(CONTROLLER_BUTTON_DPAD_LEFT)
+        ):
+            x = -1.0
+        elif (
+            CONTROLLER_BUTTON_DPAD_RIGHT is not None
+            and controller.get_button(CONTROLLER_BUTTON_DPAD_RIGHT)
+        ):
+            x = 1.0
+        if (
+            CONTROLLER_BUTTON_DPAD_UP is not None
+            and controller.get_button(CONTROLLER_BUTTON_DPAD_UP)
+        ):
+            y = -1.0
+        elif (
+            CONTROLLER_BUTTON_DPAD_DOWN is not None
+            and controller.get_button(CONTROLLER_BUTTON_DPAD_DOWN)
+        ):
+            y = 1.0
+        return x, y
+
+    if joystick and joystick.get_init():
+        if joystick.get_numaxes() >= 2:
+            x = float(joystick.get_axis(0))
+            y = float(joystick.get_axis(1))
+            if abs(x) < deadzone:
+                x = 0.0
+            if abs(y) < deadzone:
+                y = 0.0
+        if joystick.get_numhats() > 0:
+            hat_x, hat_y = joystick.get_hat(0)
+            if hat_x:
+                x = float(hat_x)
+            if hat_y:
+                y = float(-hat_y)
+    return x, y
+
+
+def is_accel_active(
+    keys: pygame.key.ScancodeWrapper,
+    controller: pygame.controller.Controller | None,
+    joystick: pygame.joystick.Joystick | None,
+) -> bool:
+    if keys[pygame.K_LSHIFT] or keys[pygame.K_RSHIFT]:
+        return True
+    if controller and controller.get_init():
+        if (
+            CONTROLLER_BUTTON_RB is not None
+            and controller.get_button(CONTROLLER_BUTTON_RB)
+        ):
+            return True
+        if CONTROLLER_AXIS_TRIGGERRIGHT is not None:
+            if controller.get_axis(CONTROLLER_AXIS_TRIGGERRIGHT) > DEADZONE:
+                return True
+    if joystick and joystick.get_init():
+        if joystick.get_numbuttons() > JOY_BUTTON_RB:
+            if joystick.get_button(JOY_BUTTON_RB):
+                return True
+        if joystick.get_numaxes() > 5:
+            if joystick.get_axis(5) > DEADZONE:
+                return True
+    return False

zombie_escape/level_blueprints.py

@@ -6,6 +6,7 @@ EXITS_PER_SIDE = 1  # currently fixed to 1 per side (can be tuned)
 NUM_WALL_LINES = 80  # reduced density (roughly 1/5 of previous 450)
 WALL_MIN_LEN = 3
 WALL_MAX_LEN = 10
+SPARSE_WALL_DENSITY = 0.10
 SPAWN_MARGIN = 3  # keep spawns away from walls/edges
 SPAWN_ZOMBIES = 3
 
@@ -201,10 +202,37 @@ def _place_walls_grid_wire(grid: list[list[str]]) -> None:
                 grid[y][x] = "1"
 
 
+def _place_walls_sparse(grid: list[list[str]]) -> None:
+    """Place isolated wall tiles at a low density, avoiding adjacency."""
+    cols, rows = len(grid[0]), len(grid)
+    forbidden = _collect_exit_adjacent_cells(grid)
+    for y in range(2, rows - 2):
+        for x in range(2, cols - 2):
+            if (x, y) in forbidden:
+                continue
+            if grid[y][x] != ".":
+                continue
+            if RNG.random() >= SPARSE_WALL_DENSITY:
+                continue
+            if (
+                grid[y - 1][x] == "1"
+                or grid[y + 1][x] == "1"
+                or grid[y][x - 1] == "1"
+                or grid[y][x + 1] == "1"
+                or grid[y - 1][x - 1] == "1"
+                or grid[y - 1][x + 1] == "1"
+                or grid[y + 1][x - 1] == "1"
+                or grid[y + 1][x + 1] == "1"
+            ):
+                continue
+            grid[y][x] = "1"
+
+
 WALL_ALGORITHMS = {
     "default": _place_walls_default,
     "empty": _place_walls_empty,
     "grid_wire": _place_walls_grid_wire,
+    "sparse": _place_walls_sparse,
 }
 
 

zombie_escape/locales/ui.en.json

@@ -28,7 +28,7 @@
       "hints": {
         "navigate": "Up/Down: choose an option",
         "page_switch": "Left/Right: switch stage groups",
-        "confirm": "Enter/Space: activate selection"
+        "confirm": "Enter/Space/South: activate selection"
       },
       "option_help": {
         "settings": "Open Settings to adjust assists and localization.",
@@ -56,7 +56,12 @@
           "line1": "It hurts!",
           "line2": "I can't hold on!",
           "line3": "Stay back!"
-        }
+        },
+        "survivor_conversion_messages": [
+          "It hurts!",
+          "I can't hold on!",
+          "Stay back!"
+        ]
       },
       "stage5": {
         "name": "#5 Survive Until Dawn",
@@ -75,8 +80,45 @@
         "description": "Narrow corridors. Get surrounded, and there’s no escape."
       },
       "stage9": {
-        "name": "# Evacuate Survivors 2",
-        "description": "Evacuate like stage 4, but narrow corridors. Requires fuel."
+        "name": "#9 Evacuate Survivors 2",
+        "description": "Evacuate like stage 4, but narrow corridors. Requires fuel.",
+        "survivor_conversion_messages": [
+          "It hurts!",
+          "I can't hold on!",
+          "Stay back!",
+          "Stop!"
+        ]
+      },
+      "stage10": {
+        "name": "#10 Outbreak",
+        "description": "Zombies have infiltrated a building where survivors took shelter.",
+        "survivor_conversion_messages": [
+          "It hurts!",
+          "I can't hold on!",
+          "Stay back!",
+          "Stop!",
+          "Whoa!",
+          "Eeeeek!",
+          "Noooo!",
+          "Help me!",
+          "Get away!",
+          "Someone help!",
+          "Don't touch me!",
+          "No, no, no!",
+          "Please!"
+        ]
+      },
+      "stage11": {
+        "name": "#11 Don't Look Back!",
+        "description": "Left or right. Trust your instinct."
+      },
+      "stage12": {
+        "name": "#12 OVERHEAD HAZARD",
+        "description": "An open factory floor. Zombies may fall from above."
+      },
+      "stage13": {
+        "name": "#13 Rescue Buddy 3",
+        "description": "Rescue your buddy. Zombies may fall from above."
       }
     },
     "status": {
@@ -91,10 +133,10 @@
     "hud": {
       "need_fuel": "Need fuel to drive!",
       "paused": "PAUSED",
-      "resume_hint": "Press P or click to resume",
-      "survival_timer_label": "Until dawn %{time}",
+      "pause_hint": "P/Start: Resume · ESC/Select: Return to Title",
+      "endurance_timer_label": "Until dawn %{time}",
       "time_accel": ">> 4x",
-      "time_accel_hint": "Hold Shift: 4x"
+      "time_accel_hint": "Hold Shift/R1: 4x"
     },
     "survivors": {
       "too_many_aboard": "Too many aboard!"
@@ -117,11 +159,13 @@
     "settings": {
       "title": "Settings",
       "sections": {
+        "menu": "Menu",
         "localization": "Localization",
         "player_support": "Player support",
         "tougher_enemies": "Tougher enemies"
       },
       "rows": {
+        "return_to_title": "Return to Title",
         "language": "Language",
         "footprints": "Footprints",
         "car_hint": "Car hint",
@@ -131,9 +175,9 @@
       "hints": {
         "navigate": "Up/Down: select a setting",
         "adjust": "Left/Right: set value",
-        "toggle": "Space/Enter: toggle value",
+        "toggle": "Space/Enter/South: toggle value",
         "reset": "R: reset to defaults",
-        "exit": "Esc/Backspace: save and return",
+        "exit": "Esc/BS/Select: save and return",
         "fullscreen": "F: toggle fullscreen"
       },
       "config_path": "Config: %{path}",
@@ -146,10 +190,10 @@
     "game_over": {
       "win": "YOU ESCAPED!",
       "lose": "GAME OVER",
-      "prompt": "ESC/SPACE: Title · R: Retry",
+      "prompt": "ESC/SPACE/Select/South: Title · R: Retry",
       "scream": "AAAAHHH!!",
       "survivors_summary": "Evacuated: %{count}",
-      "survival_duration": "Time survived %{time}"
+      "endurance_duration": "Time survived %{time}"
     }
   }
 }

zombie_escape/locales/ui.ja.json

@@ -28,7 +28,7 @@
       "hints": {
         "navigate": "上下: 項目選択",
         "page_switch": "左右: ステージ群切替",
-        "confirm": "Enter/Space: 決定または実行"
+        "confirm": "Enter/Space/South: 決定または実行"
       },
       "option_help": {
         "settings": "設定画面を開いて言語や補助オプションを変更します。",
@@ -56,7 +56,12 @@
           "line1": "痛いぃ！",
           "line2": "無理！無理！",
           "line3": "来るなぁ！"
-        }
+        },
+        "survivor_conversion_messages": [
+          "痛いぃ！",
+          "無理！無理！",
+          "来るなぁ！"
+        ]
       },
       "stage5": {
         "name": "#5 持久戦",
@@ -76,7 +81,44 @@
       },
       "stage9": {
         "name": "#9 生存者救出 2",
-        "description": "ステージ4と同じだが、狭い通路。燃料も必要。"
+        "description": "ステージ4と同じだが、狭い通路。燃料も必要。",
+        "survivor_conversion_messages": [
+          "痛いぃ！",
+          "無理！無理！",
+          "来るなぁ！",
+          "やめてぇ！"
+        ]
+      },
+      "stage10": {
+        "name": "#10 感染爆発",
+        "description": "建物に避難した生存者の中にゾンビが紛れ込んでいた。",
+        "survivor_conversion_messages": [
+          "痛いぃ！",
+          "無理！無理！",
+          "来るなぁ！",
+          "やめてぇ！",
+          "うわっ！",
+          "ひいいぃ",
+          "いやああ",
+          "助けて！",
+          "近寄るな！",
+          "誰か！",
+          "触るな！",
+          "やだ、やだ！",
+          "誰かー！"
+        ]
+      },
+      "stage11": {
+        "name": "#11 振り返るな！",
+        "description": "右か左か。直感を信じて。"
+      },
+      "stage12": {
+        "name": "#12 頭上注意",
+        "description": "吹き抜けの工場。落ちてくるゾンビあり。"
+      },
+      "stage13": {
+        "name": "#13 相棒を救え 3",
+        "description": "はぐれた相棒を救え。ゾンビの落下あり。"
       }
     },
     "status": {
@@ -91,10 +133,10 @@
     "hud": {
       "need_fuel": "燃料が必要です！",
       "paused": "一時停止",
-      "resume_hint": "Pキーかクリックで再開",
-      "survival_timer_label": "夜明けまであと %{time}",
+      "pause_hint": "P/Start: ゲーム再開  ESC/Select: タイトルに戻る",
+      "endurance_timer_label": "夜明けまであと %{time}",
       "time_accel": ">> 4x",
-      "time_accel_hint": "Shiftキー押下: 4x"
+      "time_accel_hint": "Shift/R1押下: 4x"
     },
     "survivors": {
       "too_many_aboard": "定員オーバー！"
@@ -117,11 +159,13 @@
     "settings": {
       "title": "設定",
       "sections": {
+        "menu": "メニュー",
         "localization": "言語設定",
         "player_support": "サポート",
         "tougher_enemies": "強敵"
       },
       "rows": {
+        "return_to_title": "タイトルに戻る",
         "language": "テキスト言語",
         "footprints": "足跡",
         "car_hint": "車のヒント",
@@ -131,9 +175,9 @@
       "hints": {
         "navigate": "上下: 項目選択",
         "adjust": "左右: 値の設定",
-        "toggle": "スペース／エンター: 値のトグル",
+        "toggle": "Space/Enter/South: 値のトグル",
         "reset": "R: デフォルト設定に戻す",
-        "exit": "Esc/BS: セーブして戻る",
+        "exit": "Esc/BS/Select: セーブして戻る",
         "fullscreen": "F: フルスクリーン切替"
       },
       "config_path": "設定ファイル: %{path}",
@@ -146,10 +190,10 @@
     "game_over": {
       "win": "脱出成功！",
       "lose": "ゲームオーバー",
-      "prompt": "ESC/Space: タイトルへ  R: 再挑戦",
+      "prompt": "ESC/Space/Select/South: タイトルへ  R: 再挑戦",
       "scream": "ぎゃあーーー!!",
       "survivors_summary": "救出人数: %{count}",
-      "survival_duration": "逃げ延びた時間 %{time}"
+      "endurance_duration": "逃げ延びた時間 %{time}"
     }
   }
 }

zombie_escape/localization.py

@@ -108,6 +108,13 @@ def translate_dict(key: str) -> dict[str, Any]:
     return result if isinstance(result, dict) else {}
 
 
+def translate_list(key: str) -> list[Any]:
+    if not _CONFIGURED:
+        set_language(_CURRENT_LANGUAGE)
+    result = _lookup_locale_value(key)
+    return result if isinstance(result, list) else []
+
+
 def get_font_settings(*, name: str = "primary") -> FontSettings:
     _get_language_options()  # ensure locale data is loaded
     locale_data = _LOCALE_DATA.get(_CURRENT_LANGUAGE) or _LOCALE_DATA.get(
@@ -128,6 +135,26 @@ def _qualify_key(key: str) -> str:
     return key if key.startswith("ui.") else f"ui.{key}"
 
 
+def _lookup_locale_value(key: str) -> Any:
+    locale_data = _LOCALE_DATA.get(_CURRENT_LANGUAGE) or _LOCALE_DATA.get(
+        DEFAULT_LANGUAGE, {}
+    )
+    if not isinstance(locale_data, dict):
+        return None
+    qualified = _qualify_key(key)
+    path = qualified.split(".")
+    if path and path[0] == "ui":
+        path = path[1:]
+    current: Any = locale_data
+    for segment in path:
+        if not isinstance(current, dict):
+            return None
+        current = current.get(segment)
+        if current is None:
+            return None
+    return current
+
+
 def _get_language_options() -> tuple[LanguageOption, ...]:
     global _LANGUAGE_OPTIONS
     if _LANGUAGE_OPTIONS is not None:
@@ -182,5 +209,6 @@ __all__ = [
     "language_options",
     "set_language",
     "translate",
+    "translate_list",
     "translate_dict",
 ]

zombie_escape/models.py

@@ -9,7 +9,11 @@ import pygame
 from pygame import sprite, surface
 
 from .entities_constants import ZOMBIE_AGING_DURATION_FRAMES
-from .gameplay_constants import SURVIVOR_SPAWN_RATE, ZOMBIE_SPAWN_DELAY_MS
+from .gameplay_constants import (
+    DEFAULT_FLASHLIGHT_SPAWN_COUNT,
+    SURVIVOR_SPAWN_RATE,
+    ZOMBIE_SPAWN_DELAY_MS,
+)
 from .level_constants import DEFAULT_GRID_COLS, DEFAULT_GRID_ROWS
 from .localization import translate as tr
 
@@ -26,6 +30,41 @@ class LevelLayout:
     outside_rects: list[pygame.Rect]
     walkable_cells: list[pygame.Rect]
     outer_wall_cells: set[tuple[int, int]]
+    wall_cells: set[tuple[int, int]]
+    fall_spawn_cells: set[tuple[int, int]]
+    bevel_corners: dict[tuple[int, int], tuple[bool, bool, bool, bool]]
+
+
+@dataclass
+class FallingZombie:
+    """Represents a zombie falling toward a target position."""
+
+    start_pos: tuple[int, int]
+    target_pos: tuple[int, int]
+    started_at_ms: int
+    pre_fx_ms: int
+    fall_duration_ms: int
+    dust_duration_ms: int
+    tracker: bool
+    wall_follower: bool
+    dust_started: bool = False
+
+
+@dataclass
+class DustRing:
+    """Short-lived dust ring spawned on impact."""
+
+    pos: tuple[int, int]
+    started_at_ms: int
+    duration_ms: int
+
+
+@dataclass(frozen=True)
+class Footprint:
+    """Tracked player footprint."""
+
+    pos: tuple[float, float]
+    time: int
 
 
 @dataclass
@@ -38,8 +77,8 @@ class ProgressState:
     game_over_at: int | None
     scaled_overview: surface.Surface | None
     overview_created: bool
-    footprints: list
-    last_footprint_pos: tuple | None
+    footprints: list[Footprint]
+    last_footprint_pos: tuple[float, float] | None
     elapsed_play_ms: int
     has_fuel: bool
     flashlight_count: int
@@ -54,14 +93,17 @@ class ProgressState:
     survivor_messages: list
     survivor_capacity: int
     seed: int | None
-    survival_elapsed_ms: int
-    survival_goal_ms: int
+    endurance_elapsed_ms: int
+    endurance_goal_ms: int
     dawn_ready: bool
     dawn_prompt_at: int | None
     time_accel_active: bool
     last_zombie_spawn_time: int
     dawn_carbonized: bool
     debug_mode: bool
+    falling_zombies: list[FallingZombie]
+    falling_spawn_carry: int
+    dust_rings: list[DustRing]
 
 
 @dataclass
@@ -107,14 +149,17 @@ class Stage:
     requires_fuel: bool = False
     buddy_required_count: int = 0
     rescue_stage: bool = False
-    survival_stage: bool = False
-    survival_goal_ms: int = 0
+    endurance_stage: bool = False
+    endurance_goal_ms: int = 0
     fuel_spawn_count: int = 1
+    initial_flashlight_count: int = DEFAULT_FLASHLIGHT_SPAWN_COUNT
     survivor_spawn_rate: float = SURVIVOR_SPAWN_RATE
     spawn_interval_ms: int = ZOMBIE_SPAWN_DELAY_MS
     initial_interior_spawn_rate: float = 0.015
     exterior_spawn_weight: float = 1.0
     interior_spawn_weight: float = 0.0
+    interior_fall_spawn_weight: float = 0.0
+    fall_spawn_zones: list[tuple[int, int, int, int]] = field(default_factory=list)
     zombie_tracker_ratio: float = 0.0
     zombie_wall_follower_ratio: float = 0.0
     zombie_normal_ratio: float = 1.0
@@ -133,6 +178,8 @@ class Stage:
 
 __all__ = [
     "LevelLayout",
+    "FallingZombie",
+    "DustRing",
     "ProgressState",
     "Groups",
     "GameData",