Chat with Your World

MythTapestry includes an optional chatbot that can answer questions about your world using your actual entities, relationships, and content. It never invents information — every answer is grounded in your data.

This feature is off by default and must be enabled in World Settings (enable_chat).

How to use chat

There are two ways to access chat:

Full chat page

Navigate to Chat in the world sidebar to open the full chat interface with:

• A sidebar listing your chat sessions
• Markdown rendering in responses
• Copy button on messages
• Session history with auto-generated titles

Floating widget

If enabled in World Settings, a floating chat button appears in the bottom-right corner of every page (except the Chat page itself). Click it to open a quick chat overlay without leaving your current page.

What you can ask

The chatbot reads from the entities, relationships, and scenes you’ve built. Useful questions look like:

• “Who are the members of the Iron Council?”
• “What relationships does Aldric have?”
• “Tell me about the magic system in this world”
• “What happened at the Battle of Thornfield?”
• “What locations are in the Northern Wastes?”

Questions about your world that aren’t recorded anywhere in your world won’t get answered — the chatbot will say so rather than invent. If it should know but doesn’t, it’s a sign the entity or scene needs to be added.

How it works

When you ask a question, the chatbot:

1. Rewrites your question so things like “she”, “they”, or “the same one” point to the right entity, using earlier turns of the conversation
2. Looks things up in your world — entities, relationships, content — using a small set of pre-defined lookups
3. Reads what came back and decides whether it has enough to answer
4. Writes the answer using only what it found in your world

If the first lookup doesn’t have everything it needs, it can do up to four more rounds before giving up.

Note

The chatbot is explicitly told never to invent details. If your world doesn’t contain the answer, it will tell you so rather than guessing. That’s the whole point — it’s a reporter of what’s in your world, not a co-author.

Data privacy

What’s sent to the AI provider:

• Your world’s name and short description (the first 500 characters), so the model has rough setting context
• Your current message and up to 10 recent messages in this session (older ones are condensed into a local summary that travels along instead)
• Descriptions of the lookups the model is allowed to use — generic text, not your world data
• The results of whichever lookups it ran — the specific entities, relationships, or scenes it pulled

What’s NOT sent: your user identity, session IDs, world ID, anything from your world that the lookups didn’t return, or anything from your other worlds. The lookups themselves run on the MythTapestry server — only their results travel to the AI.

Where it goes: to the AI model provider via OpenRouter, as configured in your model preferences.

Memory inside a session

Each chat session has its own memory:

• Your most recent messages are passed through in full
• Older ones get folded into a short running summary so long sessions stay coherent without ballooning costs
• The session also tracks which entities you’ve been talking about, so follow-ups about “she” or “that battle” land on the right thing

If you want a fresh memory, start a new session.

Sessions

Sessions are saved automatically — there’s no save button. You can:

• Start a new session for a new topic (recommended over jumping topics inside one session)
• Switch between sessions in the sidebar
• Delete sessions you no longer need

Each session gets an auto-generated title based on its first message, so the sidebar stays scannable.