Shadowtrance
a75279c96c
* New Apps - Lot 1 Trying to mix it up a little with some fun, useful and just weird. Adds more new apps... Brainfuck Breakout Magic 8 Ball Todo List Also re-organised the app name part of main.yml * Fix build? * fixes * and some more * Update Brainfuck.cpp * i heard you like fixes with your fixes * no hard coded paths
136 lines
5.2 KiB
Markdown
136 lines
5.2 KiB
Markdown
# Breakout
|
|
|
|
A classic brick-breaking arcade game inspired by Arkanoid, built for Tactility devices. Features power-up capsules, multi-hit bricks, multi-ball action, and responsive scaling across all screen sizes.
|
|
|
|
## Features
|
|
|
|
- **8 brick colors** with per-color scoring (50-120 points)
|
|
- **Silver bricks** that take multiple hits to break (level 3+)
|
|
- **Gold bricks** that are indestructible (level 5+)
|
|
- **7 power-up capsules** that drop from destroyed bricks
|
|
- **12 handcrafted level patterns** + seeded procedural generation (level 13+)
|
|
- **High score** persistence across sessions
|
|
- **Sound toggle** with persistent setting
|
|
- **Responsive scaling** for all Tactility devices (Cardputer to 800x480+ panels)
|
|
- Touch, Trackball and Keyboard input support
|
|
|
|
## Levels
|
|
|
|
Each level has a unique brick layout pattern. Colors rotate each level, and Silver/Gold bricks are added as difficulty increases.
|
|
|
|
```text
|
|
Level 1: Full Grid Level 2: Checkerboard Level 3: Diamond
|
|
[][][][][][][][] [] [] [] [] [] [][][][][][]
|
|
[][][][][][][][] [] [] [] [] [] [][][][]
|
|
[][][][][][][][] [] [] [] [] [] [][][][][][]
|
|
[][][][][][][][] [] [] [] [] [] [][][][]
|
|
|
|
Level 4: Stripes Level 5: Pyramid Level 6: Inverted V
|
|
[][][][][][][][] [][][][][][][][] []
|
|
. [][][][][] . [][][][]
|
|
[][][][][][][][] . [][][] . [][][][][][]
|
|
. [] . [][][][][][][][]
|
|
|
|
Level 7: Vert Stripes Level 8: Zigzag Level 9: Blocks
|
|
[] [] [] [] [] [][] . [][] . [][] . [][] .
|
|
[] [] [] [] [] . [][] . [][] [][] . [][] .
|
|
[] [] [] [] [] [][] . [][] . . [][] . [][]
|
|
[] [] [] [] [] . [][] . [][] . [][] . [][]
|
|
|
|
Level 10: Double Diamond Level 11: Border Frame Level 12: Center Cross
|
|
[][] [][] [][][][][][][][] [] []
|
|
[][][] [][][] [][][][][][]
|
|
[][] [][] [][][][][][][][] [] []
|
|
[][][] [][][] [][][][][][]
|
|
```
|
|
|
|
After level 12, layouts are **procedurally generated** using a seeded algorithm — the same level number always produces the same layout.
|
|
|
|
## Power-Up Capsules
|
|
|
|
Capsules drop from destroyed bricks (~15% chance) and fall toward the paddle. Catch them to activate!
|
|
|
|
```text
|
|
Capsule drops from brick: Catch with paddle:
|
|
|
|
[brick] |C|
|
|
|C| =============
|
|
|C| ^^^paddle^^^
|
|
|C|
|
|
v
|
|
=============
|
|
```
|
|
|
|
| Capsule | Color | Letter | Effect |
|
|
|---------|-------|--------|--------|
|
|
| Laser | `Red` | **L** | Paddle auto-fires lasers upward, destroying bricks on contact |
|
|
| Extend | `Blue` | **E** | Paddle width increases by 50% |
|
|
| Catch | `Green` | **C** | Ball sticks to paddle on contact, auto-releases after 3 seconds |
|
|
| Slow | `Orange` | **S** | Ball speed reduced to 60%, gradually recovers over 5 seconds |
|
|
| BreakOut | `Pink` | **B** | Opens exit on right wall — move paddle to exit for +10,000 pts |
|
|
| Split | `Cyan` | **D** | Splits ball into 3! Life lost only when ALL balls are gone |
|
|
| Extra Life | `Grey` | **+** | +1 life (rarest drop) |
|
|
|
|
Power-ups reset on life lost or level clear. No capsules drop while multiple balls are active.
|
|
|
|
## Brick Types
|
|
|
|
```text
|
|
Normal bricks: Silver bricks: Gold bricks:
|
|
+-----------+ +===========+ +###########+
|
|
| colored | | multi-hit | | unbreakable|
|
|
+-----------+ +===========+ +###########+
|
|
1 hit, gone 2-3 hits indestructible
|
|
50-120 pts 50 x level bounces ball
|
|
```
|
|
|
|
| Type | Appears | Hits | Score | Visual |
|
|
|------|---------|------|-------|--------|
|
|
| Normal | All levels | 1 | 50-120 (by color) | Colored, no border |
|
|
| Silver | Level 3+ | 2 (lvl 3-6), 3 (lvl 7+) | 50 x level | Grey with white border, darkens on hit |
|
|
| Gold | Level 5+ | Indestructible | - | Amber with gold border |
|
|
|
|
## Scoring
|
|
|
|
| Source | Points |
|
|
|--------|--------|
|
|
| Purple brick | 50 |
|
|
| Orange brick | 60 |
|
|
| Cyan brick | 70 |
|
|
| Green brick | 80 |
|
|
| Red brick | 90 |
|
|
| Blue brick | 100 |
|
|
| Pink brick | 110 |
|
|
| Yellow brick | 120 |
|
|
| Silver brick | 50 x level |
|
|
| BreakOut exit | 10,000 |
|
|
|
|
Ball speed increases by +0.15 for every 5 bricks destroyed, and +0.3 per level.
|
|
|
|
## Controls
|
|
|
|
**Touchscreen:** Touch/drag to move paddle, tap to launch ball or release caught ball
|
|
**Trackball:** Move trackball left and right to move paddle, press to launch ball or release caught ball
|
|
|
|
**Keyboard:**
|
|
| Key | Action |
|
|
|-----|--------|
|
|
| `LEFT` / `a` / `,` | Move paddle left |
|
|
| `RIGHT` / `d` / `/` | Move paddle right |
|
|
| `SPACE` / `ENTER` | Launch ball / release caught ball / pause |
|
|
|
|
**Toolbar:** Pause button and sound toggle button
|
|
|
|
## Requirements
|
|
|
|
- Tactility SDK 0.7.0-dev
|
|
- ESP32, ESP32-S3, ESP32-C6, or ESP32-P4
|
|
|
|
## Building
|
|
|
|
```bash
|
|
python tactility.py build
|
|
# or build + install + run:
|
|
python tactility.py bir <device-ip>
|
|
```
|