Slither quest

[prabii]

Slither Quest — Multiplayer Snake Game -Track b -63

A real-time browser-based multiplayer snake game (Slither.io-style) built for the Build Beyond Limits 2.0 Hackathon, powered by Valkey and
Breeth AI.

---

What It Does

Players control a growing snake on a shared 4000×4000 world. Move your snake with the mouse or WASD/arrow keys, eat glowing pellets to grow
longer, and avoid crashing into other players. Hold click or space to boost — but boosting burns your length and drops pellets for others
to eat. The last snake standing wins.

---

Architecture

The game is server-authoritative — the browser never touches game logic. It only sends two things: direction and boost. The Node.js server
runs a 25 ticks/second game loop that owns every position, collision, and score. This prevents cheating and keeps all players perfectly in
sync.

Browser ──{ dir, boost }──► Node.js Game Loop (25 Hz)
◄──{ world snapshot }──
│
┌───────┴────────┐
Valkey (Aiven) Breeth AI
leaderboard player memory
pub/sub killfeed recall on join
world snapshot remember deaths

---

Valkey Integration

┌──────────────────┬─────────────────┬────────────────────────────────────┐
│ Key │ Type │ Purpose │
├──────────────────┼─────────────────┼────────────────────────────────────┤
│ game:leaderboard │ Sorted Set │ Top 10 scores, updated every 2 sec │
├──────────────────┼─────────────────┼────────────────────────────────────┤
│ game:names │ Hash │ Maps player IDs to names │
├──────────────────┼─────────────────┼────────────────────────────────────┤
│ game:world │ String (TTL 5s) │ Live world snapshot │
├──────────────────┼─────────────────┼────────────────────────────────────┤
│ game:events │ Pub/Sub │ Kill feed broadcast to all players │
└──────────────────┴─────────────────┴────────────────────────────────────┘

Valkey is not hit every tick — updates are batched every 2 seconds to keep latency low on the remote Aiven cloud instance.

---

Breeth AI Integration

• On join → searches player history (POST /v1/search) → shows a personalised greeting banner: "Run Submission: Sigrun AI Support Assistant - Gen Alfha #4 for Prabhas! Your best was length 67.
  Last time you were eaten by Alice."
• On death → stores the run as a memory episode (POST /v1/episodes): "Player Prabhas reached length 45 and was killed by Bob."
• Full in-memory fallback if no API key — game always works

---

Key Features

1. Real-time multiplayer — WebSocket broadcasts to all players every 40ms
2. Valkey leaderboard + killfeed — live top-10, death events via pub/sub
3. Breeth AI memory — personalized cross-session player history
4. WASD + arrow keys + mouse — full keyboard steering with diagonals
5. Boost mechanic — burns length, drops pellets, creates strategy
6. Room password — private rooms, shared via a single URL
7. One-URL hosting — Express serves the built client, tunnel with localtunnel/ngrok
8. Mini-map — always-visible world overview
9. 30/30 flight-test suite — automated end-to-end verification

---

Tech Stack

┌─────────────┬─────────────────────────────────────────────────┐
│ │ │
├─────────────┼─────────────────────────────────────────────────┤
│ Frontend │ React 18, Vite, HTML5 Canvas (no game engine) │
├─────────────┼─────────────────────────────────────────────────┤
│ Backend │ Node.js, Express, ws WebSocket │
├─────────────┼─────────────────────────────────────────────────┤
│ State Store │ Valkey (Aiven cloud) via ioredis │
├─────────────┼─────────────────────────────────────────────────┤
│ AI Memory │ Breeth AI REST API │
├─────────────┼─────────────────────────────────────────────────┤
│ Hosting │ localtunnel / ngrok over Express static serving │
└─────────────┴─────────────────────────────────────────────────┘

---

Run It

Build client once

cd client && npm install && npm run build

Start server (serves game + API on :3001)

cd server && npm install && npm run dev

Share with the world

npx localtunnel --port 3001

Set ROOM_PASSWORD=yourpassword in server/.env to lock the room. Players see a password field automatically.

[prabii]

done

[prabii]

ok