Files
talemate/docs/user-guide/saving.md
veguAI 42a8863e65 0.36.0 (#255)
Major Features

- API key encryption at rest using Fernet (OS keyring with file fallback)
- Prompt Manager: unified UI with template groups, priority ordering, override tracking, response extractors
- Scene context history review panel with token budgets and best-fit mode
- Multiple concurrent director chats with auto-generated titles
- Granular scene state reset dialog
- Time passage insert/edit/delete in scene view
- Image analysis via OpenAI-compatible and Talemate Client backends
- Volatile context placement after scene history for improved prompt caching

Improvements

- Configurable narrator generation length per narration type
- AI Aware conversation mode
- Summarizer: custom instructions, writing style inclusion, short line filtering
- Anthropic: adaptive thinking support, updated model list (opus-4-5/4-6, haiku-4-5)
- Google: gemini-3.1 support
- World editor: generate from topic, quick create state reinforcement, reorganized menus
- Node editor: promote scene modules to global
- Frontend: version mismatch detection, hideable bracket content, required scene name
- TTS: improved pause handling, audio tag support for vocal markers (ElevenLabs v3)
- Writing style template for AI-generated instructions
- Added Kimi.jinja2 LLM prompt template
- Option to disable character names in stopping strings
- Client response length enforcement options
- Graduated token count sliders
- Increased summarizer token threshold max

Bugfixes

- Fix bracket/paren/brace terminators stripped from message ends
- Fix colon in conversation causing content loss
- Fix "Use as reference" navigating to blank page
- Fix avatar regeneration and manual regenerate
- Fix conversation agent ignoring generation length
- Fix duplicate length instructions with reasoning enabled
- Fix trailing newline on message edits
- Fix summarize dialogue sending too much context with layered history
- Fix layered history inspection and construction issues
- Fix empty response handling in summarization
- Fix context ID dot notation with dotted character names
- Fix recursive retry in focal agent
- Fix leading whitespace causing duplicate prepared responses
- Fix summarization not stripping ANALYSIS OF lines
- Fix template group selection/removal in prompt manager
- Fix multiline text in parentheses/brackets parser
- Fix determine_character_name resolution
- Fix character activate/deactivate desyncing creative menu
- Fix character image generation missing context
- Fix LMStudio client not sending token limits
- Fix Recent Scene images on newer Chromium
- Fix sequential reinforcement messages cut off at first linebreak
- Fix reinforcement removal not clearing state
- Fixes #252, #256, #258

Deprecations

- Removed context investigations (replaced by AI-assisted RAG mixin)
- Removed deprecated prompt templates (fix-continuity-errors, fix-exposition, etc.)
- Removed conversation/edit.jinja2, auto break repetition, CLI reset layered history
---------

Co-authored-by: theDTV2 <47825738+theDTV2@users.noreply.github.com>
2026-03-15 12:00:57 +02:00

2.9 KiB

Saving

How saves work

Scenes are saved as .json files inside the scene's project directory. All saves for a scene are grouped together in this directory, so a single scene project might contain several save files representing different states or branches.

When you save a scene, Talemate also records the changes in an automatic version history (changelog). This means you can restore a scene to any previous revision at any time.

Saves can also serve as restore points. By designating one save file as the restoration source in the scene settings, you can quickly reset a scene back to that state whenever needed — useful for testing or creating repeatable starting points.

Saving from the scene

To save while looking at the scene, click the :material-content-save: Save button on the right of the Scene tools toolbar.

Scene save

Saving from the world editor

While in the world editor it is also possible to save changes by clicking the :material-content-save: Save button in the top center of the screen.

World Editor Save

Auto save

To disable / enable auto save, click the the auto save shortcut above the scene tools toolbar.

Auto save disabled Auto save enabled

I can't toggle auto save

Auto save blocked

Some scenes start out with a locked save file. This is so that this particular scene file cannot be overwritten by accident. In order to enable autosave, you need to manually save the scene once. After that, the autosave toggle will be available.

!!! info Alternatively you can also unlock the save file through the Scene editor found in :material-earth-box: World Editor :material-arrow-right: :material-script: Scene :material-arrow-right: :material-cogs: Settings.

Save As

When you use Save As, a new save file is created in the same project directory. This is useful for creating checkpoints you can return to later — for example, saving an initial state before experimenting with different story directions.

These additional save files can be set as restore points so you can always return to a known good state.

Forking a copy of a scene

You can create a new copy of a scene from any message in the scene by clicking the :material-source-fork: Fork button underneath the message.

All progress after the target message will be removed and a new scene will be created with the previous messages.