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 uses your knowledge graph to answer questions:

• “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?”

How it works

Under the hood, the chatbot:

1. Rewrites your query to resolve pronouns and context from the conversation
2. Selects tools — queries your Neo4j knowledge graph using specialised templates
3. Reads results — processes the data returned from your graph
4. Generates a response — synthesises an answer using only the retrieved data

This loop can repeat up to 5 times if the chatbot needs to gather more information to answer your question fully.

Note

The chatbot is explicitly instructed to never invent information. If it can’t find the answer in your data, it will tell you so rather than guessing.

Data privacy

What’s sent to the AI provider:

• Your world’s name and description (up to 500 characters) — used as context so the model understands the setting
• Your current message and up to 10 recent messages from the session (older messages are replaced by a local summary)
• Tool definitions — descriptions of the query templates the model can use (these are static text, not your data)
• Neo4j query results — the specific entities, relationships, and content retrieved in response to the model’s tool calls

What’s NOT sent: Your user identity, session IDs, world ID, content beyond what the tool queries return, or any data from other worlds. The knowledge graph queries execute locally on your server — only their results are included in the AI prompt.

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

Memory

Each chat session maintains context:

• Recent messages are included in full
• Older messages are summarised automatically to keep the context window manageable
• Each session can focus on specific entities, which helps the chatbot give more relevant answers

Sessions

Chat sessions are saved automatically. You can:

• Create new sessions for different topics
• Switch between sessions in the sidebar
• Delete sessions you no longer need