Skip to main content
🌍

Worlds Tutorial

Build rich, structured knowledge bases for anything β€” fictional universes, murder mysteries, family trees, fan rooms, and more. This guide takes you from first steps to power-user graphs.

← Go to My Worlds
🌍

What is a World?

A World is a structured, AI-queryable knowledge base you build inside your Home Room workspace. Think of it as a living wiki β€” except instead of plain text pages, every entry is a typed entity (a character, a place, an event, an object) connected to other entities through relations.

You own your World. You choose what goes in, who can see it, and how detailed to make it. Worlds can be as small as a handful of characters for a murder mystery, or as large as a full canonical lore bible for a multi-book fantasy series.

πŸ—‚οΈ

Organised

Everything categorised by type β€” characters, places, events, objects.

πŸ”—

Connected

Entities link to each other β€” a character can be at a place during an event.

πŸ€–

AI-Queryable

Sage can answer questions directly from your World's structured data.

πŸ’‘Worlds live inside a Study Room. Every Study Room can have one or more Worlds. Navigate there via My Workspace β†’ Worlds in your Home Room.
✨

Creating Your First World

Creating a World takes under a minute. Here's the process:

1

Go to My Workspace β†’ Worlds

From your Home Room, click Workspace in the top navigation, then choose Worlds from the sidebar.
2

Click 'New World'

Hit the + New World button in the top right corner of the Worlds page.
3

Name your World

Give it a clear name β€” e.g. "Midsummer Night Murders", "The Keating Family Tree", or "Realm of Aelindra β€” Lore Bible". You can edit this later.
4

Set visibility (Public or Private)

Private Worlds are only visible to you and Study Room moderators. Public Worlds can be browsed by any room member. You can change this at any time.
5

Start adding entities

Your World is empty β€” now it's time to fill it with characters, places, events, and more. Start with the most important entities first.
ℹ️A World's slug (the URL identifier) is generated automatically from the name. Once created, the slug doesn't change, so choose a meaningful name.
🧩

Entity Types β€” The Building Blocks

Every piece of knowledge in a World is stored as an entity. An entity has a name, a description, an optional image, a type, and a confidence level. There are five entity types, each serving a different role in your World.

πŸ‘€
CHARACTER

People & Characters

Any person, real or fictional, living or historical. The backbone of most Worlds.

ProtagonistSuspectAncestorAuthorVillain
πŸ“
PLACE

Locations & Settings

Physical or conceptual spaces β€” rooms, cities, planets, or even a website.

The ManorLondon 1892Planet ZorynCafΓ© du Nord
πŸ“…
TIMELINE

Events & Moments

Things that happened β€” with optional precise timestamps for gap-reasoning.

The MurderWedding DayChapter 1 OpeningFirst Contact
πŸ“¦
OBJECT

Items & Artefacts

Physical items, documents, photos, weapons, or anything with significance.

The Missing LetterFamily Photo 1962Murder WeaponRing of Power
πŸ“‹
CONTEXT

Background & Lore

Explanatory notes, rules, history, or any information that doesn't fit a person or place.

Magic System RulesBackstoryHousehold BudgetCompany Culture
πŸ‘€

Characters

Characters are the most commonly used entity type. A Character represents any person β€” real, fictional, living, historical, or hypothetical.

