pixel_tower_defense/README.md

README

Strcuture

pixel_tower_defense/ | |-- main.py Entry point. Instantiates Game and calls run(). | Editor is commented out but importable. | |-- editor.py Standalone map editor (separate from the game loop). | Run by swapping the commented lines in main.py. | |-- requirements.txt Python dependencies (pygame, pygame_gui). | |-- assets/ | |-- images/ | | |-- tiles/ | | | |-- test/ Base/test tile set | | | |-- jungle/ Jungle tile set | | | -- desert/ Desert tile set (currently active in gameplay) | | -- entities/ | | |-- enemies/ | | | -- enemy.png Single enemy sprite | | -- towers/ | | -- cannon/ | | |-- shoot/ Animation frames (0.png, 1.png, ...) for the shoot action | | -- red_cannon.png Red tint variant shown when placement is blocked | |-- maps/ | | -- desert.json Serialised tilemap for the desert level, | | contains: tilemap dict, tile_size, waypoints list | -- theme/ | -- theme.json pygame_gui UI theme configuration | -- game/ |-- game.py Core Game class (window, clock, asset loading, screen routing) |-- camera.py Camera class (pan + zoom, world<->screen coordinate conversion) |-- tilemap.py Tilemap class (load/save JSON maps, tile rendering, placement rules) |-- enemy.py Enemy, EnemyGroup, HealthBar classes |-- tower.py Tower, TowerGroup classes |-- util.py Image loaders, coordinate converters, Animation class -- screens/ |-- base_screen.py Abstract base class for all screens |-- main_menu.py Main menu screen (Play / Quit buttons) -- game_play.py Gameplay screen (tilemap, enemies, towers, camera, UI)

Start the Game

python main.py

Strcuture is written with Claude

Ai was used as a thinking aid tool, only small parts are written with ai, most of the code is written by ScriptSorcerer

For resources, Coding with Russ and Fluffypotato helped me alot.