cyber-breach-jev
Three.js cyberpunk arena shooter where Jev drives enemy tactics, an encounter director and an autopilot bot via Choice, Score and Noul.
Overview
Cyber-Breach: The Jev Protocol is an infinite 3D Tron-style arena shooter built with Three.js and a Python backend. It uses Jev in three separate systems. The tactical enemy brain asks a combat_action Choice (flank left or right, charge, take cover, suppressive fire), a threat_assessment Score and Nouls for whether the player is vulnerable and whether to go berserk.
An adaptive encounter director watches player health, survival time and tempo and asks Jev which event to spawn, how tense pacing should be, and whether to drop emergency aid. A Doom-bot style autopilot, toggled with P, has Jev steer, target, fire and blink at five to ten decisions per second. A built-in local calibrated decision engine lets the game run with no API key, and a runtime config panel accepts a TypeSafe key. The repo includes an automated test suite for schemas and endpoints.
What the decision model decides
| Type | Question | Answers |
|---|---|---|
| Choice | combat_action: which manoeuvre should this enemy use? | flank_left · flank_right · direct_charge · take_cover · suppressive_fire |
| Score | threat_assessment: how threatening is the player? | minimal_threat · fatal_threat |
| Choice | director_event: which encounter event should happen next? | tactical_supply_drop · swarming_ambush · laser_hazard_grid · glitch_overdrive |
| Yes / no | grant_emergency_aid: should the director airlift aid now? | yes · no |
How it works
- Game backend summarises combat or pacing state
- Jev (or the local engine) answers the typed questions
- Enemies, director or autopilot apply the chosen action
- HUD shows live decision telemetry
Strengths
- Runs without an API key using a local engine
- Shows all three Jev primitives in one game
- Automated tests for schemas and endpoints
Caveats
- Hobby game; marketing-style README claims
- Hosted Jev needed for real model decisions
Getting started
./run.sh (or python3 -m backend.app), then optionally enter a TypeSafe key in the JEV CONFIG panel.At a glance
- Type
- Project
- Status
- prototype
- Language
- Python
- Runtime
- browser (Three.js) + Python backend
- Has code
- yes
- Has tests
- yes
Use cases and integrations
How curated lists describe it
Cyber-Breach: The Jev Protocol - A tactical cyberpunk arena combat game powered by TypeSafe AI Jev System One decision model.
hellogumbo/awesome-jev
Frequently asked questions
What does Jev control?
Enemy tactics, the encounter director's pacing, and an optional autopilot for the player's ship.
Do I need a TypeSafe key?
No, a built-in local decision engine works out of the box; a key enables real Jev.
How fast are decisions?
The autopilot is described as running at 5 to 10 decisions per second.
Related projects
Source for browser chess and Chess960 where code computes each legal move's facts and Jev picks one per turn as a typed Choice.
ProjectproductionTypeScriptBrowser 1v1 sniper arena where Jev reads match state about 9 times a second and chooses movement, aim, ADS, firing and jumping.
ServicebetaTypeScriptInstrumented 2048 web lab where every move is a Jev Choice over four directions, with probabilities, latency and cost shown live.
ProjectbetaTypeScriptFifteen live arcade games where Jev and LLMs play each other, led by WikiRace in which Jev picks only real links.
ProjectbetaTypeScriptReal-time bot battles where you write a fighter's strategy in plain English and a System One model pilots it several times a second.
ProjectbetaTypeScriptBrowser extension that lets Jev, local Laya or an OpenAI-compatible model take over a running ra2web (WannaFire) RTS match.
ProjectbetaTypeScript