Each Character has a name, a description (you decide how detailed to go), an optional profile image, and a confidence level (how certain you are this person exists or played the role you've assigned them).

What to put in the description

For a murder mystery: their alibi, motive, known relationships. For a family tree: birth year, key life events, spouse, children. For a fan room: their canonical role in the story, traits, arcs. There's no required format β€” write what you'd want to know when you query Sage later.

Connecting Characters to other entities

Characters become powerful when you add Relations β€” linking them to Places ("was at"), Timeline events ("participated in"), Objects ("owns"), or other Characters ("is sibling of", "suspects", "mentored by"). See the Relations section for details.

πŸ’‘Family albums tip: Use Characters for every family member, even those you know little about. Set a low confidence and add what you know in the description β€” even "possibly born circa 1890" is useful for Sage.
πŸ“

Places

A Place entity represents any location β€” a room in a house, a city, a country, a fictional world, or even a digital space like a website. Places answer the question: where did this happen?

Places are especially useful in murder mysteries (crime scenes, alibi locations, escape routes), historical research (battlefields, family homes, migration destinations), and fiction (kingdoms, taverns, portals).

Images for Places

Add a cover image to a Place using your Media Library β€” a map, floor plan, reference photo, or AI-generated image. This image appears as a thumbnail in the entity list and as the header image on the Place's detail page.

ℹ️You can nest Places conceptually using Relations. For example: The Study β†’ "is inside" β†’ Ashford Manor β†’ "is located in" β†’ Devon, England.
πŸ“…

Timeline Events

Timeline entities represent things that happened β€” moments, scenes, events, milestones. They're the most powerful entity type because they support precise temporal fields:

FieldWhat it recordsExample
Exact timePrecise moment β€” date + time2026-06-15 at 20:32
Starts atBeginning of a rangeSuspect seen from 18:30
Ends atEnd of a rangeSuspect seen until 19:30
Approximate labelHuman-readable fuzzy date"circa summer 1962"
TimezoneIANA timezone for the eventEurope/Dublin

Why precise times matter

When you add exact times to Timeline entities, Sage can reason about gaps: "Did Colonel Fairfax have time to leave the cafΓ© at 19:30 and reach the library by 20:32?" Without timestamps, Sage can only tell you the sequence. With them, it can calculate whether an alibi holds.

πŸ’‘Use Approximate label for historical or fictional events where an exact date isn't known: "early Bronze Age", "before the war", "Chapter 3". This label is searchable and queryable by Sage.
πŸ“¦

Objects

Object entities represent physical items, documents, artefacts, or anything tangible that carries significance in your World. Objects answer: what was involved?

In a murder mystery, Objects might include the murder weapon, a cryptic letter, a missing jewel, or a set of footprints. In a family album, an Object might represent a photograph, a birth certificate, or a family heirloom.

Photos as Objects

A powerful convention: store each family photo as an Object entity with the image attached and a description of who appears in it, where it was taken, and approximately when. You can then create Character relations to link every person in the photo to that Object entity. Sage can then answer: "Show me every photo that includes Grandma Eileen."

ℹ️Use the Media Library to store and pick images for your Object entities. Navigate to Workspace β†’ Media to upload photos, or generate AI images for fictional objects.
πŸ“‹

Context

Context entities are the catch-all for background knowledge that doesn't fit a person, place, event, or item. Think of them as lore notes.

Use Context for: the rules of a fictional magic system, a character's backstory before the story begins, a company's org chart description, a historical summary of a period, or any explanatory information that gives other entities meaning.

When to use Context vs a longer description

If the information primarily describes a single entity, put it in that entity's description. If it's shared background knowledge that multiple entities relate to, make it its own Context entity and link things to it.

πŸ’‘Context entities are great for writing AI system prompts for your World β€” adding a Context entity titled "World Overview" with a summary of your World primes Sage to answer questions with the right framing.
🎯

Confidence Levels

Every entity has a confidence level β€” a 0–100 score representing how certain you are that the entity and its description are accurate. This is especially valuable in:

  • Murder mysteries: a suspect's alibi might be unverified (low confidence) vs confirmed (high confidence).
  • Genealogy: you might believe your great-great-grandmother was born in Cork but haven't confirmed it yet (medium confidence).
  • Fan rooms: fan theories about a character's motivations versus what's canonically stated.
ScoreLabelTypical use
0–25SpeculationA theory, an unverified claim, a fan reading
26–50PossiblePlausible but not yet confirmed
51–75ProbableStrong evidence supports it
76–100ConfirmedCanonical, verified, or directly stated
⚑On the Relations page, you can filter by minimum confidence β€” showing only confirmed facts vs all speculation. Sage also respects confidence when answering β€” it will flag low-confidence information rather than stating it as fact.
πŸ–ΌοΈ

Images & Visual Identity

Every entity can have a cover image. Images are picked from your Media Library and appear in:

  • The entity list as a 40Γ—40 thumbnail
  • The entity detail page as a larger header image
  • The Relations graph as node icons (coming soon)

To add an image, go to the entity's Edit page. Click Pick from Media Library to browse images you've already uploaded, or visit Generate Images to create AI-generated portraits, illustrations, or scene references.

πŸ’‘For Characters, use an AI-generated portrait that matches your mental image of them. For Places, a reference photo or illustrated map works well. For Objects, a product-style photo or illustration. Consistent imagery makes your World much easier to navigate.
πŸ’‘

Real-World Use Cases

Worlds are designed to be flexible. Here are five common use cases β€” each one uses the same underlying entity and relation system, just for different purposes.

πŸ”ͺ

Murder Mystery Room

Map suspects, victims, locations, alibis, and the timeline of events. Perfect for collaborative mystery games, escape room design, or crime fiction plotting.

Characters (suspects, victims, witnesses)Places (crime scenes, alibi locations)Timeline (sequence of events, time-of-death)Objects (murder weapon, evidence)Context (backstory, motives)

πŸ’‘ Use Timeline entities with precise timestamps so Sage can check whether alibis are physically possible given travel time between Places.

🌳

Family Album & Family Tree

Document your family history β€” relatives, photos, relationships, migration paths, and oral history. Share it with family members in a private Study Room.

Characters (every family member)Places (birthplaces, homes, emigration destinations)Objects (photos β€” one entity per photo!)Timeline (births, deaths, migrations)Context (oral history, family stories)

πŸ’‘ Store each photograph as an Object entity with the photo attached. Add Relations from each person in the photo to the Object entity β€” Sage can then surface every photo a specific person appears in.

πŸ“–

Author Fan World

Build a community lore bible for your favourite author's books. Catalogue characters, places, magical systems, and fan theories alongside canonical facts.

Characters (protagonists, antagonists, supporting cast)Places (kingdoms, cities, landmarks)Objects (artefacts, weapons, magical items)Timeline (in-universe history)Context (magic system, politics, fan theories)

πŸ’‘ Use Confidence levels to distinguish canonical facts from fan theories. High confidence = directly stated in text. Low confidence = fan reading or speculation.

🏰

Fictional Universe / Lore Bible

For authors building their own worlds β€” map your world's geography, history, factions, characters, and rules into a structured lore bible that Sage can query.

Characters (your cast)Places (your world's geography)Timeline (in-universe history and prophecy)Objects (artefacts, MacGuffins)Context (magic rules, political factions, cosmology)

πŸ’‘ A Worlds lore bible is more powerful than a notes doc because Sage can cross-reference. Ask: 'Which characters were present in Aelindra during the Third Age?' and get a direct answer.

🎭

Book Club / Study Room Companion

Build a World alongside your book club's reading β€” track characters as you meet them, map locations, record timeline events chapter by chapter.

Characters (the cast, with spoiler notes kept private)Places (locations visited in the book)Timeline (chapter-by-chapter plot events)Context (themes, symbolism, discussion notes)

πŸ’‘ Keep the World private until the club has finished the book, then make it public for future members joining the room.

πŸ”—

Relations β€” Connecting Entities

A Relation is a directed, labelled connection between two entities. Relations are what turn a list of facts into a knowledge graph.

A Relation has:

  • A From entity β€” the subject
  • A To entity β€” the object
  • A Relation label β€” the verb, e.g. "was at", "is sibling of", "owns", "killed"
  • A confidence level β€” how certain you are of this connection

Example relations

πŸ‘€ Colonel Fairfaxβ€”was atβ†’πŸ“ The Libraryat 20:15
πŸ‘€ Lady Hartwellβ€”ownsβ†’πŸ“¦ The Ivory Letter Opener
πŸ“… The Murderβ€”occurred atβ†’πŸ“ The Study
πŸ‘€ Margaret Keatingβ€”is mother ofβ†’πŸ‘€ Thomas Keating

Adding Relations

Navigate to your World, then click the Relations tab. Use the form at the top to create a new relation β€” pick a From entity, enter the relation label, and pick a To entity. You can also filter the relations list by entity type to focus on just Characters, just Places, etc.

πŸ’‘Keep relation labels consistent. Use the same phrasing across your World β€” if you use "is parent of", don't also use "is the parent of". Consistent labels make the graph much cleaner and improve Sage's ability to traverse it.
⚑

The Knowledge Graph (Power Users)

Once your World has entities connected by Relations, it becomes a knowledge graph β€” a network of nodes (entities) and edges (relations) that can be traversed and queried.

What a knowledge graph looks like

A simplified murder mystery graph

πŸ‘€Colonel Fairfax
was at β†—
↙ suspects
πŸ“The Library
πŸ“…The Murder
occurred at β†’
πŸ“The Study
← owns
πŸ“¦Letter Opener

Graph traversal β€” what it enables

A knowledge graph lets Sage answer multi-hop questions that a flat notes document cannot:

  • β†’"Which characters were at the same place as the victim within two hours of the murder?"
  • β†’"Show me every family member on my maternal side born before 1900."
  • β†’"What artefacts appear in both the First Age and the Second Age of Aelindra?"
  • β†’"Who are all the characters connected to Lady Hartwell within two degrees of separation?"

Keeping your graph clean

  • Consistent relation labels β€” agree on a vocabulary and stick to it
  • One entity per concept β€” don't create "London" and "London, England" as separate Places
  • Use confidence levels β€” speculative edges pollute certain conclusions; tag them low confidence
  • Use Context entities for definitions β€” if a relation label needs explanation, create a Context entity for it
⚑Power user shortcut: The Relations page has a minimum confidence filter. Set it to 76+ to see only your confirmed knowledge graph β€” eliminating all speculation and showing only what you know for certain.
πŸ€–

AI & Sage Integration

Sage is NotaeLibrary's AI β€” and Worlds are one of the primary sources it can query. When you ask Sage a question in a Study Room that has a World attached, it has direct access to all your entities and relations.

The richer your World, the better Sage's answers. A few principles:

1

Structured beats prose

A Character entity with a clear description and linked Relations is more queryable than a long unstructured note about that person. Break information into entities and link them.

2

Timestamps unlock gap reasoning

Without times, Sage knows order. With times, Sage can compute durations, overlaps, and whether events are physically compatible.

3

Confidence signals uncertainty

Sage will caveat answers that draw on low-confidence entities, so you know which conclusions are solid and which are speculative.

4

Add a World Overview Context entity

Create a Context entity titled "World Overview" with a 2–3 sentence summary of what your World is about. This helps Sage frame answers correctly without you having to explain the context every time.

πŸ”’

Public vs Private Worlds

Every World has a visibility setting:

πŸ”’

Private

Only you (the owner) and Study Room moderators can view the World and its entities.

Best for: personal research, draft work, sensitive family information, evolving murder mystery theories.

🌐

Public

All Study Room members can browse the World's entities and relations via the public lore browser.

Best for: shared book club wikis, fan room lore bibles, completed family trees.

ℹ️Regardless of World visibility, Sage always has access to all Worlds in a Study Room when answering questions in that room β€” even private ones. Visibility controls human browsing, not AI query access.
βœ…

Quick-Start Checklist

Ready to build your first World? Work through this checklist: