# SNKRX

Wave-based arena, particles, screenshake, slow-motion, bloom.

```{raw} html
<a class="example-run-button" href="../demos/ports_snkrx.html">▶ Run in browser</a>
<p><strong>Upstream:</strong> <a href="https://github.com/Luminware/SNKRX">https://github.com/Luminware/SNKRX</a></p>
```

**Tags:** `port` `tier-1`

# SNKRX (SimVX port)

Snake auto-battler arena roguelite. SimVX port of [a327ex/SNKRX](https://github.com/a327ex/SNKRX).

## Run

```bash
# from /home/fezzik/dev/simvx
uv run python ported_games/snkrx/simvx_port/main.py
```

Headless smoke test (writes `screenshots/frame_30.png`, etc.):

```bash
uv run python ported_games/snkrx/simvx_port/main.py --test
```

Scripted 9-stage capture (writes `screenshots/stage_*.png`):

```bash
uv run python ported_games/snkrx/simvx_port/harness.py
```

Web export:

```bash
uv run simvx export web ported_games/snkrx/simvx_port/main.py \
    -o ported_games/snkrx/simvx_port/web/index.html
```

## Controls

- **MOUSE / A D**: steer the snake head (mouse aim, or A/D rotate)
- **SPACE / ENTER**: confirm in menus, advance buy screen
- **R**: reroll (buy screen, costs 2 gold)
- **S**: skip (buy screen)
- **ESC**: quit

## Acceptance scope

5 waves with full juice (particles, screenshake, slow-mo, bloom) plus a
build/upgrade screen between waves with three classes (Warrior / Archer /
Mage). Boss spawns at level 5.

See `../NOTES.md` for engine friction, deliberate cuts, and architecture
notes.


## Source

```{literalinclude} ../../examples/ports/snkrx/main.py
:language: python
:linenos:
```