Loading articleโฆ
Loading 4weirdโฆ
Loading 4weirdโฆ
Loading articleโฆ
DocsGame AI & Buddy
Docs ยท your co-pilot
Dialogue bots, AI directors, voice acting - plus a universal 9-voice Gaming Buddy that reads the screen and coaches you live. All metered with the 25% cut included.
Know what you're playing with
Detail and play pages wear badges disclosing mode + provider + '25% cut included'. Learn to read them:
Required AI
The core loop needs it - e.g. an attack director driving enemies. Playing the game is using AI, metered per turn, decision, or GPU minute.
Optional AI
Toggleable dialogue bots, directors, TTS. Off means zero AI metering for that feature. Mix freely with the Buddy.
The voice cast
Nova ships as the default; all nine ride the same meters (chat tokens + voice characters + optional screen snapshot + database writes, 25% inside).
Alloy
Ash
Coral
Echo
Fable
Onyx
Nova
DEFAULT
Sage
Shimmer
How a session sounds
gaming buddy - live session
9.2ยข this sessionBuddy ยท Nova 1.2x
Nice dodge! Two pickups spawn left in ~5s - grab the shield first ๐ก๏ธ
coach my aim for this boss?
Under the hood
Every chat turn reuses the VibeCodeWorker loop shape. The widget observes the screen, the server reasons with a real model (or a clearly-labelled free fallback), acts by speaking, and meters the true cost - tokens + image + database - with the 25% cut inside.
POST /api/buddy/chat - one turn
true-cost metered# observe: what the widget forwards
{ "game_slug": "gravegain2d", "screen_text": "โฆโค2000 chars",
"score": 1200, "voice": "nova", "session_id": "โฆ",
"message": "coach my aim?", "history": [โฆ], "brain": "auto" }
# reason โ act โ meter: reply + per-turn cost breakdown
โ reply + cost { chat, image, db }
brain: "auto" (default) prefers the OpenAI Responses API when its key is set, falls back to OpenRouter chat-completions, and returns a clearly-labelled local reply at zero cost with neither. You can pin "openai" or "openrouter" explicitly - or send "stream": true for live token deltas over SSE instead of one JSON blob.Shortcuts
Don't type an essay mid-boss-fight. The widget expands shortcuts into full model-ready prompts, and a keyword router steers the persona before the model even sees the turn.
/tactics โฆ
One concise tactical recommendation for the current battle state, focused on whatever follows the slash. The action catalog's coaching button fires this for you.
/hail โฆ
A short fictional enemy-commander radio taunt, then one fair counter-tactic. Roleplay first, coaching always.
/react โฆ
React to the moment in 1-2 short sentences - the default lens when you just want company, not counsel.
/vibe โฆ
Match energy from the opt-in camera frame: warm, kind, never diagnosing, never identifying.
Continuity
Sessions are the wallet's unit of grouping: start one when you sit down, end it when you stand up, and the widget plus /my/usage/ show live session spend. Memory - the Buddy remembering you across sessions - is a separate, explicit yes.
POST /api/buddy/session { action: "start" } (game slug + voice), close with { action: "end" }. Reloaded mid-game? GET /api/buddy/session?open=1 lists your open sessions newest-first so the widget resumes instead of orphaning a meter.GET/POST /api/buddy/memory. POST without consent: true stores nothing, full stop. What's stored is an extractive rolling buffer of plain "Player: โฆ / Buddy: โฆ" lines - zero model calls, zero AI spend - merged and trimmed oldest-first, then carried into future prompts as one short capped block.POST /api/buddy/presence, each with a sane per-call cap so a buggy loop can't drain a wallet in one call. Off by default; the coach works fine without either.Volume knob
Voice output is metered separately from chat - and only when provider voice actually speaks. Everything else is free by construction.
POST /api/buddy/tts takes up to 2000 chars with tts-1 (default) or tts-1-hd, any of the 9 voices, and speed clamped to 0.5-2x in 0.25 steps. HD costs more per character - the per-turn breakdown says exactly how much.POST /api/game-ai/meter by kind (dialogue, director, tts, runpod-gpu, inference, buddy-*) with the same 25% cut - toggle the feature off and that meter stops dead.Price tags
Buddy turns bill true upstream cost converted to gross Vibe Coins (provider dollars ร 100 รท 0.75, 25% inside, centicentcoin resolution, minimum a hair above zero per leg). Built-in game AI meters at fixed kind rates instead - same cut, simpler math:
๐ฌ Dialogue
3 / 1k tokens
NPC chat, quests, Buddy conversation
๐ฌ Director
2 / decision
Spawns, pacing, difficulty calls
๐ Game TTS
2 / 1k chars
In-game voice lines, announcers
๐๏ธ Buddy voice
per-char meter
tts-1 or tts-1-hd + DB leg, true cost
๐ผ๏ธ Avatar
0.08 / min
Optional 3D presence, off by default
๐ท Camera
0.03 / frame
Opt-in emotion/body-language frames
The lineup
Games declare AI features in a static registry the play shell reads without a database round-trip - so the 25% badge renders instantly. Everything listed today is optional: toggle it off, pay nothing for it.
๐ชฆ GraveGain 2D + 3D
Optional NPC dialogue bot plus an optional RunPod-backed game director pacing spawns and encounters.
๐ง Last Words: Zombies
Optional director tuning zombie horde waves to your typing speed, plus zombie voice-line taunts in any of the 9 voices.
๐พ Assassin Animals
Optional director adapting facility layouts and patrols to your stealth, via a hosted inference endpoint.
๐ฆ BattleSharks 2 + more
Optional mutation announcer and arena directors (RunPod GPU), each badged with mode + provider + cut on the detail page.