Initial commit

assets/README.md

@@ -0,0 +1,29 @@
+# Sprites
+
+Drop PNG files here to replace the colored-rectangle placeholders. Files are
+matched by name and scaled to the tile/entity size automatically — no code
+changes needed. Transparency (RGBA) is respected.
+
+Recognized filenames:
+
+| File                 | Used for                                   |
+|----------------------|--------------------------------------------|
+| `player.png`         | the player character                       |
+| `block.png`          | solid blocks and one-way platform ledges   |
+| `goal.png`           | the phone charger (level exit)             |
+| `fake_block.png`     | fall-through blocks (make it match block!) |
+| `spike.png`          | spikes / deadly patrol blocks              |
+| `moving_block.png`   | proximity-triggered sliding blocks         |
+| `patrol_block.png`   | perpetual moving platforms                 |
+| `crumble_block.png`  | blocks that crumble when stood on          |
+| `arrow_shooter.png`  | wall turrets                               |
+| `arrow.png`          | fired arrows                               |
+
+Any missing file falls back to a labeled colored rectangle, so the game is
+fully playable with no art at all.
+
+The PNGs currently here are simple defaults generated by `tools/gen_sprites.py`
+(pixel art drawn with pygame). Re-run `python tools/gen_sprites.py` to
+regenerate them, tweak the `draw_*` functions in that script, or just overwrite
+any PNG with your own art. Sprites are scaled nearest-neighbour, so pixel art
+stays crisp at any size.