README.md

---
title: VectorVoid Grid Wars
emoji: 🎮
colorFrom: blue
colorTo: red
sdk: gradio
app_file: app.py
pinned: false
license: mit
---

# VectorVoid: The Grid War

Tron-inspired 3D cluster optimization game with **PS4 / gamepad support**.

## 2-Player (Room RR)
Both players open this Space — no install needed.
1. Click **2-PLAYER — ROOM RR**
2. Tutorial → **ENTER THE GRID**
3. Buddy appears as red Tron avatar (max 2 players)

## Controls

### Keyboard & Mouse
- Drag centroids · Mouse orbit · Click weapons in HUD

### PS4 / DualShock / Xbox Gamepad
- **Left stick** — orbit camera
- **Right stick (X)** — rotate shield
- **Square / D-Pad Up** — Centroid Slam
- **Triangle / D-Pad Left** — Vector Hook
- **Circle / D-Pad Right** — Rotor Shield
- **Cross** — fire active weapon
- **L1 / R1** — fine shield rotation
- **Options** — confirm on title screen

Every move computes real SNR. Improve clusters, save recipes, climb the leaderboard.