river-oaks
Multiplayer 3D science-fantasy version of Houston's River Oaks District with Jev-powered NPC companion, chauffeur and smart drive.
Overview
River Oaks District is an inhabited 3D world based on Houston's River Oaks District: mapped streets from bundled OpenStreetMap geometry, 30 storefront destinations, 98 indoor staff and guest encounters, and residents in varied fashion. You play as Jevica, explore in third person, fly in a bubble, drive vehicles, take photos, and join a shared town with other signed-in players. It ships as a browser and desktop app and includes agent skills for level design.
Jev powers optional NPC services through a separate bridge: Jevica's companion and chauffeur, speech, and a 'Jev smart drive' mode for her vehicles through the API. The README does not list the exact questions; the likely pattern is per-tick choices for driving and for companion behaviour. Play requires WorkOS sign-in and waitlist approval, and the server owns residents, wishes and shared resources.
What the decision model decides
| Type | Question | Answers |
|---|---|---|
| Choice | What driving action should the chauffeur take next?(inferred) | — |
| Choice | How should the companion NPC respond or act?(inferred) | — |
How it works
- Run the shared town server and Vite client
- Start the optional Jev bridge for chauffeur, companion and speech
- Jev chooses NPC and smart-drive actions from game state
- The game applies them in the shared world
Strengths
- Showcases decision-model NPCs in a large world
- Multiplayer state owned by the server
Caveats
- Jev questions are not documented in the README excerpt
- Requires WorkOS sign-in and waitlist approval
- No licence stated
Getting started
pnpm install --frozen-lockfile && pnpm run dev, then run the Jev bridge in a separate terminal for NPC services.At a glance
- Type
- Project
- Status
- beta
- Language
- TypeScript
- Runtime
- Browser/desktop game with Node server
- Has code
- yes
Use cases and integrations
How curated lists describe it
NPCs of River Oaks Houston, Texas using Jev to power NPCs.
hellogumbo/awesome-jev
Frequently asked questions
What does Jev do in River Oaks?
It powers optional NPC services such as Jevica's companion, chauffeur and smart drive.
Can anyone play?
Play requires sign-in and waitlist approval.
Is Jev required to run the game?
No; the Jev bridge is optional.
Related projects
Real-time bot battles where you write a fighter's strategy in plain English and a System One model pilots it several times a second.
ProjectbetaTypeScriptBot that plays Red Alert 2 web skirmishes, with code handling mechanics and a decision model making stance, threat and timing calls.
ServicebetaPythonBrowser 3D planetary rover sandbox where a TypeSafe controller chooses the next action from complete candidates, versus a baseline.
ProjectbetaTypeScriptDoom runs as a spacecraft payload over real flight software; Jev pilots from the ground every half second while Claude reviews.
ProjectprototypePythonMinecraft agent where Hermes plans, Jev picks one bounded action at a time and a Mineflayer harness validates and executes.
ProjectprototypeJavaScriptTown simulation in which Jev chooses the next action for each of 100 NPCs while game rules handle everything else.
ProjectprototypeTypeScript