Node types & slots

Q: How do I set up characters?

Make a Graph node type such as **Characters** (or ask the agent to), and give each character a node of its own. Put short facts like role, age, and appearance in properties, and longer writing like background or how the character changes in sections. Join characters with node relations and the type's [graph](./world-graph) becomes a character map.

Node types & slots

Your World is built from node types and nodes. A node type is a category such as characters, places or factions, and a node is one entry inside it — one character, one place. A node type decides what its nodes record: its slots. Every node of a type has the same slots, and each node fills them in with its own values.

Node types and nodes

The World starts empty. Make node types to suit your work, or ask the agent to make them, and run Organize World on your manuscript or conversations to file characters, places, and lore as nodes of the right types. When you make a node type, you choose its Kind: a Graph type, which shows relations as a picture, or a Board type, which lays things out in order.

Slots — properties and sections

There are two kinds of slot.

Property: A field for a short fact, such as age or occupation. Its value type is one of Plain · Number · Select · Node relation; a number can be a range or an approximate value and can take a unit. Several properties can be gathered into a group.
Section: A free-form field for longer writing, such as background or history.

Add slots from a node's ⋯ under Slot with Property › or Section ›. A slot you add or delete applies to every node of that type. How to bring back a deleted slot is in History & Restore.

Relations

Relations between nodes — a faction, a family tie, a rival — are written in a Node relation property. Pick another node as its value and the two are joined; a Graph type draws the link as a line. Pick the other node's property under Reverse sync on a relation property, and a relation written on one side is recorded in that property on the other node too — put character B in character A's Father and A goes into B's Daughter. Restrict to type narrows which types the relation can point to. Deleting a value that has a pair removes the other side's value as well, and you're asked to confirm first.

Values that change over time

Facts that change during the story, such as a character's rank or a place's ruler, keep their history with a span instead of being overwritten. With the edit icon beside a value, pick its start and end from the cards of a Board type — events or scenes; an end left open reads From the start or Until now. Select values and node relations can take spans too.

Search keywords and links

Search keywords: Register nicknames or shortened names so a node is recognized even when the text calls it something else. Choose Search keyword in the node's ⋯ and press ＋. Search and the agent both use them.
Links and backlinks: Type [[ in section text to link another node. Backlinks gather the places where other nodes' text links to this one.

Sources

Lore added by Organize World keeps the manuscript passage or conversation behind it as its Source. Press the small chip beside a property or section — a chapter number for the manuscript, a page icon for a document, a chat icon for a conversation — to see where it came from, who added it, and when, and to jump straight there. A field that picked up a new source since you last viewed the node shows a dot before its name, so new arrivals are easy to spot.

How do I set up characters?

Make a Graph node type such as Characters (or ask the agent to), and give each character a node of its own. Put short facts like role, age, and appearance in properties, and longer writing like background or how the character changes in sections. Join characters with node relations and the type's graph becomes a character map.