Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
10 changes: 6 additions & 4 deletions public/assets/ow_llm_guide.txt
Original file line number Diff line number Diff line change
Expand Up @@ -99,13 +99,14 @@ colour sets for drawing, not part of the standard either.

BEINGS
- character: an individual with agency who makes choices (protagonists, NPCs)
- creature: a living being with behaviour but without a character's reasoning,
narrative focus or social complexity (beasts, monsters, named animals)
- creature: a living being with behaviour but without a character's reasoning
or social complexity (beasts, monsters, named animals)
- species: a biological or cultural form of life; characters and creatures link to it

GROUPS
- family: a group tied by lineage, heritage or community (bloodlines, dynasties)
- collective: a group acting as a unit without formal governance (crews, mobs, bands)
- collective: a group acting as a unit, with no formal governance of its own
(crews, mobs, bands, regiments)
- institution: an organised body with purpose and structure (guilds, states, churches)

PLACES AND THINGS
Expand Down Expand Up @@ -406,7 +407,8 @@ SDK: 4.x (OwV2Client, v2 API)
Changelog:
- v12: the type headings and the SDK colour groups named as reading aids, not part of
the standard; ChatGPT Canvas dropped; a Relation's actor is optional; elementColor
described as a default colour.
described as a default colour; creature and collective defined without "narrative
focus" and "hierarchical structure".
- v11: the toolkit's skills by their 5.x names; every parameter a list
takes (ids, created_by, as, world).
- v10: one set of environment variable names, OW_API_KEY, OW_API_PIN,
Expand Down
1 change: 1 addition & 0 deletions src/content/docs/docs/changelog.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,6 +7,7 @@ What changed for developers, newest first: the API on onlyworlds.com, the client

## 2026-10-29

