TDisplayS3 Adventure Wiki

Welcome to the wiki of the TDisplayS3 Adventure project – a modular game framework for the LilyGo T-Display-S3 (ESP32-S3).

Contents

Project

Modules

The project is built as a modular mini-game engine:

src/
├── core/          Engine (board-independent)
│   ├── game.h     Game interface
│   ├── engine.*   Launcher loop
│   ├── input.*    Button input
│   ├── display.*  Display wrapper
│   └── buttons.h  Button debouncing
├── boards/        Board-specific configuration
│   └── board_tdisplay_s3.h
└── games/         The games
    ├── games.h      Game registry
    ├── eldoria/     Text adventure (fantasy)
    ├── neonrun/     Action runner (cyberpunk)
    │   └── sprites.*  Swappable graphics themes
    ├── neonshard/   Point-and-click (cyberpunk)
    ├── chipslide/   Sliding puzzle (15 components)
    └── neondash/    Jump'n'run (cyberpunk)
I want to… Page
Create my first game Quickstart
Understand the engine Game Development
Look up a function API Reference
Add a new board Board Support
Fix a problem Troubleshooting

Available Games

Game Genre Highlights
Eldoria Text adventure Scenes, inventory, combat dice, multiple endings
Neon Run Action/runner 3 lanes, dodge firewalls, collect chips, sprite themes
Neon Shard Point-and-click Comic story with branching dialogs and 2 endings
Chip Slide Sliding puzzle Sort 15 semiconductor components, procedural symbols, smooth slide animation
Neon Dash Jump’n’run One-button jump over obstacles, pace rises continuously, data chip bonus

Help

← Back to Docs Home