zombie-escape 1.12.0__py3-none-any.whl → 1.13.1__py3-none-any.whl

zombie_escape/screens/game_over.py

@@ -18,8 +18,10 @@ from ..input_utils import is_confirm_event, is_select_event
 from ..screens import (
     ScreenID,
     ScreenTransition,
+    nudge_window_scale,
     present,
     sync_window_size,
+    toggle_fullscreen,
 )
 from ..gameplay_constants import SURVIVAL_FAKE_CLOCK_RATIO
 
@@ -47,9 +49,9 @@ def game_over_screen(
 
     while True:
         if not state.overview_created:
-            level_rect = game_data.layout.outer_rect
-            level_width = level_rect[2]
-            level_height = level_rect[3]
+            level_rect = game_data.layout.field_rect
+            level_width = level_rect.width
+            level_height = level_rect.height
             overview_surface = pygame.Surface((level_width, level_height))
             footprints_to_draw = state.footprints if footprints_enabled else []
             draw_level_overview(
@@ -174,6 +176,15 @@ def game_over_screen(
                 sync_window_size(event, game_data=game_data)
                 continue
             if event.type == pygame.KEYDOWN:
+                if event.key == pygame.K_LEFTBRACKET:
+                    nudge_window_scale(0.5, game_data=game_data)
+                    continue
+                if event.key == pygame.K_RIGHTBRACKET:
+                    nudge_window_scale(2.0, game_data=game_data)
+                    continue
+                if event.key == pygame.K_f:
+                    toggle_fullscreen(game_data=game_data)
+                    continue
                 if event.key in (pygame.K_ESCAPE, pygame.K_SPACE):
                     return ScreenTransition(ScreenID.TITLE)
                 if event.key == pygame.K_r and stage is not None:

zombie_escape/screens/gameplay.py

@@ -12,6 +12,7 @@ from ..gameplay_constants import (
     SURVIVAL_TIME_ACCEL_MAX_SUBSTEP,
 )
 from ..gameplay import (
+    MapGenerationError,
     apply_passenger_speed_penalty,
     check_interactions,
     cleanup_survivor_messages,
@@ -52,8 +53,10 @@ from ..progress import record_stage_clear
 from ..screens import (
     ScreenID,
     ScreenTransition,
+    nudge_window_scale,
     present,
     sync_window_size,
+    toggle_fullscreen,
 )
 
 if TYPE_CHECKING:
@@ -71,11 +74,24 @@ def gameplay_screen(
     seed: int | None,
     render_assets: "RenderAssets",
     debug_mode: bool = False,
+    show_fps: bool = False,
 ) -> ScreenTransition:
     """Main gameplay loop that returns the next screen transition."""
 
     screen_width = screen.get_width()
     screen_height = screen.get_height()
+    mouse_hidden = False
+
+    def _set_mouse_hidden(hidden: bool) -> None:
+        nonlocal mouse_hidden
+        if mouse_hidden == hidden:
+            return
+        pygame.mouse.set_visible(not hidden)
+        mouse_hidden = hidden
+
+    def _finalize(transition: ScreenTransition) -> ScreenTransition:
+        _set_mouse_hidden(False)
+        return transition
 
     seed_value = seed if seed is not None else generate_seed()
     applied_seed = seed_rng(seed_value)
@@ -83,6 +99,7 @@ def gameplay_screen(
     game_data = initialize_game_state(config, stage)
     game_data.state.seed = applied_seed
     game_data.state.debug_mode = debug_mode
+    game_data.state.show_fps = show_fps
     if debug_mode and stage.endurance_stage:
         goal_ms = max(0, stage.endurance_goal_ms)
         if goal_ms > 0:
@@ -101,8 +118,32 @@ def gameplay_screen(
     ignore_focus_loss_until = 0
     controller = init_first_controller()
     joystick = init_first_joystick() if controller is None else None
+    _set_mouse_hidden(pygame.mouse.get_focused())
+
+    try:
+        layout_data = generate_level_from_blueprint(game_data, config)
+    except MapGenerationError:
+        # If generation fails after retries, show error and back to title
+        draw(
+            render_assets,
+            screen,
+            game_data,
+            config=config,
+            hint_color=None,
+            fps=fps,
+            present_fn=present,
+        )
+        show_message(
+            screen,
+            tr("errors.map_generation_failed"),
+            16,
+            RED,
+            (screen_width // 2, screen_height // 2),
+        )
+        present(screen)
+        pygame.time.delay(3000)
+        return _finalize(ScreenTransition(ScreenID.TITLE))
 
-    layout_data = generate_level_from_blueprint(game_data, config)
     sync_ambient_palette_with_flashlights(game_data, force=True)
     initial_waiting = max(0, stage.waiting_car_target_count)
     player, waiting_cars = setup_player_and_cars(
@@ -120,10 +161,12 @@ def gameplay_screen(
     spawn_survivors(game_data, layout_data)
 
     occupied_centers: set[tuple[int, int]] = set()
+    cell_size = game_data.cell_size
     if stage.requires_fuel:
         fuel_spawn_count = stage.fuel_spawn_count
         fuel_can = place_fuel_can(
-            layout_data["walkable_cells"],
+            layout_data["fuel_cells"] or layout_data["walkable_cells"],
+            cell_size,
             player,
             cars=game_data.waiting_cars,
             reserved_centers=occupied_centers,
@@ -135,7 +178,8 @@ def gameplay_screen(
             occupied_centers.add(fuel_can.rect.center)
     flashlight_count = stage.initial_flashlight_count
     flashlights = place_flashlights(
-        layout_data["walkable_cells"],
+        layout_data["flashlight_cells"] or layout_data["walkable_cells"],
+        cell_size,
         player,
         cars=game_data.waiting_cars,
         reserved_centers=occupied_centers,
@@ -148,7 +192,8 @@ def gameplay_screen(
 
     shoes_count = stage.initial_shoes_count
     shoes_list = place_shoes(
-        layout_data["walkable_cells"],
+        layout_data["shoes_cells"] or layout_data["walkable_cells"],
+        cell_size,
         player,
         cars=game_data.waiting_cars,
         reserved_centers=occupied_centers,
@@ -188,16 +233,18 @@ def gameplay_screen(
                         )
                     present(screen)
                     continue
-            return ScreenTransition(
-                ScreenID.GAME_OVER,
-                stage=stage,
-                game_data=game_data,
-                config=config,
+            return _finalize(
+                ScreenTransition(
+                    ScreenID.GAME_OVER,
+                    stage=stage,
+                    game_data=game_data,
+                    config=config,
+                )
             )
 
         for event in pygame.event.get():
             if event.type == pygame.QUIT:
-                return ScreenTransition(ScreenID.EXIT)
+                return _finalize(ScreenTransition(ScreenID.EXIT))
             if event.type in (pygame.WINDOWSIZECHANGED, pygame.VIDEORESIZE):
                 sync_window_size(event, game_data=game_data)
                 continue
@@ -226,6 +273,15 @@ def gameplay_screen(
                 if joystick and not joystick.get_init():
                     joystick = None
             if event.type == pygame.KEYDOWN:
+                if event.key == pygame.K_LEFTBRACKET:
+                    nudge_window_scale(0.5, game_data=game_data)
+                    continue
+                if event.key == pygame.K_RIGHTBRACKET:
+                    nudge_window_scale(2.0, game_data=game_data)
+                    continue
+                if event.key == pygame.K_f:
+                    toggle_fullscreen(game_data=game_data)
+                    continue
                 if event.key == pygame.K_s and (
                     pygame.key.get_mods() & pygame.KMOD_CTRL
                 ):
@@ -244,7 +300,7 @@ def gameplay_screen(
                     continue
                 if paused_manual:
                     if event.key == pygame.K_ESCAPE:
-                        return ScreenTransition(ScreenID.TITLE)
+                        return _finalize(ScreenTransition(ScreenID.TITLE))
                     if event.key == pygame.K_p:
                         paused_manual = False
                     continue
@@ -257,13 +313,13 @@ def gameplay_screen(
             ):
                 if debug_mode:
                     if is_select_event(event):
-                        return ScreenTransition(ScreenID.TITLE)
+                        return _finalize(ScreenTransition(ScreenID.TITLE))
                     if is_start_event(event):
                         paused_manual = not paused_manual
                     continue
                 if paused_manual:
                     if is_select_event(event):
-                        return ScreenTransition(ScreenID.TITLE)
+                        return _finalize(ScreenTransition(ScreenID.TITLE))
                     if is_start_event(event):
                         paused_manual = False
                     continue
@@ -271,6 +327,8 @@ def gameplay_screen(
                     paused_manual = True
                     continue
 
+        _set_mouse_hidden(pygame.mouse.get_focused())
+
         paused = paused_manual or paused_focus
         if paused:
             draw(
@@ -437,4 +495,4 @@ def gameplay_screen(
         )
 
     # Should not reach here, but return to title if it happens
-    return ScreenTransition(ScreenID.TITLE)
+    return _finalize(ScreenTransition(ScreenID.TITLE))

zombie_escape/screens/title.py

@@ -44,14 +44,21 @@ README_URLS: dict[str, str] = {
     "en": "https://github.com/tos-kamiya/zombie-escape/blob/main/README.md",
     "ja": "https://github.com/tos-kamiya/zombie-escape/blob/main/README-ja_JP.md",
 }
+STAGE6_URLS: dict[str, str] = {
+    "en": "https://github.com/tos-kamiya/zombie-escape/blob/main/docs/stages-6plus.md",
+    "ja": "https://github.com/tos-kamiya/zombie-escape/blob/main/docs/stages-6plus-ja_JP.md",
+}
 UNCLEARED_STAGE_COLOR: tuple[int, int, int] = (220, 80, 80)
 
 
-def _open_readme_link() -> None:
-    """Open the GitHub README for the active UI language."""
+def _open_readme_link(*, use_stage6: bool = False) -> None:
+    """Open the GitHub README or Stage 6+ guide for the active UI language."""
 
     language = get_language()
-    url = README_URLS.get(language, README_URLS["en"])
+    if use_stage6:
+        url = STAGE6_URLS.get(language, STAGE6_URLS["en"])
+    else:
+        url = README_URLS.get(language, README_URLS["en"])
     try:
         webbrowser.open(url, new=0, autoraise=True)
     except Exception as exc:  # pragma: no cover - best effort only
@@ -295,7 +302,7 @@ def title_screen(
                             seed_is_auto=current_seed_auto,
                         )
                     if current["type"] == "readme":
-                        _open_readme_link()
+                        _open_readme_link(use_stage6=current_page > 0)
                         continue
                     if current["type"] == "quit":
                         return ScreenTransition(
@@ -327,7 +334,7 @@ def title_screen(
                             seed_is_auto=current_seed_auto,
                         )
                     if current["type"] == "readme":
-                        _open_readme_link()
+                        _open_readme_link(use_stage6=current_page > 0)
                         continue
                     if current["type"] == "quit":
                         return ScreenTransition(
@@ -475,7 +482,8 @@ def title_screen(
                 if option["type"] == "settings":
                     label = tr("menu.settings")
                 elif option["type"] == "readme":
-                    label = f"> {tr('menu.readme')}"
+                    label_key = "menu.readme_stage6" if current_page > 0 else "menu.readme"
+                    label = f"> {tr(label_key)}"
                 else:
                     label = tr("menu.quit")
                 color = WHITE
@@ -508,7 +516,10 @@ def title_screen(
             elif current["type"] == "quit":
                 help_text = tr("menu.option_help.quit")
             elif current["type"] == "readme":
-                help_text = tr("menu.option_help.readme")
+                help_key = (
+                    "menu.option_help.readme_stage6" if current_page > 0 else "menu.option_help.readme"
+                )
+                help_text = tr(help_key)
 
             if help_text:
                 _blit_wrapped_text(

zombie_escape/stage_constants.py

@@ -85,7 +85,7 @@ STAGES: list[Stage] = [
         interior_spawn_weight=0.3,
         zombie_normal_ratio=0.4,
         zombie_tracker_ratio=0.3,
-        zombie_wall_follower_ratio=0.3,
+        zombie_wall_hugging_ratio=0.3,
         zombie_aging_duration_frames=ZOMBIE_AGING_DURATION_FRAMES * 2,
         initial_interior_spawn_rate=0.01,
     ),
@@ -101,7 +101,7 @@ STAGES: list[Stage] = [
         interior_spawn_weight=0.6,
         zombie_normal_ratio=0,
         zombie_tracker_ratio=0.3,
-        zombie_wall_follower_ratio=0.7,
+        zombie_wall_hugging_ratio=0.7,
         zombie_aging_duration_frames=ZOMBIE_AGING_DURATION_FRAMES * 2,
         initial_interior_spawn_rate=0.01,
     ),
@@ -118,7 +118,7 @@ STAGES: list[Stage] = [
         waiting_car_target_count=1,
         zombie_normal_ratio=0,
         zombie_tracker_ratio=0.3,
-        zombie_wall_follower_ratio=0.7,
+        zombie_wall_hugging_ratio=0.7,
         survivor_spawn_rate=SURVIVOR_SPAWN_RATE,
         zombie_aging_duration_frames=ZOMBIE_AGING_DURATION_FRAMES * 2,
         initial_interior_spawn_rate=0.01,
@@ -130,12 +130,12 @@ STAGES: list[Stage] = [
         available=True,
         rescue_stage=True,
         tile_size=40,
-        wall_algorithm="sparse",
+        wall_algorithm="sparse_moore.10%",
         exterior_spawn_weight=0.7,
         interior_spawn_weight=0.3,
         zombie_normal_ratio=0.4,
         zombie_tracker_ratio=0.4,
-        zombie_wall_follower_ratio=0.2,
+        zombie_wall_hugging_ratio=0.2,
         zombie_aging_duration_frames=ZOMBIE_AGING_DURATION_FRAMES * 2,
         initial_interior_spawn_rate=0.02,
         waiting_car_target_count=1,
@@ -148,7 +148,7 @@ STAGES: list[Stage] = [
         grid_cols=120,
         grid_rows=7,
         available=True,
-        wall_algorithm="sparse",
+        wall_algorithm="sparse_moore.10%",
         exterior_spawn_weight=0.3,
         interior_spawn_weight=0.7,
         zombie_normal_ratio=0.5,
@@ -170,10 +170,10 @@ STAGES: list[Stage] = [
         interior_spawn_weight=0.2,
         interior_fall_spawn_weight=0.3,
         fall_spawn_zones=[
-            (3, 3, 12, 12),
-            (3, 17, 12, 12),
-            (17, 3, 12, 12),
-            (17, 17, 12, 12),
+            (4, 4, 10, 10),
+            (4, 18, 10, 10),
+            (18, 18, 10, 10),
+            (18, 18, 10, 10),
         ],
         initial_flashlight_count=5,
         zombie_aging_duration_frames=ZOMBIE_AGING_DURATION_FRAMES * 2,
@@ -192,7 +192,7 @@ STAGES: list[Stage] = [
         interior_fall_spawn_weight=0.3,
         zombie_normal_ratio=0.4,
         zombie_tracker_ratio=0.3,
-        zombie_wall_follower_ratio=0.3,
+        zombie_wall_hugging_ratio=0.3,
         zombie_aging_duration_frames=ZOMBIE_AGING_DURATION_FRAMES * 2,
         initial_flashlight_count=3,
         fall_spawn_zones=[
@@ -214,6 +214,7 @@ STAGES: list[Stage] = [
         interior_spawn_weight=0.1,
         interior_fall_spawn_weight=0.7,
         fall_spawn_floor_ratio=0.05,
+        wall_rubble_ratio=0.35,
         initial_flashlight_count=3,
         zombie_aging_duration_frames=ZOMBIE_AGING_DURATION_FRAMES * 2,
         initial_shoes_count=1,
@@ -224,8 +225,8 @@ STAGES: list[Stage] = [
         description_key="stages.stage15.description",
         available=True,
         buddy_required_count=1,
-        grid_cols=70,
-        grid_rows=20,
+        grid_cols=64,
+        grid_rows=24,
         tile_size=35,
         wall_algorithm="grid_wire",
         requires_fuel=True,
@@ -235,13 +236,48 @@ STAGES: list[Stage] = [
         interior_fall_spawn_weight=0.7,
         initial_flashlight_count=3,
         zombie_normal_ratio=0.5,
-        zombie_wall_follower_ratio=0.5,
+        zombie_wall_hugging_ratio=0.5,
         fall_spawn_zones=[
-            (33, 2, 4, 16),
+            (33, 2, 4, 18),
         ],
         zombie_aging_duration_frames=ZOMBIE_AGING_DURATION_FRAMES * 2,
         initial_shoes_count=1,
     ),
+    Stage(
+        id="stage16",
+        name_key="stages.stage16.name",
+        description_key="stages.stage16.description",
+        available=True,
+        requires_fuel=True,
+        wall_algorithm="sparse_moore.25%",
+        grid_cols=40,
+        grid_rows=25,
+        tile_size=60,
+        pitfall_density=0.04,
+        initial_flashlight_count=1,
+        initial_shoes_count=1,
+        initial_interior_spawn_rate=0.12,
+        exterior_spawn_weight=0.1,
+        interior_spawn_weight=0.9,
+        zombie_aging_duration_frames=ZOMBIE_AGING_DURATION_FRAMES * 2,
+    ),
+    Stage(
+        id="stage17",
+        name_key="stages.stage17.name",
+        description_key="stages.stage17.description",
+        available=False,
+        requires_fuel=True,
+        wall_algorithm="grid_wire",
+        pitfall_density=0.04,
+        initial_flashlight_count=1,
+        initial_shoes_count=1,
+        initial_interior_spawn_rate=0.1,
+        exterior_spawn_weight=0.1,
+        interior_spawn_weight=0.9,
+        zombie_tracker_ratio=1.0,
+        wall_rubble_ratio=0.25,
+        zombie_aging_duration_frames=ZOMBIE_AGING_DURATION_FRAMES * 2,
+    ),
 ]
 DEFAULT_STAGE_ID = "stage1"
 

zombie_escape/zombie_escape.py

@@ -21,7 +21,7 @@ from .entities_constants import (
 from .gameplay import calculate_car_speed_for_passengers
 from .level_constants import DEFAULT_TILE_SIZE
 from .localization import set_language
-from .models import GameData, Stage
+from .models import Stage
 from .render_constants import RenderAssets, build_render_assets
 from .screen_constants import (
     DEFAULT_WINDOW_SCALE,
@@ -43,6 +43,11 @@ def _parse_cli_args(argv: list[str]) -> Tuple[argparse.Namespace, list[str]]:
         action="store_true",
         help="Enable debugging aids for Stage 5 and hide pause overlay",
     )
+    parser.add_argument(
+        "--show-fps",
+        action="store_true",
+        help="Show FPS overlay during gameplay",
+    )
     parser.add_argument(
         "--profile",
         action="store_true",
@@ -53,6 +58,11 @@ def _parse_cli_args(argv: list[str]) -> Tuple[argparse.Namespace, list[str]]:
         default="profile.prof",
         help="cProfile output path (default: profile.prof)",
     )
+    parser.add_argument(
+        "--export-images",
+        action="store_true",
+        help="Export documentation images to imgs/exports and exit",
+    )
     parser.add_argument("--seed")
     return parser.parse_known_args(argv)
 
@@ -100,10 +110,20 @@ def main() -> None:
     clock = pygame.time.Clock()
 
     debug_mode = bool(args.debug)
+    show_fps = bool(args.show_fps) or debug_mode
     cli_seed_text, cli_seed_is_auto = _sanitize_seed_text(args.seed)
     title_seed_text, title_seed_is_auto = cli_seed_text, cli_seed_is_auto
     last_stage_id: str | None = None
 
+    if args.export_images:
+        from .export_images import export_images
+
+        output_dir = Path.cwd() / "imgs" / "exports"
+        saved = export_images(output_dir, cell_size=DEFAULT_TILE_SIZE)
+        print(f"Exported {len(saved)} images to {output_dir}")
+        pygame.quit()
+        return
+
     config: dict[str, Any]
     config, config_path = load_config()
     if not config_path.exists():
@@ -121,6 +141,7 @@ def main() -> None:
         seed: int | None,
         render_assets: RenderAssets,
         debug_mode: bool,
+        show_fps: bool,
     ) -> ScreenTransition:
         import cProfile
         import pstats
@@ -138,6 +159,7 @@ def main() -> None:
                 seed=seed,
                 render_assets=render_assets,
                 debug_mode=debug_mode,
+                show_fps=show_fps,
             )
         finally:
             output_path = Path(args.profile_output)
@@ -206,6 +228,7 @@ def main() -> None:
                         seed=seed_value,
                         render_assets=render_assets,
                         debug_mode=debug_mode,
+                        show_fps=show_fps,
                     )
                 except SystemExit:
                     running = False

{zombie_escape-1.12.0.dist-info → zombie_escape-1.13.1.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: zombie-escape
-Version: 1.12.0
+Version: 1.13.1
 Summary: Top-down zombie survival game built with pygame.
 Project-URL: Homepage, https://github.com/tos-kamiya/zombie-escape
 Author-email: Toshihiro Kamiya <kamiya@mbj.nifty.com>
@@ -57,7 +57,8 @@ This game is a simple 2D top-down action game where the player aims to escape by
 -   **Pause:** `P`/Start or `ESC`/Select
 -   **Quit Game:** `ESC`/Select (from pause)
 -   **Restart:** `R` key (on Game Over/Clear screen)
--   **Window/Fullscreen (title/settings only):** `[` to shrink, `]` to enlarge, `F` to toggle fullscreen
+-   **Window/Fullscreen:** `[` to shrink, `]` to enlarge, `F` to toggle fullscreen
+-   **FPS Overlay:** Launch with `--show-fps` (implied by `--debug`)
 -   **Time Acceleration:** Hold either `Shift` key or `R1` to run the entire world 4x faster; release to return to normal speed.
 
 ## Title Screen
@@ -72,6 +73,9 @@ At the title screen you can pick a stage:
 - **Stage 4: Evacuate Survivors** — start fueled, find the car, gather nearby civilians, and escape before zombies reach them. Stage 4 sprinkles extra parked cars across the map; slamming into one while already driving fully repairs your current ride and adds five more safe seats.
 - **Stage 5: Survive Until Dawn** — every car is bone-dry. Endure until the sun rises while the horde presses in from every direction. Once dawn hits, outdoor zombies carbonize and you must walk out through an existing exterior gap to win; cars remain unusable.
 
+Stages 6+ unlock after clearing Stages 1–5. On the title screen, use left/right to select later stages.
+Open the Stage 6+ description: [docs/stages-6plus.md](docs/stages-6plus.md)
+
 **Stage names are red until cleared** and turn white after at least one clear.
 
 An objective reminder is shown at the top-left during play.
@@ -93,30 +97,52 @@ Open **Settings** from the title to toggle gameplay assists:
 
 ### Characters/Items
 
--   **Player:** A blue circle. Controlled with the WASD or arrow keys. When carrying fuel a tiny yellow square appears near the sprite so you can immediately see whether you're ready to drive.
--   **Zombie:** A red circle. Will chase the player (or car) once detected.
-    -   When out of sight, the zombie's movement mode will randomly switch every certain time (moving horizontally/vertically only, side-to-side movement, random movement, etc.).
-    -   Variants with different behavior have been observed.
--   **Car:** A yellow rectangle. The player can enter by making contact with it.
+#### Characters
+
+| Name | Image | Notes |
+| --- | --- | --- |
+| Player | <img src="https://raw.githubusercontent.com/tos-kamiya/zombie-escape/main/imgs/exports/player.png" width="64"> | Blue circle with small hands. |
+| Zombie (Normal) | <img src="https://raw.githubusercontent.com/tos-kamiya/zombie-escape/main/imgs/exports/zombie-normal.png" width="64"> | Chases the player once detected. |
+| Car | <img src="https://raw.githubusercontent.com/tos-kamiya/zombie-escape/main/imgs/exports/car.png" width="64"> | Driveable escape vehicle with durability. |
+| Buddy (Stage 3) | <img src="https://raw.githubusercontent.com/tos-kamiya/zombie-escape/main/imgs/exports/buddy.png" width="64"> | A green survivor you can rescue. |
+| Survivors (Stage 4) | <img src="https://raw.githubusercontent.com/tos-kamiya/zombie-escape/main/imgs/exports/survivor.png" width="64"> | Civilians to evacuate by car. |
+
+- **Player:** Controlled with the WASD or arrow keys. When carrying fuel a tiny yellow square appears near the sprite so you can immediately see whether you're ready to drive.
+- **Zombie:** When out of sight, the zombie's movement mode will randomly switch every certain time (moving horizontally/vertically only, side-to-side movement, random movement, etc.).
+- **Car:**
     -   The car has durability. Durability decreases when colliding with internal walls or hitting zombies.
     -   If durability reaches 0, the car is destroyed and you are dumped on foot; you must track down another parked car hidden in the level.
     -   When you're already driving, ramming a parked car instantly restores your current car's health. On Stage 4 this also increases the safe passenger limit by five.
     -   After roughly 5 minutes of play, a small triangle near the player points toward the objective: fuel first (Stage 2 before pickup), car after fuel is collected (Stage 2/3), or car directly (Stage 1/4).
--   **Walls:** Outer walls are gray; inner walls are beige.
-    -   **Outer Walls:** Walls surrounding the stage that are nearly indestructible. Each side has at least three openings (exits).
-    -   **Inner Walls:** Beige walls randomly placed inside the building. Inner wall segments each have durability. **The player can break these walls** by repeatedly colliding with a segment to reduce its durability; when it reaches 0, the segment is destroyed and disappears. Zombies can also wear down walls, but far more slowly. The car cannot break walls.
--   **Flashlight:** Each pickup expands your visible radius by about 20% (grab two to reach the max boost).
--   **Steel Beam (optional):** A square post with crossed diagonals; same collision as inner walls but with triple durability. Spawns independently of inner walls (may overlap them). If an inner wall covers a beam, the beam appears once the wall is destroyed.
--   **Fuel Can (Stages 2 & 3):** A yellow jerrycan that only spawns on the fuel-run stages. Pick it up before driving the car; once collected the on-player indicator appears until you refuel the car.
--   **Buddy (Stage 3):** A green circle survivor with a blue outline who spawns somewhere in the building and waits.
+- **Buddy (Stage 3):**
     -   Zombies only choose to pursue the buddy if they are on-screen; otherwise they ignore them.
     -   If a zombie tags the buddy off-screen, the buddy quietly respawns somewhere else instead of ending the run.
     -   Touch the buddy on foot to make them follow you (at 70% of player speed). Touch them while driving to pick them up.
--   **Survivors (Stage 4):** Pale gray civilians with a blue outline, scattered indoors.
+    -   If you bash an inner wall or steel beam, the buddy will drift toward that spot and help chip away at it.
+- **Survivors (Stage 4):**
     - They stand still until you get close, then shuffle toward you at about one-third of player speed.
     - Zombies can convert them if both are on-screen; the survivor shouts a line and turns instantly.
     - They only board the car; your safe capacity starts at five but grows by five each time you sideswipe a parked car while already driving. Speed loss is based on how full the car is relative to that capacity, so extra slots mean quicker getaways.
 
+#### Items
+
+| Name | Image | Notes |
+| --- | --- | --- |
+| Flashlight | <img src="https://raw.githubusercontent.com/tos-kamiya/zombie-escape/main/imgs/exports/flashlight.png" width="64"> | Each pickup expands your visible radius by about 20% (grab two to reach the max boost). |
+| Fuel Can (Stages 2 & 3) | <img src="https://raw.githubusercontent.com/tos-kamiya/zombie-escape/main/imgs/exports/fuel.png" width="64"> | Must be collected before driving the car in fuel-run stages. |
+| Steel Beam (optional) | <img src="https://raw.githubusercontent.com/tos-kamiya/zombie-escape/main/imgs/exports/steel-beam.png" width="64"> | Same collision as inner walls but with triple durability. |
+
+#### Environment
+
+| Name | Image | Notes |
+| --- | --- | --- |
+| Outer Wall | <img src="https://raw.githubusercontent.com/tos-kamiya/zombie-escape/main/imgs/exports/wall-outer.png" width="64"> | Nearly indestructible; each side has exits. |
+| Inner Wall | <img src="https://raw.githubusercontent.com/tos-kamiya/zombie-escape/main/imgs/exports/wall-inner.png" width="64"> | Breakable by the player; zombies chip away slowly. |
+
+- **Walls:** Outer walls are gray; inner walls are beige.
+    -   **Outer Walls:** Walls surrounding the stage that are nearly indestructible. Each side has at least three openings (exits).
+    -   **Inner Walls:** Beige walls randomly placed inside the building. Inner wall segments each have durability. **The player can break these walls** by repeatedly colliding with a segment to reduce its durability; when it reaches 0, the segment is destroyed and disappears. Zombies can also wear down walls, but far more slowly. The car cannot break walls.
+
 ### Win/Lose Conditions
 
 -   **Win Condition:** Escape the stage (level) boundaries while inside the car.

zombie_escape-1.13.1.dist-info/RECORD

@@ -0,0 +1,49 @@
+zombie_escape/__about__.py,sha256=PL2hra_dpIg6vOLUwwb3g7kiPnrWUuSYwSz1bnA8b98,135
+zombie_escape/__init__.py,sha256=YSQnUghet8jxSvaGmKfzHfXXLlnvWh_xk10WGTDO2HM,173
+zombie_escape/__main__.py,sha256=tddKDyuRF0BHYrPdMvpB-p2cQ3CdxmcwC4PORAnrmkg,108
+zombie_escape/colors.py,sha256=ggXcsHQviTWO_ehCn8f3KJVYsY4dx5r5-RtKrTt7qPc,6526
+zombie_escape/config.py,sha256=Ncvsz6HzBknSjecorkm7CrkrzWUIksD30ykLPueanyw,2008
+zombie_escape/entities.py,sha256=qcwSqaacix6RIV4q_aNvCD6bQc_2UckkT8I92ah-maw,77077
+zombie_escape/entities_constants.py,sha256=O4ti179GBBv1A3ECHJ4PdrmCZDr_GzYrEi6m2mgdn4Y,3884
+zombie_escape/export_images.py,sha256=gfm4zkO_WDNwhyQPgEIE5xLrNgWFKbrUVmt30787oYw,8848
+zombie_escape/font_utils.py,sha256=kkjcSlCTG3jO5zf5XUnirpJ-iL_Eg8ahzjZYGijF2JY,1206
+zombie_escape/gameplay_constants.py,sha256=MdchWDi3p1xUOZuDsl5eH9KjazuApjuIYEddHkazEsw,984
+zombie_escape/input_utils.py,sha256=0SHENZi5y-ybSxUX569RHihI_xbQWSI0FQ1q1ZE9U1c,5795
+zombie_escape/level_blueprints.py,sha256=negu36BUHFv_7bcGYfpqiawQdSMxmxubYV6fSdOeG8E,18896
+zombie_escape/level_constants.py,sha256=fSrPXfkuKHlv9XqmaRq6aR9UhjpqZK2iJJgMc-TXGXc,281
+zombie_escape/localization.py,sha256=gp26FN_Od4eOeIK2aY0_QZ-9THw6yENh-cGTwglnMxw,6118
+zombie_escape/models.py,sha256=Zxj57emfKQqI4dLbL6G7ciZCdytgTqYQ579_IPPmttQ,5300
+zombie_escape/progress.py,sha256=WCFc7JeMY6noBjnTIFyHrXQJSM1j8PwyPA7S8ZQwjTE,1713
+zombie_escape/render.py,sha256=6GmPqaJREe-hD5rQLgIW89soonQMXZNW_bEEOawYARo,57486
+zombie_escape/render_assets.py,sha256=gsW-KTaR7iBxJoIo9JQ61-m9C44fjHIdgy9FUT2sMW4,26566
+zombie_escape/render_constants.py,sha256=OTXpY7nzTwm2s4t6kHoSMC_4F6FrBqqI8xtQRk5lqWE,3883
+zombie_escape/rng.py,sha256=gMAgpzYoNN1FxRG3aQ9fdXTDNAg48Rqz8YnB1nJ4Fpw,3787
+zombie_escape/screen_constants.py,sha256=MJaTlSWfN4VtN6pMqPQ6LF34XdJm0wqYLuRwa1pQuAU,559
+zombie_escape/stage_constants.py,sha256=zgs4cST94PMTaQQsBNwmFL4v8wmJoR7AQ2cahyH6Y9o,9073
+zombie_escape/world_grid.py,sha256=9ZKaur2fBOXiZEg5WlaAnoeHV6Lda092rJROraMW6zk,4553
+zombie_escape/zombie_escape.py,sha256=0P70hgbcb2j7lK57CoNQv8hrr2SZjMOwuNelBj6gDiw,9222
+zombie_escape/assets/fonts/Silkscreen-Regular.ttf,sha256=SVZ0CGAICeJRR-kiWsTzf0EOLfRadQaWxFAnUx-2Xxs,31960
+zombie_escape/assets/fonts/misaki_gothic.ttf,sha256=CWPhHonV-kCaegSKUujqLWI9dkp5mEiPikKRERYRxOE,1171204
+zombie_escape/gameplay/__init__.py,sha256=QQsFVCP4FMxtztW8yOVcNAA9_16dbEcHshsqSuD679w,2433
+zombie_escape/gameplay/ambient.py,sha256=hoCOz6ciyejU0nmJwdLqmVfaoo-01CrVSMRLpFMz93w,1446
+zombie_escape/gameplay/constants.py,sha256=mgY9ajtG-rX__V7S7Q4R8Yh5XmMLaF_g8PsMgV8GIac,1216
+zombie_escape/gameplay/footprints.py,sha256=WRN5wNIudqrQJ3vBljSbtwcdgn154f1jVdor4nEn_Ic,1995
+zombie_escape/gameplay/interactions.py,sha256=D503c0PBmTF4SapBblmKHJwWFr4TDqVZ2merDNek0_k,14407
+zombie_escape/gameplay/layout.py,sha256=H06ehDVD-k2Nk1hQ5fPoveGKJJDBo5C2CXKzIIUUuYs,11544
+zombie_escape/gameplay/movement.py,sha256=PAGCiA2KSXRR9j0qPpCUd08IHjvQFRhGhp6j4E8dhAU,12272
+zombie_escape/gameplay/spawn.py,sha256=eHoTl8_VYiGENCMVMpNUVfYEc2tvGQ1OnoA4Qv6BEFY,32349
+zombie_escape/gameplay/state.py,sha256=WW6loUE1iHIW0MkawOpTDu2pSmmJHFEhIQT5IkFlJm4,4828
+zombie_escape/gameplay/survivors.py,sha256=Rgn-OtiTnnu7DYuaye2oNEFGQMivTsZS0VgS6KAMOUw,12226
+zombie_escape/gameplay/utils.py,sha256=NkAynBpu4VHuRGbEBDbA214WK92yquS6E_i7Y--cBV0,6439
+zombie_escape/locales/ui.en.json,sha256=LIoGoILwa3x7wbEeSjvFiSCKmjaeirdWPz3WCQfQWIk,6939
+zombie_escape/locales/ui.ja.json,sha256=2TFzwdaLOfSeyL1N0M8f1TP8uqWSwZRl59bBdruMYiM,7599
+zombie_escape/screens/__init__.py,sha256=BFLQzXqyrAhmm6b_2wlnK7lMm_n5HvBklVrzrJRwRn0,8387
+zombie_escape/screens/game_over.py,sha256=IWXiaEalfaoshRyRVAV3M3upL1Yf2uFip4wcdavIkmE,7192
+zombie_escape/screens/gameplay.py,sha256=KVAQxV1ZEab2-3ii6ndCrhRN3ynEaGjb0xfXwqvyiwM,18091
+zombie_escape/screens/settings.py,sha256=qgcnq8k-yeRbqweT9GsIefKWKvjOON_Gs2_SCZChY-8,21739
+zombie_escape/screens/title.py,sha256=ru4PNDuIN6p7EM2xIpiJE-XZy7f9FNX4BOVALLFIeUM,23747
+zombie_escape-1.13.1.dist-info/METADATA,sha256=nnn-TNYALI1yFZuYUaTchzpn-t7sCqin4xZU2uVbJDc,12124
+zombie_escape-1.13.1.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+zombie_escape-1.13.1.dist-info/entry_points.txt,sha256=JprxC-vvkBJgsOp0WJnGBZRJ_ESjjmyS-nsPExeiLHU,49
+zombie_escape-1.13.1.dist-info/licenses/LICENSE.txt,sha256=q-cJYG_K766eXSxQ7txWcWQ6nS2OF6c3HTVLesHbesU,1104
+zombie_escape-1.13.1.dist-info/RECORD,,