- **Sharper definitions on the [Creature](/docs/schema/element_categories/creature), [Collective](/docs/schema/element_categories/collective), [Family](/docs/schema/element_categories/family), [Species](/docs/schema/element_categories/species) and [Title](/docs/schema/element_categories/title) pages**, from an outside review of the docs: a Creature is told from a Character by reasoning and social complexity, not by how much the story follows it; a Collective has no formal governance of its own, though it can have a `composition` and an Institution as `operator`; a Family's tie is one that passes down; a Species is a biological kind or one set apart by origin or culture; and Title describes a convention for who held it when, a Relation with supertype `Tenure`. The schema page, [Conventions](/docs/schema/conventions) and the LLM guide carry the same wording.
- **[Python](/docs/development/python#what-it-covers) 0.83.2**: the doctor reads a Law with supertype Charter and no mark as lore, not a finding, as the checks profile says; its house rules are never applied.
- **[Public worlds](/docs/development/api/public#what-a-visitor-sees)**: an element's page reads its whole address, a moment and a lens included; the owner, signed in, goes on to their own page for it; a public Pin, Marker or Zone leads to the world's page.

Expand Down
4 changes: 2 additions & 2 deletions src/content/docs/docs/schema/conventions.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -40,8 +40,8 @@ The category definitions draw these lines themselves:

| Pair | The line |
| :--- | :--- |
| Character / Creature | A Character is "an individual with agency and the capacity to make choices"; Creatures "lack the strategic reasoning, narrative focus, or social complexity of Characters." |
| Institution / Collective | Institutions are "organized bodies with purpose and structure"; a Collective "acts as a unit but lacks formal governance or hierarchical structure." |
| Character / Creature | A Character is "an individual with agency and the capacity to make choices"; Creatures "lack the strategic reasoning or social complexity of Characters." |
| Institution / Collective | Institutions are "organized bodies with purpose and structure"; a Collective "acts as a unit but has no formal governance of its own." |
| Species / Collective | A Species is "a distinct biological or cultural form of life"; a Collective is "unified by shared traits, contexts, or purpose." |
| Object / Construct | Objects are "tangible, non-living things that can be made, owned, traded or destroyed"; Constructs are "non-physical, non-character entities that help explain or organize how the world works." |
| Phenomenon / Construct | Phenomena are "ongoing or emergent conditions... not defined by intent or agency"; Constructs are "frameworks that are made, sustained and lost over time." |
Expand Down
8 changes: 5 additions & 3 deletions src/content/docs/docs/schema/element_categories/collective.md
Original file line number Diff line number Diff line change
@@ -1,15 +1,17 @@
---
title: "Collective"
description: "A Collective is a group of individuals that acts as a unit but lacks formal governance or hierarchical structure."
description: "A Collective is a group of individuals that acts as a unit but has no formal governance of its own."
sidebar:
order: 3
---

<img src="/icons/collective.png" alt="" width="48" height="48" class="ow-type-icon" />

A Collective is a group of individuals that acts as a unit but lacks formal governance or hierarchical structure. Collectives range from spontaneous mobs to herds of animals, and are unified by shared traits, contexts, or purpose.
A Collective is a group of individuals that acts as a unit but has no formal governance of its own. Collectives range from spontaneous mobs to herds of animals, and are unified by shared traits, contexts, or purpose.

A Collective is a loosely organized group defined by common identity or circumstance, not by structure or command. They interact with:
It can have an internal make-up (`composition`), and an Institution can run it (`operator`): a regiment is a Collective, the army command that directs it an Institution.

A Collective is a group defined by common identity, circumstance or task, not by offices and rules of its own. They interact with:

- **Characters and Creatures** (who form their body)
- **Species** (defining their biological foundation(s))
Expand Down
6 changes: 3 additions & 3 deletions src/content/docs/docs/schema/element_categories/creature.md
Original file line number Diff line number Diff line change
@@ -1,13 +1,13 @@
---
title: "Creature"
description: "Creatures are living entities within a world that exhibit behavior and agency but lack the strategic reasoning, narrative focus, or social complexity of Characters."
description: "Creatures are living entities within a world that exhibit behavior and agency but lack the strategic reasoning or social complexity of Characters."
sidebar:
order: 5
---

<img src="/icons/creature.png" alt="" width="48" height="48" class="ow-type-icon" />

Creatures are living entities within a world that exhibit behavior and agency but lack the strategic reasoning, narrative focus, or social complexity of Characters. Their role is typically reactive over proactive, but they can still play important parts in a world's ecology, mythology, or atmosphere.
Creatures are living entities within a world that exhibit behavior and agency but lack the strategic reasoning or social complexity of Characters. Their role is typically reactive over proactive, but they can still play important parts in a world's ecology, mythology, or atmosphere. How much the story follows a being does not decide its category: a warhorse at the centre of a saga is a Creature unless it reasons and chooses as a person does.

Creatures help populate the world with living presence. They interact with:

Expand All @@ -18,7 +18,7 @@ Creatures help populate the world with living presence. They interact with:

They are distinct from:

- **Characters** (who possess intent, narrative relevance, and structured goals)
- **Characters** (who possess intent and structured goals)
- **Objects** (which are inanimate)
- **Phenomena** (which are forces or occurrences, not beings)

Expand Down
4 changes: 3 additions & 1 deletion src/content/docs/docs/schema/element_categories/family.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,9 @@ sidebar:

A Family is a group tied together by lineage, heritage or community.

A Family is a group tied together by lineage, heritage or community. They interact with:
The tie is one that passes down: birth, marriage, adoption, or a descent its members claim (a clan, a noble house, a sworn kin-group). A group held together by place, work or circumstance is a [Collective](/docs/schema/element_categories/collective).

Families interact with:

- **Characters** (who are members, descendants or ancestors)
- **Traits, Abilities, and Languages** (passed down or shared)
Expand Down
2 changes: 2 additions & 0 deletions src/content/docs/docs/schema/element_categories/species.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,6 +9,8 @@ sidebar:

A Species defines a distinct biological or cultural form of life. They help define how life functions or diverges across environments and histories.

Two uses: a biological kind, with `life_span`, `nourishment` and `parent_species` filled in, or a kind of being a world sets apart by origin or culture with no biological difference, which leaves those fields empty. A population defined only by place, culture or allegiance is usually a [Collective](/docs/schema/element_categories/collective) or an [Institution](/docs/schema/element_categories/institution).

Species shape physical and behavioral defaults of a world. They interact with:

- **Characters and Creatures** (defined as members of species)
Expand Down
4 changes: 4 additions & 0 deletions src/content/docs/docs/schema/element_categories/title.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,6 +9,10 @@ sidebar:

A Title is a formal designation that confers identity, standing, or power within a world. It may be granted, inherited, or assumed, and often functions within a wider system of governance, belief, or custom. Titles help structure how individuals relate to institutions, spaces, and ideas across time.

**A convention for holders over time.** `holders` lists who holds the Title now. To keep who held it when, give each holding its own [Relation](/docs/schema/element_categories/relation) with supertype `Tenure`: `actor` the holder, `titles` the Title, `start_date` and `end_date` the span.

On onlyworlds.com, the [draught](/docs/development/api/draught) reads these into a Character's role.

Titles define structured identity and power. They interact with:

- **Characters** (holding titles)
Expand Down
4 changes: 2 additions & 2 deletions src/content/docs/docs/schema/index.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -15,10 +15,10 @@ Use as much of it as you need. Only `name` is required: the key must be present,
| Category | Definition |
| :--- | :--- |
| [Character](/docs/schema/element_categories/character) | A Character represents an individual with agency and the capacity to make choices that affect their world. |
| [Creature](/docs/schema/element_categories/creature) | Creatures are living entities within a world that exhibit behavior and agency but lack the strategic reasoning, narrative focus, or social complexity of Characters. |
| [Creature](/docs/schema/element_categories/creature) | Creatures are living entities within a world that exhibit behavior and agency but lack the strategic reasoning or social complexity of Characters. |
| [Species](/docs/schema/element_categories/species) | A Species defines a distinct biological or cultural form of life. |
| [Family](/docs/schema/element_categories/family) | A Family is a group tied together by lineage, heritage or community. |
| [Collective](/docs/schema/element_categories/collective) | A Collective is a group of individuals that acts as a unit but lacks formal governance or hierarchical structure. |
| [Collective](/docs/schema/element_categories/collective) | A Collective is a group of individuals that acts as a unit but has no formal governance of its own. |
| [Institution](/docs/schema/element_categories/institution) | Institutions are organized bodies with purpose and structure. |
| [Location](/docs/schema/element_categories/location) | A Location represents a distinct place within the world where activities occur and elements converge. |
| [Object](/docs/schema/element_categories/object) | Objects are tangible, non-living things that can be made, owned, traded or destroyed. |
Expand Down
Loading