Mirrors/talemate
1
0
Fork 0
mirror of https://github.com/vegu-ai/talemate.git synced 2026-09-02 20:20:40 +02:00
Code Issues Packages Projects Releases Wiki Activity
Files
main
talemate/docs/user-guide/node-editor/reference/nodes/scene-world-state.md
veguAI cc28def7c6 0.39.0 (#274) 
- **Help Agent** — A new agent that answers questions about Talemate itself — settings, agents, clients, the world editor — grounded in the bundled documentation, and able to change agent and application settings on request.
- **Timeline Rollback** — Scrub a slider across a scene's automatic version history, preview the message history at any revision, then roll the scene back in place or fork the revision into a new save.
- **Pi Bridge Client** — A new client type that drives generations through the pi coding agent's headless RPC mode, making any model pi can reach usable in Talemate.
- **Application Settings** — Settings move out of their modal into an always-available Settings tab, with a single topic-grouped sidebar, a settings search, all API keys on one page, and unsaved-change tracking.
- **Scene Library** — The home screen is rebuilt as a full-page landing view with a file-tree scene library, cover thumbnails and per-save metadata, scene and save deletion, and a drag-and-drop import dropzone.
- **Fast Character Creation** — Generate a character in a single request instead of one prompt per aspect, with a Consolidate multi-select, a token budget, and a Fill in misses pass. Off by default.
- **Scene Backdrop** — Set any scene illustration as a backdrop filling the scene view behind the messages, saved with the scene, with configurable text legibility and an Immersive quick-toggle.
- **Scene Visual Manager** — World Editor → Scene gains a Visuals tab to browse, upload, generate and delete the scene's backgrounds and illustrations, and set the cover image and backdrop.
- **Visual Prompt Finalization** — Post-processing actions — match and replace, or a free-form AI instruction — rewrite image prompts right before they reach the image backend, with per-scene and per-character overrides and reusable template sets.

- fixes #271 
- fixes #275

Plus 25 improvements and 39 bug fixes — see [CHANGELOG.md](https://github.com/vegu-ai/talemate/blob/prep-0.39.0/CHANGELOG.md#0390) for the full list.
2026-08-29 13:21:22 +03:00

5.9 KiB
Raw Permalink Blame History

World Entry Nodes

Read and write the scene's world entries (the world information shown in the world state panel) and build generation options — writing styles and spices — that steer content generation.

8 nodes.

Node Registry path
Get World Entries scene/worldstate/GetWorldEntries
Get World Entry scene/worldstate/GetWorldEntry
Remove World Entry scene/worldstate/RemoveWorldEntry
Save World Entry scene/worldstate/SaveWorldEntry
Generation Options scene/worldstate/templates/GenerationOptions
Spices scene/worldstate/templates/Spices
Writing Style scene/worldstate/templates/WritingStyle
Unpack World Entry scene/worldstate/UnpackWorldEntry

Get World Entries

scene/worldstate/GetWorldEntries

Gets world entries, optionally filtered by a list of ids

Ids are matched case-insensitively. If no ids are given, all world entries are returned. If raise_on_missing is enabled, an error is raised when any requested id is not found.

Inputs

Input Type Description
ids list (optional) The ids of the world entries to get

Outputs

Output Type Description
world_entries dict Dictionary of world entries keyed by entry id

Properties

Property Type Default Description
ids list unset The ids of the world entries
raise_on_missing bool False Whether to raise an error if a world entry is missing

Get World Entry

scene/worldstate/GetWorldEntry

Gets a world entry by its id

Inputs

Input Type Description
entry_id str The id of the world entry

Outputs

Output Type Description
world_entry world_entry The world entry object
entry_id str The id of the world entry, passed through
text str The text of the world entry
shared bool Whether the entry is shared

Properties

Property Type Default Description
entry_id str unset The id of the world entry

Remove World Entry

scene/worldstate/RemoveWorldEntry

Removes a world entry

Inputs

Input Type Description
state any
entry_id str

Outputs

Output Type Description
state any
entry_id str

Save World Entry

scene/worldstate/SaveWorldEntry

Saves the world entry

Inputs

Input Type Description
entry_id str (optional) The id of the world entry
text str (optional) The text of the world entry
meta dict (optional) The meta of the world entry

Outputs

Output Type Description
entry_id str The id of the world entry
text str The text of the world entry
meta dict The meta of the world entry

Properties

Property Type Default Description
entry_id str unset The id of the world entry
text text unset The text of the world entry
meta dict {} The meta of the world entry
create_pin bool False Whether to create a pin for the entry

Generation Options

scene/worldstate/templates/GenerationOptions

Node that returns a GenerationOptions object

Inputs

Input Type Description
spices spices (optional) The spices to apply to the generation options (input-only)
spice_level number (optional) The spice level to apply to the generation options
writing_style writing_style (optional) The writing style to apply to the generation options

Outputs

Output Type Description
generation_options generation_options The generation options

Properties

Property Type Default Description
spice_level number 0.0 The spice level to apply to the generation options. Range: 0.0 – 1.0.
writing_style writing_style "" The writing style to apply to the generation options

Spices

scene/worldstate/templates/Spices

Node that returns a Spices object

Inputs

Input Type Description
spice_values list (optional) list of strings

Outputs

Output Type Description
spices spices The Spices object built from the spice values

Properties

Property Type Default Description
spice_values list [] The list of spices

Writing Style

scene/worldstate/templates/WritingStyle

Node that returns a WritingStyle object

Inputs

Input Type Description
instructions str (optional) Writing style instructions

Outputs

Output Type Description
writing_style writing_style The writing style to apply to the generation options

Properties

Property Type Default Description
instructions text "" Writing style instructions

Unpack World Entry

scene/worldstate/UnpackWorldEntry

Unpacks a world entry into its individual fields

Inputs

Input Type Description
world_entry world_entry The world entry object

Outputs

Output Type Description
entry_id str The id of the world entry
text str The text of the world entry
meta dict The meta of the world entry
Reference in New Issue View Git Blame Copy Permalink