AI Text Adventure — Interactive Story Engine with Pixel Sound

What is AI Text Adventure?

AI Text Adventure is a universal interactive story engine using your selected AI provider. Unlike scripted text adventures with pre-written branches, every scene, every choice, and every consequence is generated in real time based on your concept and decisions. You describe a story idea —anything from "My life in 100 days" to "A detective in 1920s Shanghai" —and the AI builds the entire world around it.

The game is choice-driven: the model is asked to offer 3 options (A, B, C) after each passage. Pick one to continue. The current request keeps the system prompt and up to 40 recent conversation messages, so older events may leave the context and details can be forgotten or contradicted.

Pixel-style sound effects

When the AI streams dialogue, you hear classic beep-beep-beep pixel sounds —like the dialogue boxes in retro RPGs. Each beep is a random frequency (600–1000 Hz) square wave, played at 80ms intervals through the Web Audio API. When the three choices appear, a chime plays. When you select an option, two ascending notes confirm your pick.

All sound is generated locally in your browser using the Web Audio API —no audio files to download, no external services. Toggle sound on/off anytime with the speaker icon in the game header.

API connection checks before starting

One of the most frustrating experiences with AI tools is entering a wrong API key, playing for a while, and then getting a cryptic Error: API error 401: Authentication Fails at the worst possible moment. AI Text Adventure validates your key upfront before you even start playing.

Here's how it works:

1. You select a supported provider and enter its endpoint, model and API key; key formats vary by provider.
2. The tool sends a small connection-check request to that provider. This is an AI request and may incur usage charges.
3. If the key is valid, you proceed to the game setup screen
4. If the connection check fails, a modal shows the adapter's error description and provider-setting guidance. Review the key, endpoint, model, balance and browser access; not every failure means the key is invalid.

AI Tarot and AI Ex-Partner Chat also use an initial provider check. A successful check confirms that request only; later requests can still fail because of network, quota or provider changes.

How to play

Step 1: Enter your API key

AI requests send relevant text to your chosen provider. Browser direct sends it from your device; optional server relay passes the key, text and response through ToolKnit and its CDN without application storage or content logging. Provider retention policies and ordinary website analytics remain separate.

Step 2: Describe your adventure

Type a short concept for your story. The more specific, the better. Some examples:

• "My life in 100 days" —the AI creates a life simulation where each turn is a day
• "A detective solving a murder in 1920s Shanghai" —noir investigation with period-specific atmosphere
• "Surviving on a deserted island" —resource management and survival decisions
• "Running a ramen shop in Tokyo" —business sim with cultural flavor
• "An astronaut lost in space" —sci-fi survival with existential choices

Or click one of the randomly suggested concept chips for inspiration.

Step 3: Choose your adventure length

Pick from three options: Fast (20 turns), Medium (50 turns), or Slow (100 turns). The AI will steer the story toward a natural ending within your chosen length, with a hard cap of +8 extra turns to prevent indefinite play.

Step 4: Choose your path

The AI generates the opening scene and presents 3 choices. Pick one (click or press A/B/C on keyboard). The AI continues the story based on your decision, generating a new scene with 3 new choices. This continues until the story reaches a natural conclusion (marked with "The End"), or until you hit the turn limit.

Dynamic RPG systems

AI Text Adventure now features a full RPG layer that makes every playthrough richer and more unpredictable:

• Gold system —earn gold through exploration, combat, and events. The AI awards or deducts gold using [GOLD+X] / [GOLD-X] markers. A coin-clink sound plays on every change.
• AI-generated random events —no fixed event lists. The AI creates context-aware unexpected events (discoveries, dangers, encounters, twists) that fit naturally into the current story. Events can also unlock new shop items.
• Progressive shop —8 items are available across the adventure. Soul Compass is unlocked initially; later milestones unlock Health Potion (turn 4), Lucky Charm (7), Spirit Lantern (10), Skeleton Key (15), Ancient Map (20), Ward Shield (30) and Phoenix Feather (40). AI event markers can unlock items earlier. Locked slots display ??? 🔒.
• Inventory —purchased items appear in your backpack. The AI incorporates owned items into the narrative as real objects you can use.

The AI storyteller's rules

The system prompt asks the storyteller to follow these rules. They are generation instructions, not guarantees that every model response will comply:

• 3 choices per turn —always labeled A, B, C. No more, no less.
• 80–150 words per narrative passage —vivid, sensory, with tension and stakes.
• Second person, present tense —"You step into the dimly lit alley..."
• Tracks implicit state —health, inventory, relationships, time are referenced naturally.
• Introduces twists, NPCs and obstacles —the prompt encourages varied scenes, but story quality depends on the model and your inputs.
• Natural endings —death, victory, or resolution trigger a concluding passage with "[THE END]".
• Markdown formatting —bold for key items/NPCs, italic for internal thoughts.

Privacy & security

Like all ToolKnit AI tools, your privacy is the top priority:

• API key in memory only —never written to localStorage, IndexedDB, or any persistent storage. Close the tab and it's gone.
• Key validated before use —invalid keys are rejected immediately with a helpful error modal.
• AI requests send relevant text to your chosen provider. Browser direct sends it from your device; optional server relay passes the key, text and response through ToolKnit and its CDN without application storage or content logging. Provider retention policies and ordinary website analytics remain separate.
• Browser interface —no application installation or ToolKnit account is needed. AI generation requires internet access and your provider's account or API access.

Keyboard shortcuts

For a faster, more immersive experience:

• A, B, C —select the corresponding choice without clicking
• Speaker icon —toggle pixel sound effects on/off
• New Game button —abandon current adventure and start fresh

Technical details

AI Text Adventure uses:

• Your configured compatible AI provider with streaming output for narrative generation
• Web Audio API for all pixel sound effects (square wave oscillators, no audio files)
• Bounded conversation history: the system prompt plus up to 40 recent messages, rather than an unlimited memory of the whole adventure
• Temperature 0.9 for creative, unpredictable storytelling
• Requested output cap of 800 tokens per story request; actual output length and support depend on the provider and model
• Regex-based option extraction to parse A/B/C choices from the AI response

Frequently asked questions

Can I save my game?

There is no resumable saved game. Refreshing or closing the page clears the live session. The end card can export a text record of the conversation still retained in memory; long adventures may have older turns removed by the context limit. An exported text file cannot be imported to resume play.

What if the AI generates something inappropriate?

Generated content depends on the selected model and can still be inappropriate or inaccurate. Provider filters and the story prompt are not guarantees. Stop the session if the output is unsuitable.

How much does it cost to play?

The interface is free. AI usage may be billed by your chosen provider and model. Story history, output length, retries and connection checks contribute to usage. Check current pricing and balance; ToolKnit does not guarantee a free tier or a fixed cost per game.

Can I play the same concept twice?

Yes. You can restart with the same concept. Choices and model generation can produce different paths, but a wholly unique story on every run is not guaranteed.

How long can an adventure be?

Choose 20, 50 or 100 turns in game setup. The model is prompted to bring the story toward a conclusion near the selected limit. A longer session can use more API tokens; it does not guarantee a better or entirely distinct story.