# Q1K3

First-person Quake-style FPS, 3 weapons, 5 enemy AI states.

```{raw} html
<span class="example-docs-badge">📄 Docs only</span>
<p><strong>Upstream:</strong> <a href="https://github.com/phoboslab/q1k3">https://github.com/phoboslab/q1k3</a></p>
```

**Tags:** `port` `tier-2`

# Q1K3: SimVX port

3D first-person shooter ported from [phoboslab/q1k3](https://github.com/phoboslab/q1k3)
(MIT, js13k 2021 entry, 13KB Quake-clone).

## Run

```bash
# Interactive (Vulkan window, mouse-capture FPS controls)
uv run python ported_games/q1k3/simvx_port/main.py

# Headless screenshot capture (8 stages)
uv run python ported_games/q1k3/simvx_port/main.py --test

# Web export
uv run simvx export web ported_games/q1k3/simvx_port/main.py \
    -o ported_games/q1k3/simvx_port/web/index.html
```

## Controls

- WASD or arrows: move
- Mouse: look
- LMB: fire
- SPACE or RMB: jump
- Q / E or mousewheel: switch weapon
- ESC: quit

## See also

- `PLAN.md`: port plan
- `NOTES.md`: engine friction, deviations, gaps


## Source

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