Kallamo
GitHubDownload
Kallamo’s own engine

Narrative State

The engine behind every roleplay reply. It turns each turn into records of what happened, and hands each character only the part of the story that reached them.

01 replyThe turn is writtenThe reply is ready at once. The state catches up behind it.
02 triageWhat did it touch?A short pass decides which parts of the story the turn changed.
03 analysisRead closelyThose parts are read in depth, and every change declares its kind.
04 recordsWrite it downScene, time, belongings, relationships and knowledge. Big changes become proposals.
05 next replyOne perspectiveThe context is built from what the focal character can know.
Two halves of one engine

Roleplay is where it shows. Knowledge is what it keeps.

Roleplay

Every reply moves the world.

What the turn changed is applied to the story you are playing, and shown in the panel beside the chat.

SceneLocation, who takes part, who is nearby, objects present, the situation. A change applies whole or not at all.
Story timeThe clock moves by what the turn did. A skip moves it only by a span the turn states.
BelongingsItems with quantity, condition and notes, and resources reported as amounts with a reason.
RelationshipsA value, a title and a description from each side. Review shows the current bond beside the change.
New arrivalsA named character joins Worldbuild. Anonymous people, places and items are proposed first.
Knowledge

Every character keeps their own part.

What each one perceived, was told, believes and remembers, written in the subject’s own words.

Mara FinnaboutAldous Finn
knows he existsfields: statusconnection: connected to Mara
knowsHe vanished in 1983 and was never found.
learnedHis handwriting is on a torn logbook page.
not hers where he went          
FactionsShare their cards with members, with everyone, or everyone except who you pick.
PlacesRegions and areas hold what their locals know, read in play like a faction’s.
Canonical factsObjective truths of the world, kept apart from anyone’s belief. Searchable, retractable.
Where they meet

The scene gets only what its people could know.

Before every reply, facts, knowledge, beliefs, memories and relationships are chosen by perspective and relevance, inside the retrieval budget. A secret stays out of the scene until someone in it learns it.

Mara Finn
focal character
  • knows
    No one has kept the light in forty years.
  • remembers
    The lighthouse, from when she was a child.
  • learned · Chapter One
    A torn logbook page, dry, in his hand.
The village below the cliff
local knowledge
  • remembers
    Aldous walked up the path and never came down.
  • believes
    The cliff path is to be avoided after dark.
  • not reached
     the torn page on the stairs 
The narrator’s plan
private · never in the reply

 Who is in the scene and what each one can say.   What must stay unsaid. 

Before each reply the narrator writes a private scene plan. It never reaches the story; you can read it under the message diagnostics.

In your hands

Only what lasts is kept, and you can see all of it.

Durable records only

Each fact, belief and memory declares its kind. Where someone stands right now stays in the scene.

Big changes wait

A secret coming out or a new anonymous arrival comes to you as a proposal to approve or reject.

Activity and retries

Recent changes, and updates that were interrupted or failed, listed and ready to run again.

Tidy

Previews repeated statements and momentary detail, then retires them. Retired records stay in the history.

Undo by regenerating

Regenerating or switching a reply first undoes the state of the reply it replaces.

Diagnostics

The triage, the analysis, proposals, retries, timing and tokens of each turn, and the exact context sent.

Play the roleplay that ships with Kallamo.

New installs open with a village to play in and a cast to choose from. Pick someone and watch the Narrative State panel fill in.

Download KallamoMore about roleplay