zombie-escape 1.3.5__tar.gz

zombie_escape-1.3.5/.gitignore

@@ -0,0 +1,8 @@
+.codex/
+node_modules/
+**/__pycache__/**
+dist/
+
+package-lock.json
+package.json
+uv.lock

zombie_escape-1.3.5/LICENSE.txt

@@ -0,0 +1,9 @@
+MIT License
+
+Copyright (c) 2025-present Toshihiro Kamiya <kamiya@mbj.nifty.com>
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

zombie_escape-1.3.5/PKG-INFO

@@ -0,0 +1,158 @@
+Metadata-Version: 2.4
+Name: zombie-escape
+Version: 1.3.5
+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>
+License-Expression: MIT
+License-File: LICENSE.txt
+Classifier: Development Status :: 4 - Beta
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: Implementation :: CPython
+Requires-Python: >=3.10
+Requires-Dist: platformdirs
+Requires-Dist: pygame
+Requires-Dist: python-i18n
+Description-Content-Type: text/markdown
+
+# Zombie Escape
+
+The city is overrun with zombies!
+You fled the horde, taking refuge in an abandoned factory.
+
+Inside, it's a maze. They won't get in easily.
+But you have no weapons. Night has fallen. The power's out, plunging the factory into darkness.
+
+Your only tool: a single flashlight.
+A car... somewhere inside... it's your only hope.
+
+Pierce the darkness and find the car!
+Then, escape this nightmare city!
+
+## Overview
+
+This game is a simple 2D top-down action game where the player aims to escape by finding and driving a car out of a large building infested with zombies. The player must evade zombies, break through walls to find a path, and then escape the building in a car.
+
+<img src="https://raw.githubusercontent.com/tos-kamiya/zombie-escape/main/imgs/screenshot1.png" width="400">
+<img src="https://raw.githubusercontent.com/tos-kamiya/zombie-escape/main/imgs/screenshot2.png" width="400">
+<img src="https://raw.githubusercontent.com/tos-kamiya/zombie-escape/main/imgs/screenshot3.png" width="400">
+
+## Controls
+
+-   **Player/Car Movement:** `W` / `↑` (Up), `A` / `←` (Left), `S` / `↓` (Down), `D` / `→` (Right)
+-   **Enter Car:** Overlap the player with the car.
+-   **Quit Game:** `ESC` key
+-   **Restart:** `R` key (on Game Over/Clear screen)
+-   **Window Scale (title/settings only):** `[` to shrink, `]` to enlarge
+-   **Time Acceleration:** Hold either `Shift` key to run the entire world 4x faster; release to return to normal speed.
+
+## Settings (Title Screen)
+
+Open **Settings** from the title to toggle gameplay assists:
+
+-   **Footprints:** Leave breadcrumb trails so you can backtrack in the dark.
+-   **Fast zombies:** Allow faster zombie variants; each zombie rolls a random speed between the normal and fast ranges.
+-   **Car hint:** After a delay, show a small triangle pointing toward the fuel (Stage 2 before pickup) or the car.
+-   **Steel beams:** Adds tougher single-cell obstacles (5% density) that block movement; hidden when stacked with an inner wall until that wall is destroyed.
+
+### Shared Seeds
+
+The title screen also lets you enter a numeric **seed**. Type digits (or pass `--seed <number>` on the CLI) to lock the procedural layout, wall placement, and pickups; share that seed with a friend and you will both play the exact same stage even on different machines. The current seed is shown at the bottom right of the title screen and in-game HUD. Backspace reverts to an automatically generated value so you can quickly roll a fresh challenge.
+
+## Game Rules
+
+### Stages
+
+At the title screen you can pick a stage:
+
+- **Stage 1: Find the Car** — locate the car and drive out (you already start with fuel).
+- **Stage 2: Fuel Run** — you start with no fuel; find a fuel can first, pick it up, then find the car and escape.
+- **Stage 3: Rescue Buddy** — same fuel hunt as Stage 2 (you begin empty) plus grab your buddy, pick them up with the car, then escape together.
+- **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.
+
+An objective reminder is shown at the top-left during play.
+
+### 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.).
+-   **Car:** A yellow rectangle. The player can enter by making contact with it.
+    -   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 who spawns somewhere in the building and waits.
+    -   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):** Light blue civilians scattered indoors.
+    - 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.
+
+### Win/Lose Conditions
+
+-   **Win Condition:** Escape the stage (level) boundaries while inside the car.
+    - Stage 1 and Stage 4 follow the base rule: find the car (already fueled) and drive out.
+    - Stage 2 also requires that you have collected the fuel can before driving out.
+    - Stage 3 requires both fuel and having picked up your buddy with the car before driving out.
+    - Stage 5 has no working cars; survive until dawn, then walk out through an exterior opening on foot.
+-   **Lose Condition:**
+    -   The player is touched by a zombie while *not* inside a car.
+    -   In Stage 3, if your buddy is caught (when visible), it's game over.
+    -   (Note: In the current implementation, the game does not end immediately when the car is destroyed. The player can search for another car and continue trying to escape.)
+
+## How to Run
+
+**Requirements: Python 3.10 or higher**
+
+Install using pipx:
+
+```sh
+pipx install zombie-escape
+```
+
+Alternatively, you can install using pip in a virtual environment:
+
+```sh
+pip install zombie-escape
+```
+
+Launch using the following command line:
+
+```sh
+zombie-escape
+```
+
+### Debug Mode
+
+<!-- For Stage 5 balancing or capture needs, run `zombie-escape --debug`. This hides the pause overlay and starts survival stages with 3 minutes remaining so you can immediately test late-night behavior. -->
+
+## License
+
+This project is licensed under the MIT License - see the [LICENSE.txt](LICENSE.txt) file for details.
+
+The bundled Silkscreen-Regular.ttf font follows the license terms of its original distribution.
+Please refer to the upstream website for details: https://fonts.google.com/specimen/Silkscreen
+
+The bundled misaki_gothic.ttf font (Misaki font by Num Kadoma) follows the license terms provided by Little Limit.
+Please refer to the official site for details: https://littlelimit.net/misaki.htm
+
+## Acknowledgements
+
+Significant assistance for many technical implementation and documentation aspects of this game's development was received from Google's large language model, Gemini (accessed during development), and from OpenAI's GPT-5. This included generating Python/Pygame code, suggesting rule adjustments, providing debugging support, and creating this README. Their rapid coding capabilities and contributions to problem-solving are greatly appreciated.
+
+Thanks to Jason Kottke, the author of the Silkscreen-Regular.ttf font used in the game.
+Thanks to Num Kadoma, the author of the Misaki font (misaki_gothic.ttf) distributed via Little Limit.

zombie_escape-1.3.5/README.md

@@ -0,0 +1,137 @@
+# Zombie Escape
+
+The city is overrun with zombies!
+You fled the horde, taking refuge in an abandoned factory.
+
+Inside, it's a maze. They won't get in easily.
+But you have no weapons. Night has fallen. The power's out, plunging the factory into darkness.
+
+Your only tool: a single flashlight.
+A car... somewhere inside... it's your only hope.
+
+Pierce the darkness and find the car!
+Then, escape this nightmare city!
+
+## Overview
+
+This game is a simple 2D top-down action game where the player aims to escape by finding and driving a car out of a large building infested with zombies. The player must evade zombies, break through walls to find a path, and then escape the building in a car.
+
+<img src="https://raw.githubusercontent.com/tos-kamiya/zombie-escape/main/imgs/screenshot1.png" width="400">
+<img src="https://raw.githubusercontent.com/tos-kamiya/zombie-escape/main/imgs/screenshot2.png" width="400">
+<img src="https://raw.githubusercontent.com/tos-kamiya/zombie-escape/main/imgs/screenshot3.png" width="400">
+
+## Controls
+
+-   **Player/Car Movement:** `W` / `↑` (Up), `A` / `←` (Left), `S` / `↓` (Down), `D` / `→` (Right)
+-   **Enter Car:** Overlap the player with the car.
+-   **Quit Game:** `ESC` key
+-   **Restart:** `R` key (on Game Over/Clear screen)
+-   **Window Scale (title/settings only):** `[` to shrink, `]` to enlarge
+-   **Time Acceleration:** Hold either `Shift` key to run the entire world 4x faster; release to return to normal speed.
+
+## Settings (Title Screen)
+
+Open **Settings** from the title to toggle gameplay assists:
+
+-   **Footprints:** Leave breadcrumb trails so you can backtrack in the dark.
+-   **Fast zombies:** Allow faster zombie variants; each zombie rolls a random speed between the normal and fast ranges.
+-   **Car hint:** After a delay, show a small triangle pointing toward the fuel (Stage 2 before pickup) or the car.
+-   **Steel beams:** Adds tougher single-cell obstacles (5% density) that block movement; hidden when stacked with an inner wall until that wall is destroyed.
+
+### Shared Seeds
+
+The title screen also lets you enter a numeric **seed**. Type digits (or pass `--seed <number>` on the CLI) to lock the procedural layout, wall placement, and pickups; share that seed with a friend and you will both play the exact same stage even on different machines. The current seed is shown at the bottom right of the title screen and in-game HUD. Backspace reverts to an automatically generated value so you can quickly roll a fresh challenge.
+
+## Game Rules
+
+### Stages
+
+At the title screen you can pick a stage:
+
+- **Stage 1: Find the Car** — locate the car and drive out (you already start with fuel).
+- **Stage 2: Fuel Run** — you start with no fuel; find a fuel can first, pick it up, then find the car and escape.
+- **Stage 3: Rescue Buddy** — same fuel hunt as Stage 2 (you begin empty) plus grab your buddy, pick them up with the car, then escape together.
+- **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.
+
+An objective reminder is shown at the top-left during play.
+
+### 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.).
+-   **Car:** A yellow rectangle. The player can enter by making contact with it.
+    -   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 who spawns somewhere in the building and waits.
+    -   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):** Light blue civilians scattered indoors.
+    - 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.
+
+### Win/Lose Conditions
+
+-   **Win Condition:** Escape the stage (level) boundaries while inside the car.
+    - Stage 1 and Stage 4 follow the base rule: find the car (already fueled) and drive out.
+    - Stage 2 also requires that you have collected the fuel can before driving out.
+    - Stage 3 requires both fuel and having picked up your buddy with the car before driving out.
+    - Stage 5 has no working cars; survive until dawn, then walk out through an exterior opening on foot.
+-   **Lose Condition:**
+    -   The player is touched by a zombie while *not* inside a car.
+    -   In Stage 3, if your buddy is caught (when visible), it's game over.
+    -   (Note: In the current implementation, the game does not end immediately when the car is destroyed. The player can search for another car and continue trying to escape.)
+
+## How to Run
+
+**Requirements: Python 3.10 or higher**
+
+Install using pipx:
+
+```sh
+pipx install zombie-escape
+```
+
+Alternatively, you can install using pip in a virtual environment:
+
+```sh
+pip install zombie-escape
+```
+
+Launch using the following command line:
+
+```sh
+zombie-escape
+```
+
+### Debug Mode
+
+<!-- For Stage 5 balancing or capture needs, run `zombie-escape --debug`. This hides the pause overlay and starts survival stages with 3 minutes remaining so you can immediately test late-night behavior. -->
+
+## License
+
+This project is licensed under the MIT License - see the [LICENSE.txt](LICENSE.txt) file for details.
+
+The bundled Silkscreen-Regular.ttf font follows the license terms of its original distribution.
+Please refer to the upstream website for details: https://fonts.google.com/specimen/Silkscreen
+
+The bundled misaki_gothic.ttf font (Misaki font by Num Kadoma) follows the license terms provided by Little Limit.
+Please refer to the official site for details: https://littlelimit.net/misaki.htm
+
+## Acknowledgements
+
+Significant assistance for many technical implementation and documentation aspects of this game's development was received from Google's large language model, Gemini (accessed during development), and from OpenAI's GPT-5. This included generating Python/Pygame code, suggesting rule adjustments, providing debugging support, and creating this README. Their rapid coding capabilities and contributions to problem-solving are greatly appreciated.
+
+Thanks to Jason Kottke, the author of the Silkscreen-Regular.ttf font used in the game.
+Thanks to Num Kadoma, the author of the Misaki font (misaki_gothic.ttf) distributed via Little Limit.

zombie_escape-1.3.5/pyproject.toml

@@ -0,0 +1,51 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "zombie-escape"
+dynamic = ["version"]
+description = "Top-down zombie survival game built with pygame."
+readme = "README.md"
+requires-python = ">=3.10"
+license = "MIT"
+keywords = []
+authors = [
+  { name = "Toshihiro Kamiya", email = "kamiya@mbj.nifty.com" },
+]
+classifiers = [
+  "Development Status :: 4 - Beta",
+  "Programming Language :: Python",
+  "Programming Language :: Python :: 3.10",
+  "Programming Language :: Python :: 3.11",
+  "Programming Language :: Python :: 3.12",
+  "Programming Language :: Python :: Implementation :: CPython",
+  "License :: OSI Approved :: MIT License",
+]
+dependencies = [
+  "pygame",
+  "platformdirs",
+  "python-i18n",
+]
+
+[project.urls]
+Homepage = "https://github.com/tos-kamiya/zombie-escape"
+
+[tool.hatch.version]
+path = "src/zombie_escape/__about__.py"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/zombie_escape"]
+include = [
+  "src/zombie_escape/assets/**",
+  "src/zombie_escape/locales/**",
+]
+
+[tool.hatch.build.targets.sdist]
+include = ["src/zombie_escape/**"]
+
+[project.gui-scripts]
+zombie-escape = "zombie_escape:main"
+
+[tool.ty.rules]
+unresolved-import = "ignore"

zombie_escape-1.3.5/src/zombie_escape/__about__.py

@@ -0,0 +1,4 @@
+# SPDX-FileCopyrightText: 2025-present Toshihiro Kamiya <kamiya@mbj.nifty.com>
+#
+# SPDX-License-Identifier: MIT
+__version__ = "1.3.5"

zombie_escape-1.3.5/src/zombie_escape/__init__.py

@@ -0,0 +1,7 @@
+# SPDX-FileCopyrightText: 2025-present Toshihiro Kamiya <kamiya@mbj.nifty.com>
+#
+# SPDX-License-Identifier: MIT
+
+from .zombie_escape import main as main
+
+__all__ = ["main"]

zombie_escape-1.3.5/src/zombie_escape/colors.py

@@ -0,0 +1,166 @@
+from __future__ import annotations
+
+from dataclasses import dataclass
+
+# Basic palette
+WHITE: tuple[int, int, int] = (255, 255, 255)
+BLACK: tuple[int, int, int] = (0, 0, 0)
+RED: tuple[int, int, int] = (255, 0, 0)
+GREEN: tuple[int, int, int] = (0, 255, 0)
+BLUE: tuple[int, int, int] = (0, 0, 255)
+GRAY: tuple[int, int, int] = (100, 100, 100)
+LIGHT_GRAY: tuple[int, int, int] = (200, 200, 200)
+YELLOW: tuple[int, int, int] = (255, 255, 0)
+ORANGE: tuple[int, int, int] = (255, 165, 0)
+DARK_RED: tuple[int, int, int] = (139, 0, 0)
+
+
+@dataclass(frozen=True)
+class EnvironmentPalette:
+    """Collection of colors that define the ambient environment."""
+
+    floor_primary: tuple[int, int, int]
+    floor_secondary: tuple[int, int, int]
+    outside: tuple[int, int, int]
+    inner_wall: tuple[int, int, int]
+    inner_wall_border: tuple[int, int, int]
+    outer_wall: tuple[int, int, int]
+    outer_wall_border: tuple[int, int, int]
+
+
+def _clamp(value: float) -> int:
+    return max(0, min(255, int(value)))
+
+
+def _adjust_color(
+    color: tuple[int, int, int], *, brightness: float = 1.0, saturation: float = 1.0
+) -> tuple[int, int, int]:
+    """Return color tinted by brightness/saturation multipliers."""
+
+    r, g, b = color
+    gray = 0.2126 * r + 0.7152 * g + 0.0722 * b
+    def mix(component: int) -> int:
+        value = gray + (component - gray) * saturation
+        value *= brightness
+        return _clamp(value)
+
+    return mix(r), mix(g), mix(b)
+
+
+DEFAULT_AMBIENT_PALETTE_KEY = "default"
+NO_FLASHLIGHT_PALETTE_KEY = "no_flashlight"
+DAWN_AMBIENT_PALETTE_KEY = "dawn"
+
+# Base palette used throughout gameplay (matches the previous constants).
+_DEFAULT_ENVIRONMENT_PALETTE = EnvironmentPalette(
+    floor_primary=(43, 57, 70),
+    floor_secondary=(50, 64, 79),
+    outside=(32, 60, 40),
+    inner_wall=(125, 101, 78),
+    inner_wall_border=(136, 110, 85),
+    outer_wall=(136, 135, 128),
+    outer_wall_border=(147, 146, 138),
+)
+
+# Dark, desaturated palette that sells the "alone without a flashlight" vibe.
+_GLOOM_ENVIRONMENT_PALETTE = EnvironmentPalette(
+    floor_primary=_adjust_color(
+        _DEFAULT_ENVIRONMENT_PALETTE.floor_primary, brightness=0.725, saturation=0.675
+    ),
+    floor_secondary=_adjust_color(
+        _DEFAULT_ENVIRONMENT_PALETTE.floor_secondary, brightness=0.74, saturation=0.65
+    ),
+    outside=_adjust_color(
+        _DEFAULT_ENVIRONMENT_PALETTE.outside, brightness=0.7, saturation=0.625
+    ),
+    inner_wall=_adjust_color(
+        _DEFAULT_ENVIRONMENT_PALETTE.inner_wall, brightness=0.775, saturation=0.7
+    ),
+    inner_wall_border=_adjust_color(
+        _DEFAULT_ENVIRONMENT_PALETTE.inner_wall_border, brightness=0.775, saturation=0.7
+    ),
+    outer_wall=_adjust_color(
+        _DEFAULT_ENVIRONMENT_PALETTE.outer_wall, brightness=0.75, saturation=0.675
+    ),
+    outer_wall_border=_adjust_color(
+        _DEFAULT_ENVIRONMENT_PALETTE.outer_wall_border, brightness=0.75, saturation=0.675
+    ),
+)
+
+_DAWN_ENVIRONMENT_PALETTE = EnvironmentPalette(
+    floor_primary=(58, 70, 84),
+    floor_secondary=(66, 78, 92),
+    outside=(118, 140, 104),
+    inner_wall=(125, 101, 78),
+    inner_wall_border=(136, 110, 85),
+    outer_wall=(136, 135, 128),
+    outer_wall_border=(147, 146, 138),
+)
+
+ENVIRONMENT_PALETTES: dict[str, EnvironmentPalette] = {
+    DEFAULT_AMBIENT_PALETTE_KEY: _DEFAULT_ENVIRONMENT_PALETTE,
+    NO_FLASHLIGHT_PALETTE_KEY: _GLOOM_ENVIRONMENT_PALETTE,
+    DAWN_AMBIENT_PALETTE_KEY: _DAWN_ENVIRONMENT_PALETTE,
+}
+
+
+def get_environment_palette(key: str | None) -> EnvironmentPalette:
+    """Return the color palette for the provided key (falls back to default)."""
+
+    if not key:
+        return ENVIRONMENT_PALETTES[DEFAULT_AMBIENT_PALETTE_KEY]
+    return ENVIRONMENT_PALETTES.get(key, ENVIRONMENT_PALETTES[DEFAULT_AMBIENT_PALETTE_KEY])
+
+
+def ambient_palette_key_for_flashlights(count: int) -> str:
+    """Return the palette key for the provided flashlight inventory count."""
+
+    return (
+        DEFAULT_AMBIENT_PALETTE_KEY
+        if max(0, count) > 0
+        else NO_FLASHLIGHT_PALETTE_KEY
+    )
+
+
+# World colors (default palette versions preserved for backwards compatibility).
+INTERNAL_WALL_COLOR: tuple[int, int, int] = _DEFAULT_ENVIRONMENT_PALETTE.inner_wall
+INTERNAL_WALL_BORDER_COLOR: tuple[int, int, int] = _DEFAULT_ENVIRONMENT_PALETTE.inner_wall_border
+OUTER_WALL_COLOR: tuple[int, int, int] = _DEFAULT_ENVIRONMENT_PALETTE.outer_wall
+OUTER_WALL_BORDER_COLOR: tuple[int, int, int] = _DEFAULT_ENVIRONMENT_PALETTE.outer_wall_border
+FLOOR_COLOR_PRIMARY: tuple[int, int, int] = _DEFAULT_ENVIRONMENT_PALETTE.floor_primary
+FLOOR_COLOR_SECONDARY: tuple[int, int, int] = _DEFAULT_ENVIRONMENT_PALETTE.floor_secondary
+FLOOR_COLOR_OUTSIDE: tuple[int, int, int] = _DEFAULT_ENVIRONMENT_PALETTE.outside
+FOOTPRINT_COLOR: tuple[int, int, int] = (110, 200, 255)
+STEEL_BEAM_COLOR: tuple[int, int, int] = (110, 50, 50)
+STEEL_BEAM_LINE_COLOR: tuple[int, int, int] = (180, 90, 90)
+
+
+__all__ = [
+    "WHITE",
+    "BLACK",
+    "RED",
+    "GREEN",
+    "BLUE",
+    "GRAY",
+    "LIGHT_GRAY",
+    "YELLOW",
+    "ORANGE",
+    "DARK_RED",
+    "DAWN_AMBIENT_PALETTE_KEY",
+    "INTERNAL_WALL_COLOR",
+    "INTERNAL_WALL_BORDER_COLOR",
+    "OUTER_WALL_COLOR",
+    "OUTER_WALL_BORDER_COLOR",
+    "FLOOR_COLOR_PRIMARY",
+    "FLOOR_COLOR_SECONDARY",
+    "FLOOR_COLOR_OUTSIDE",
+    "FOOTPRINT_COLOR",
+    "STEEL_BEAM_COLOR",
+    "STEEL_BEAM_LINE_COLOR",
+    "EnvironmentPalette",
+    "DEFAULT_AMBIENT_PALETTE_KEY",
+    "NO_FLASHLIGHT_PALETTE_KEY",
+    "ENVIRONMENT_PALETTES",
+    "get_environment_palette",
+    "ambient_palette_key_for_flashlights",
+]

zombie_escape-1.3.5/src/zombie_escape/config.py

@@ -0,0 +1,58 @@
+import json
+from copy import deepcopy
+from pathlib import Path
+from typing import Any
+
+from platformdirs import user_config_dir
+
+APP_NAME = "ZombieEscape"
+
+# Defaults for all configurable options
+DEFAULT_CONFIG: dict[str, Any] = {
+    "language": "en",
+    "footprints": {"enabled": True},
+    "fast_zombies": {"enabled": False, "ratio": 0.1},
+    "car_hint": {"enabled": True, "delay_ms": 180_000},
+    "steel_beams": {"enabled": False, "chance": 0.05},
+}
+
+
+def user_config_path() -> Path:
+    """Return the platform-specific config file path."""
+    return Path(user_config_dir(APP_NAME, APP_NAME)) / "config.json"
+
+
+def _deep_merge(base: dict[str, Any], override: dict[str, Any]) -> dict[str, Any]:
+    """Deep-merge dictionaries, with override winning on conflicts."""
+    merged: dict[str, Any] = deepcopy(base)
+    for key, val in override.items():
+        if isinstance(val, dict) and isinstance(merged.get(key), dict):
+            merged[key] = _deep_merge(merged[key], val)
+        else:
+            merged[key] = val
+    return merged
+
+
+def load_config(*, path: Path | None = None) -> tuple[dict[str, Any], Path]:
+    """Load config from disk, falling back to defaults on errors."""
+    config_path = path or user_config_path()
+    config: dict[str, Any] = deepcopy(DEFAULT_CONFIG)
+
+    try:
+        if config_path.exists():
+            loaded = json.loads(config_path.read_text(encoding="utf-8"))
+            if isinstance(loaded, dict):
+                config = _deep_merge(config, loaded)
+    except Exception as exc:  # noqa: BLE001
+        print(f"Failed to load config ({config_path}): {exc}")
+
+    return config, config_path
+
+
+def save_config(config: dict[str, Any], path: Path) -> None:
+    """Persist config to disk, creating parent dirs as needed."""
+    try:
+        path.parent.mkdir(parents=True, exist_ok=True)
+        path.write_text(json.dumps(config, indent=2), encoding="utf-8")
+    except Exception as exc:  # noqa: BLE001
+        print(f"Failed to save config ({path}): {exc}")