TomeWeaver: A Game Engine That Turns AI Conversations into Structured Narratives

TomeWeaver is an open-source game engine for stateful narrative orchestration, designed to solve the context drift problem in AI-generated content. Through structured design, it allows players' adventures to be exported as novel-level storybooks. It bridges the gap between the free creation of generative AI and structured game design, supporting both sandbox and campaign modes, and providing multi-platform compatibility as well as an ecosystem for content creation and sharing.

Existing AI narrative tools are often called 'chaos simulators'—they excel at improvisation but struggle to maintain long-term consistency. Character personalities change abruptly, world settings are rewritten arbitrarily, and plots lack logical chains, especially in open-world sandbox games. TomeWeaver believes this needs to be addressed at the system architecture level, not just relying on prompt engineering.

TomeWeaver uses a stateful design, maintaining a complete state database (including player inventory, chapter progress, etc.), stored and managed as structured JSON instead of prompt text. Its advantages include: precise retrieval and updates not limited by context windows; enforced game rules; and exportable as formatted documents to become novels.

1. Narrative Bridge: Solves the 'jump cut' problem by generating transitional text woven into the story flow, stored as metadata without modifying the original content; 2. Dual Modes: Sandbox mode (open exploration with manual control via chapter guides) and Campaign mode (a 'chapter cassette' system that follows the plot outline).

To address JSON format issues with local models, a multi-stage purification system was developed: a state machine repairer uses look-ahead parsing to distinguish structural markers from dialogue quotes, performing surgical fixes on errors; automatically balances interruptions caused by token limits. Supports models compatible with the OpenAI API specification (LM Studio local deployment, OpenAI and other cloud providers).

1. Cassette-style Ecosystem: Each adventure is an independent folder (containing setup.json, system_prompt.txt, etc.), making it easy to create and share; 2. Director Commands: undo/redo to roll back and regenerate, fix to modify details, expand for co-creation—players have control over the narrative.

Developed based on Python 3.10+, it provides automated installation scripts (double-click setup.bat for Windows, command installation for Linux/macOS), and configures AI providers via engine_config.json. Application scenarios: game developers' prototype verification, writers' branching narrative experiments, educational immersive teaching, players' customized AI role-playing.

TomeWeaver represents the development direction of AI narrative tools: making AI a reliable and controllable creative partner. Its innovations such as stateful management and JSON repair provide references for the consistency of long-form narratives. The project uses the Polyform Noncommercial License—free for personal use, commercial use requires authorization—and is worth in-depth study by AI narrative enthusiasts.