JEV: The Fish Game
Authoritative multiplayer fish arena: each AI fish batches Choice and Noul questions every few seconds while humans hunt with the mouse.
Overview
JEV: The Fish Game is an authoritative Node server with a Three.js client. AI fish batch three questions per decision: action Choice, target Choice, and panic Noul. Humans steer with the mouse; spectators read per-fish Q&A panels with confidence bars.
Problem: Multiplayer fish games often fake AI with scripts or parse LLM chatter that drifts under load.
Built for: Engineers who want a reference multiplayer loop with batched Choice and Noul calls and a live Q&A inspector.
First indexed on Jev Directory: 2026-09-21
Creator and team
- Name
- muratcanberber
- Handle
- @muratcanberber
How Jev is used
- Role in the product flow
- Per-fish tactical routing every few seconds
- Primitives
- ChoiceNoul
- State in
- Nearby threats, prey, food pellets, spikes, energy, and mass telemetry summarized for each fish (see README question table).
- Decision out
- action choice (flee, hunt, eat_food, roam), target object id, panic noul for sprinting.
- 30 Hz simulation on server
- Each AI fish schedules Jev calls every ~4-8 s, up to three concurrent
- Server applies thresholds, walls, spikes, and metabolism in code
- 10 Hz WebSocket broadcast with client interpolation to 60 fps
The README argues for AI as a programming primitive: JSON decisions, not chat. Policy stays in TypeScript so the same model weights behave per host configuration. A local fallback brain keeps fish moving if Jev is unreachable, but the showcase value is the inspector that exposes questions and probabilities to spectators. npm start serves localhost:8787; cloudflared tunnel instructions included for quick shares.
Sourced performance claims
- About 300 ms per fish decision; five AI fish ≈ 70 decisions/min (~$0.10/hour cited).Source: github.com/muratcanberber/JEV-TheFishGame README
Features and stack
Features
- Up to five players plus unlimited spectators
- Live Q&A inspector per fish
- Metabolism, spikes, and mass-scaled speed
- Server-side API key only
- Auto-reload clients on deploy
Stack
- Node.js
- Three.js r160
- WebSockets
- TypeSafe Jev
Pricing: README cites ~$0.10/hour for five AI fish at listed Jev rates; verify on console.typesafe.ai.
Links
FAQ
- Do browsers call Jev directly?
- No. README states the API key lives only in server .env.
- What if Jev is down?
- A documented local fallback brain keeps fish playable without remote calls.
Related learn guides
Original Jev guidance that pairs with this product pattern.
- Jev use cases
The patterns builders actually search for: moderation, routing, triage, RAG verify, and agent gates.
Related products
Hand-picked neighbors with rich profiles or overlapping tags.