query · world.settlement

Village social chronicle

Returns recent completed village conversations, support, and disagreements.

world.settlement.social-chronicle(filters?, cursor?, page_size?) -> query-page

Stable ID: world.settlement.social-chronicle
Owner: game.intersection-lifecycle, game.relationship, and authored settlement
Authority: read_only
Timing: immediate
Availability: active-session
Side effects: none
Determinism: stable owner order at the current committed tick
Introduced: 1.10.0

Usage

Read the newest completed village conversations, support, and disagreements for the normal settlement chronicle without opening or changing an Incident.

Parameters

cursor: optional continuation cursor.
page_size: bounded encounter-row limit.

Returns

Newest-first detached encounter rows with the Incident, tick, Site, two named participants, interaction kind, relationship stage, and latest relationship reason.

Cost

One bounded reverse Incident traversal plus one Relationship and authored-name lookup per returned row.

Fields

ID	Type	Units	Required	Description
`first_actor_id`	`stable-id`	none	yes	First participant identity.
`first_display_name`	`string`	none	yes	First participant display name.
`incident_id`	`stable-id`	none	yes	Completed social incident identity.
`interaction`	`enumeration`	none	yes	Conversation, support, or disagreement.
`last_reason`	`enumeration`	none	yes	Latest relationship change reason.
`occurred_at_tick`	`unsigned-integer`	ticks	yes	Tick when the encounter occurred.
`relationship_stage`	`enumeration`	none	yes	Relationship stage after the encounter.
`second_actor_id`	`stable-id`	none	yes	Second participant identity.
`second_display_name`	`string`	none	yes	Second participant display name.
`site_cell_x`	`signed-integer`	grid-cells	yes	Encounter World-grid X coordinate.
`site_cell_y`	`signed-integer`	grid-cells	yes	Encounter World-grid Y coordinate.
`site_id`	`stable-id`	none	yes	Site where the encounter occurred.

Errors

Examples

local chronicle = world.query("world.settlement.social-chronicle", {page_size = 3})

API history

1.10.0: Retained village social chronicle added for Village Life addendum D.