texastoast 0.1.0__tar.gz

texastoast-0.1.0/.gitignore

@@ -0,0 +1,13 @@
+__pycache__/
+*.py[cod]
+*$py.class
+*.egg-info/
+dist/
+build/
+.eggs/
+*.egg
+.venv/
+venv/
+.env
+.pytest_cache/
+.mypy_cache/

texastoast-0.1.0/LICENSE

@@ -0,0 +1,17 @@
+Apache License
+Version 2.0, January 2004
+http://www.apache.org/licenses/
+
+Copyright 2026 magmacrunch media
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.

texastoast-0.1.0/PKG-INFO

@@ -0,0 +1,235 @@
+Metadata-Version: 2.5
+Name: texastoast
+Version: 0.1.0
+Summary: Python RPG engine and Magma Hub I2C layer for magmacrunch game systems
+Author: magmacrunch media
+License-Expression: Apache-2.0
+License-File: LICENSE
+Keywords: game,i2c,raspberry-pi,rpg,tkinter
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: Apache Software License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Games/Entertainment
+Classifier: Topic :: System :: Hardware :: Hardware Drivers
+Requires-Python: >=3.10
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0; extra == 'dev'
+Provides-Extra: hardware
+Requires-Dist: smbus2>=0.6; extra == 'hardware'
+Description-Content-Type: text/markdown
+
+# texastoast
+
+Python RPG engine and Magma Hub I2C layer for magmacrunch game systems.
+
+A tkinter-based 2D game engine inspired by [adenosine](https://github.com/magmacrunchmedia/adenosine), with I2C hardware abstraction for Raspberry Pi + Pico "Magma Hub" controllers.
+
+## Install
+
+```bash
+# Basic install (keyboard-only, no hardware)
+pip install -e .
+
+# With I2C hardware support (Raspberry Pi)
+pip install -e ".[hardware]"
+
+# Development (includes pytest)
+pip install -e ".[dev]"
+```
+
+## Quick Start
+
+```python
+from texastoast import Game, CanvasRenderer, TileMap, Entity, KeyboardInput
+
+game = Game(title="My Game", width=400, height=300, fps=30)
+renderer = CanvasRenderer(game.canvas, 400, 300)
+keyboard = KeyboardInput(game.root)
+
+tilemap = TileMap([
+    [1, 1, 1, 1, 1],
+    [1, 0, 0, 0, 1],
+    [1, 1, 1, 1, 1],
+], tile_size=20, solid_tiles={1})
+
+player = Entity(x=40, y=40, width=14, height=14, speed=100)
+
+def update(dt):
+    state = keyboard.poll()
+    player.move(state.dx, state.dy, tilemap)
+    renderer.camera.follow(player.center_x, player.center_y,
+                           map_width=tilemap.width, map_height=tilemap.height)
+
+def render():
+    renderer.clear()
+    renderer.draw_tilemap(tilemap, {0: "#7cb342", 1: "#5d4037"})
+    renderer.draw_rect(player.x, player.y, player.width, player.height, "#e94560")
+
+game.set_update(update)
+game.set_render(render)
+game.start()
+```
+
+## Examples
+
+| Example | Description |
+|---------|-------------|
+| `examples/hello_world.py` | Minimal movement demo |
+| `examples/tilemap_demo.py` | Walk around a larger map |
+| `examples/sprite_demo.py` | Animated character sprites |
+| `examples/rpg_demo.py` | NPCs, dialogue, menus, HUD |
+| `examples/game_template.py` | Full game starting point |
+| `examples/magma_hub_demo.py` | I2C controller input |
+| `tools/tile_editor.py` | Tile map editor GUI |
+
+## API Reference
+
+### Core
+
+```python
+from texastoast import Game, Config, GameLoop
+
+game = Game(title="My Game", width=640, height=480, fps=30)
+game.set_update(update_fn)  # def update(dt: float): ...
+game.set_render(render_fn)  # def render(): ...
+game.start()
+```
+
+### Rendering
+
+```python
+from texastoast import CanvasRenderer, Camera
+
+renderer = CanvasRenderer(game.canvas, 640, 480)
+renderer.draw_tilemap(tilemap, {0: "#7cb342", 1: "#5d4037"})
+renderer.draw_rect(x, y, w, h, color)
+renderer.draw_image(x, y, photo_image)
+renderer.draw_hud_text(x, y, text, fill="#fff", font=("Courier", 10))
+
+# Camera
+renderer.camera.follow(target_x, target_y, map_width=800, map_height=600)
+renderer.camera.set_position(x, y)
+```
+
+### World
+
+```python
+from texastoast import TileMap, Entity, AABB
+
+# Tile map
+tilemap = TileMap(grid_data, tile_size=16, solid_tiles={1, 2})
+tilemap = TileMap.from_file("map.json", tile_size=16)
+tilemap.save("map.json")
+tilemap.get(col, row)  # -> tile_id
+tilemap.is_solid(col, row)  # -> bool
+tilemap.is_solid_at(world_x, world_y)  # -> bool
+
+# Entity
+player = Entity(x=0, y=0, width=16, height=16, speed=100)
+player.move(dx, dy, tilemap)  # with collision
+player.aabb  # -> AABB for overlap checks
+player.collides_with(other_entity)  # -> bool
+```
+
+### Input
+
+```python
+from texastoast import KeyboardInput, InputState
+
+keyboard = KeyboardInput(game.root)
+state = keyboard.poll()
+
+state.up, state.down, state.left, state.right  # bool
+state.a, state.b, state.start, state.select     # bool
+state.dx, state.dy                               # float (-1, 0, 1)
+state.is_any_direction()                         # bool
+```
+
+### I2C (Magma Hub)
+
+```python
+from texastoast import I2CBus, MagmaHub, MagmaHubInput, CompositeInput
+
+# Direct I2C
+bus = I2CBus(1)  # I2C bus number
+hubs = MagmaHub.scan_buses(bus_numbers=[1])
+hub = hubs[0]
+hub.poll()  # -> [ControllerState, ...]
+
+# Input adapter (same interface as KeyboardInput)
+hub_input = MagmaHubInput(hub, controller_index=0)
+state = hub_input.poll()
+
+# Auto-fallback composite
+controls = CompositeInput(keyboard, hub_input)
+state = controls.poll()  # uses hub if connected, else keyboard
+```
+
+### UI
+
+```python
+from texastoast.ui import DialogueBox, Menu, HUD
+
+# Dialogue
+dialogue = DialogueBox(game.canvas, 640, 480)
+dialogue.show("Hello, world!", speaker="NPC", on_complete=callback)
+dialogue.dismiss()
+
+# Menu
+menu = Menu(game.canvas, 640, 480)
+menu.show(["Play", "Settings", "Quit"],
+          on_select=lambda i, label: print(label),
+          on_cancel=lambda: menu.hide())
+menu.move_up()
+menu.move_down()
+menu.confirm()
+
+# HUD
+hud = HUD(game.canvas, 640, 480)
+hud.add_stat("hp", "HP", value=100, max_value=100, color="#e94560")
+hud.set_stat("hp", 75)
+hud.add_text("score", "Score: 0", 10, 10, fill="#fdd835")
+hud.set_text("score", "Score: 100")
+hud.render()
+```
+
+## Magma Hub Hardware
+
+The Magma Hub is a Raspberry Pico acting as an I2C slave, providing controller input (buttons + joystick) to the Pi master. texastoast abstracts this hardware so games don't need to know about I2C details.
+
+### Protocol
+
+| Address | Data | Description |
+|---------|------|-------------|
+| 0x00 | 8-bit | Button status (bitmask) |
+| 0x01 | 8-bit | Joystick status |
+
+### Button Bitmask
+
+| Bit | Button |
+|-----|--------|
+| 0 | Up |
+| 1 | Down |
+| 2 | Left |
+| 3 | Right |
+| 4 | A |
+| 5 | B |
+| 6 | Start |
+| 7 | Select |
+
+## Design Philosophy
+
+- **No opinions** — engines provide systems, you wire them together
+- **Configurable** — pass callbacks and data, don't inherit from base classes
+- **Tiny** — small, focused modules with minimal dependencies
+- **Graceful fallback** — I2C hardware is optional, keyboard always works
+- **Testable** — game logic doesn't depend on tkinter
+
+## License
+
+Apache-2.0. Copyright 2026 magmacrunch media.

texastoast-0.1.0/README.md

@@ -0,0 +1,210 @@
+# texastoast
+
+Python RPG engine and Magma Hub I2C layer for magmacrunch game systems.
+
+A tkinter-based 2D game engine inspired by [adenosine](https://github.com/magmacrunchmedia/adenosine), with I2C hardware abstraction for Raspberry Pi + Pico "Magma Hub" controllers.
+
+## Install
+
+```bash
+# Basic install (keyboard-only, no hardware)
+pip install -e .
+
+# With I2C hardware support (Raspberry Pi)
+pip install -e ".[hardware]"
+
+# Development (includes pytest)
+pip install -e ".[dev]"
+```
+
+## Quick Start
+
+```python
+from texastoast import Game, CanvasRenderer, TileMap, Entity, KeyboardInput
+
+game = Game(title="My Game", width=400, height=300, fps=30)
+renderer = CanvasRenderer(game.canvas, 400, 300)
+keyboard = KeyboardInput(game.root)
+
+tilemap = TileMap([
+    [1, 1, 1, 1, 1],
+    [1, 0, 0, 0, 1],
+    [1, 1, 1, 1, 1],
+], tile_size=20, solid_tiles={1})
+
+player = Entity(x=40, y=40, width=14, height=14, speed=100)
+
+def update(dt):
+    state = keyboard.poll()
+    player.move(state.dx, state.dy, tilemap)
+    renderer.camera.follow(player.center_x, player.center_y,
+                           map_width=tilemap.width, map_height=tilemap.height)
+
+def render():
+    renderer.clear()
+    renderer.draw_tilemap(tilemap, {0: "#7cb342", 1: "#5d4037"})
+    renderer.draw_rect(player.x, player.y, player.width, player.height, "#e94560")
+
+game.set_update(update)
+game.set_render(render)
+game.start()
+```
+
+## Examples
+
+| Example | Description |
+|---------|-------------|
+| `examples/hello_world.py` | Minimal movement demo |
+| `examples/tilemap_demo.py` | Walk around a larger map |
+| `examples/sprite_demo.py` | Animated character sprites |
+| `examples/rpg_demo.py` | NPCs, dialogue, menus, HUD |
+| `examples/game_template.py` | Full game starting point |
+| `examples/magma_hub_demo.py` | I2C controller input |
+| `tools/tile_editor.py` | Tile map editor GUI |
+
+## API Reference
+
+### Core
+
+```python
+from texastoast import Game, Config, GameLoop
+
+game = Game(title="My Game", width=640, height=480, fps=30)
+game.set_update(update_fn)  # def update(dt: float): ...
+game.set_render(render_fn)  # def render(): ...
+game.start()
+```
+
+### Rendering
+
+```python
+from texastoast import CanvasRenderer, Camera
+
+renderer = CanvasRenderer(game.canvas, 640, 480)
+renderer.draw_tilemap(tilemap, {0: "#7cb342", 1: "#5d4037"})
+renderer.draw_rect(x, y, w, h, color)
+renderer.draw_image(x, y, photo_image)
+renderer.draw_hud_text(x, y, text, fill="#fff", font=("Courier", 10))
+
+# Camera
+renderer.camera.follow(target_x, target_y, map_width=800, map_height=600)
+renderer.camera.set_position(x, y)
+```
+
+### World
+
+```python
+from texastoast import TileMap, Entity, AABB
+
+# Tile map
+tilemap = TileMap(grid_data, tile_size=16, solid_tiles={1, 2})
+tilemap = TileMap.from_file("map.json", tile_size=16)
+tilemap.save("map.json")
+tilemap.get(col, row)  # -> tile_id
+tilemap.is_solid(col, row)  # -> bool
+tilemap.is_solid_at(world_x, world_y)  # -> bool
+
+# Entity
+player = Entity(x=0, y=0, width=16, height=16, speed=100)
+player.move(dx, dy, tilemap)  # with collision
+player.aabb  # -> AABB for overlap checks
+player.collides_with(other_entity)  # -> bool
+```
+
+### Input
+
+```python
+from texastoast import KeyboardInput, InputState
+
+keyboard = KeyboardInput(game.root)
+state = keyboard.poll()
+
+state.up, state.down, state.left, state.right  # bool
+state.a, state.b, state.start, state.select     # bool
+state.dx, state.dy                               # float (-1, 0, 1)
+state.is_any_direction()                         # bool
+```
+
+### I2C (Magma Hub)
+
+```python
+from texastoast import I2CBus, MagmaHub, MagmaHubInput, CompositeInput
+
+# Direct I2C
+bus = I2CBus(1)  # I2C bus number
+hubs = MagmaHub.scan_buses(bus_numbers=[1])
+hub = hubs[0]
+hub.poll()  # -> [ControllerState, ...]
+
+# Input adapter (same interface as KeyboardInput)
+hub_input = MagmaHubInput(hub, controller_index=0)
+state = hub_input.poll()
+
+# Auto-fallback composite
+controls = CompositeInput(keyboard, hub_input)
+state = controls.poll()  # uses hub if connected, else keyboard
+```
+
+### UI
+
+```python
+from texastoast.ui import DialogueBox, Menu, HUD
+
+# Dialogue
+dialogue = DialogueBox(game.canvas, 640, 480)
+dialogue.show("Hello, world!", speaker="NPC", on_complete=callback)
+dialogue.dismiss()
+
+# Menu
+menu = Menu(game.canvas, 640, 480)
+menu.show(["Play", "Settings", "Quit"],
+          on_select=lambda i, label: print(label),
+          on_cancel=lambda: menu.hide())
+menu.move_up()
+menu.move_down()
+menu.confirm()
+
+# HUD
+hud = HUD(game.canvas, 640, 480)
+hud.add_stat("hp", "HP", value=100, max_value=100, color="#e94560")
+hud.set_stat("hp", 75)
+hud.add_text("score", "Score: 0", 10, 10, fill="#fdd835")
+hud.set_text("score", "Score: 100")
+hud.render()
+```
+
+## Magma Hub Hardware
+
+The Magma Hub is a Raspberry Pico acting as an I2C slave, providing controller input (buttons + joystick) to the Pi master. texastoast abstracts this hardware so games don't need to know about I2C details.
+
+### Protocol
+
+| Address | Data | Description |
+|---------|------|-------------|
+| 0x00 | 8-bit | Button status (bitmask) |
+| 0x01 | 8-bit | Joystick status |
+
+### Button Bitmask
+
+| Bit | Button |
+|-----|--------|
+| 0 | Up |
+| 1 | Down |
+| 2 | Left |
+| 3 | Right |
+| 4 | A |
+| 5 | B |
+| 6 | Start |
+| 7 | Select |
+
+## Design Philosophy
+
+- **No opinions** — engines provide systems, you wire them together
+- **Configurable** — pass callbacks and data, don't inherit from base classes
+- **Tiny** — small, focused modules with minimal dependencies
+- **Graceful fallback** — I2C hardware is optional, keyboard always works
+- **Testable** — game logic doesn't depend on tkinter
+
+## License
+
+Apache-2.0. Copyright 2026 magmacrunch media.

texastoast-0.1.0/examples/game_template.py

@@ -0,0 +1,181 @@
+#!/usr/bin/env python3
+"""Game template — a starting point for new texastoast games.
+
+This demonstrates the full feature set:
+  - Game loop with fixed timestep
+  - Tile map with collision
+  - Camera following player
+  - Keyboard input
+  - HUD with stats
+  - Dialogue system
+  - Pause menu
+
+Copy this file and modify it to build your own game.
+"""
+
+from texastoast import Game, CanvasRenderer, TileMap, Entity, KeyboardInput
+from texastoast.ui import DialogueBox, Menu, HUD
+
+# ── Config ──────────────────────────────────────────────────────────
+
+SCREEN_W = 400
+SCREEN_H = 300
+TILE_SIZE = 20
+FPS = 30
+PLAYER_SPEED = 100
+
+# ── Colors ──────────────────────────────────────────────────────────
+
+TILE_COLORS = {
+    0: "#7cb342",  # grass
+    1: "#5d4037",  # wall
+    2: "#1e88e5",  # water
+    3: "#fdd835",  # path
+}
+
+# ── Map ─────────────────────────────────────────────────────────────
+
+LEVEL_1 = [
+    [1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1],
+    [1, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 1],
+    [1, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 1],
+    [1, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 1],
+    [1, 0, 0, 0, 1, 1, 0, 0, 0, 0, 0, 0, 0, 1, 1, 0, 0, 0, 0, 1],
+    [1, 0, 0, 0, 1, 0, 0, 0, 0, 0, 0, 0, 0, 0, 1, 0, 0, 0, 0, 1],
+    [1, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 1],
+    [1, 0, 0, 0, 0, 0, 0, 0, 2, 2, 2, 0, 0, 0, 0, 0, 0, 0, 0, 1],
+    [1, 0, 0, 0, 0, 0, 0, 0, 2, 2, 2, 0, 0, 0, 0, 0, 0, 0, 0, 1],
+    [1, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 1],
+    [1, 0, 0, 0, 1, 0, 0, 0, 0, 0, 0, 0, 0, 0, 1, 0, 0, 0, 0, 1],
+    [1, 0, 0, 0, 1, 1, 0, 0, 0, 0, 0, 0, 0, 1, 1, 0, 0, 0, 0, 1],
+    [1, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 1],
+    [1, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 1],
+    [1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1],
+]
+
+# ── Init ────────────────────────────────────────────────────────────
+
+game = Game(title="texastoast game template", width=SCREEN_W, height=SCREEN_H, fps=FPS)
+renderer = CanvasRenderer(game.canvas, SCREEN_W, SCREEN_H)
+keyboard = KeyboardInput(game.root)
+dialogue = DialogueBox(game.canvas, SCREEN_W, SCREEN_H)
+menu = Menu(game.canvas, SCREEN_W, SCREEN_H)
+hud = HUD(game.canvas, SCREEN_W, SCREEN_H)
+
+tilemap = TileMap(LEVEL_1, tile_size=TILE_SIZE, solid_tiles={1, 2})
+player = Entity(x=60, y=60, width=14, height=14, speed=PLAYER_SPEED)
+
+# ── Game state ──────────────────────────────────────────────────────
+
+paused = False
+showing_dialogue = False
+hp = 100
+xp = 0
+score = 0
+
+hud.add_stat("hp", "HP", value=hp, max_value=100, color="#e94560")
+hud.add_stat("xp", "XP", value=xp, max_value=100, color="#4fc3f7")
+hud.add_text("score", "Score: 0", SCREEN_W - 120, 4, fill="#fdd835")
+hud.add_text("pos", "", 4, SCREEN_H - 16, fill="#666666", font=("Courier", 8))
+
+
+# ── Input handling ──────────────────────────────────────────────────
+
+def handle_keypress(event):
+    global paused, showing_dialogue, hp, xp, score
+
+    key = event.keysym
+
+    if dialogue.active:
+        if key in ("z", "Z", "Return", "space"):
+            dialogue.dismiss()
+        return
+
+    if menu.active:
+        if key in ("Up", "w", "W"):
+            menu.move_up()
+        elif key in ("Down", "s", "S"):
+            menu.move_down()
+        elif key in ("z", "Z", "Return"):
+            menu.confirm()
+        elif key in ("x", "X", "Escape"):
+            menu.cancel()
+        return
+
+    if key in ("Escape", "p", "P"):
+        toggle_pause()
+    elif key in ("z", "Z", "Return"):
+        # Example: press Z near water to "fish"
+        col, row = tilemap.to_grid_coords(player.center_x, player.center_y)
+        for dr in range(-1, 2):
+            for dc in range(-1, 2):
+                if tilemap.get(col + dc, row + dr) == 2:
+                    showing_dialogue = True
+                    dialogue.show("You caught a fish! +10 XP",
+                                  on_complete=_on_dialogue_done)
+                    xp = min(100, xp + 10)
+                    hud.set_stat("xp", xp)
+                    return
+
+
+def _on_dialogue_done():
+    global showing_dialogue
+    showing_dialogue = False
+
+
+def toggle_pause():
+    global paused
+    paused = not paused
+    if paused:
+        menu.show(["Resume", "Restart", "Quit"],
+                   on_select=_on_menu_select,
+                   on_cancel=lambda: toggle_pause(),
+                   title="PAUSED")
+    else:
+        menu.hide()
+
+
+def _on_menu_select(index, label):
+    global paused, hp, xp, score
+    if label == "Resume":
+        paused = False
+    elif label == "Restart":
+        hp, xp, score = 100, 0, 0
+        player.x, player.y = 60, 60
+        hud.set_stat("hp", hp)
+        hud.set_stat("xp", xp)
+        paused = False
+    elif label == "Quit":
+        game.quit()
+
+
+game.bind_key("<Key>", handle_keypress)
+
+
+# ── Update ──────────────────────────────────────────────────────────
+
+def update(dt):
+    if dialogue.active or menu.active or paused:
+        return
+
+    state = keyboard.poll()
+    player.move(state.dx, state.dy, tilemap)
+    renderer.camera.follow(
+        player.center_x, player.center_y,
+        map_width=tilemap.width, map_height=tilemap.height,
+    )
+    hud.set_text("pos", f"({int(player.x)}, {int(player.y)})")
+
+
+# ── Render ──────────────────────────────────────────────────────────
+
+def render():
+    renderer.clear()
+    renderer.draw_tilemap(tilemap, TILE_COLORS)
+    renderer.draw_rect(player.x, player.y, player.width, player.height, "#e94560")
+    hud.render()
+
+
+game.set_update(update)
+game.set_render(render)
+game.start()

texastoast-0.1.0/examples/hello_world.py

@@ -0,0 +1,51 @@
+"""Minimal texastoast example — a colored square you can move with arrow keys."""
+
+from texastoast import Game, CanvasRenderer, TileMap, Entity, KeyboardInput
+
+# --- Setup ---
+game = Game(title="texastoast hello", width=320, height=240, fps=30)
+renderer = CanvasRenderer(game.canvas, 320, 240)
+keyboard = KeyboardInput(game.root)
+
+# A tiny map: 0 = grass, 1 = wall
+tilemap = TileMap(
+    [
+        [1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1],
+        [1, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 1],
+        [1, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 1],
+        [1, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 1],
+        [1, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 1],
+        [1, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 1],
+        [1, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 1],
+        [1, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 1],
+        [1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1],
+    ],
+    tile_size=16,
+    solid_tiles={1},
+)
+
+TILE_COLORS = {0: "#7cb342", 1: "#5d4037"}
+
+player = Entity(x=48, y=48, width=12, height=12, speed=100)
+
+
+# --- Update ---
+def update(dt: float):
+    state = keyboard.poll()
+    player.move(state.dx, state.dy, tilemap)
+    renderer.camera.follow(
+        player.center_x, player.center_y,
+        map_width=tilemap.width, map_height=tilemap.height,
+    )
+
+
+# --- Render ---
+def render():
+    renderer.clear()
+    renderer.draw_tilemap(tilemap, TILE_COLORS)
+    renderer.draw_rect(player.x, player.y, player.width, player.height, "#e94560")
+
+
+game.set_update(update)
+game.set_render(render)
+game.start()