Cheat sheet¶

Nerthus.Core (until cutover). This page describes the frozen system that runs today and is deleted at cutover. Replaced by: not yet written.

This page is a recap card - the names, keys, and forms you need while you work, and nothing else. Every row links to the article that explains it. When a row is not enough, follow its link: the examples and the rules live there, not here.

Session metadata keys you write¶

Key	What it is	Explained in
`Lokacje`	where the session happened	Record a session
`Logi`	links to the session's game transcripts	Link session logs
`PU`	the points each character earned	Grant PU
`Intel`	information delivered to a character, group, or location after the session	Record a session
`Uczestnicy`	a participant who earned no points	Record a session
`Transfer`	what changed hands	Transfer coin
`Data`	the session's date, overriding the header	Record a session
`Tytuł`	the session's title, overriding the header	Record a session
`Narrator`	the session's Narrator, overriding the header	Record a session

Pliki is not one of yours. The tool writes it and rewrites it whole every time, so leave it alone - see Record a session. The Lokacje/ folder is the generated, read-only registry of sessions by place - same article.

The session header¶

Fact	The session header
Form	`### YYYY-MM-DD, Title, Narrator`
What it is	the session's repository-wide unique identifier
Edited after the session is recorded	never
Explained in	Record a session

Entity tags you write¶

Tag	What it is	Explained in
`@typ`	the entity's type	Entities
`@lokacja`	the place the entity sits in	Entities
`@należy_do`	who owns the entity	Entities
`@alias`	an alternate name for the entity	Entities
`@grupa`	a faction or guild the entity belongs to	Entities
`@status`	whether the entity is in play	Entities
`@plik`	the file the entity's sessions are copied into	Entities
`@ref`	the file that holds the entity's facts	Entities
`@margonemid`	a player's Margonem profile id; one line per account, the old one's range closed	People and roles
`@discord`	a player's Discord channel for PU and Intel notifications	People and roles
`@tematy_zastrzeżone`	subjects a player wants kept out of their sessions	People and roles
`@rola`	what a person is in the campaign; one line per hat	People and roles
`@należy_do`	who owns the entity - the player behind a `Postać`, the holder of an item	Player characters
`@region`	a named group of places the entity belongs to	Regions
`@drzwi`	a passage between two places	Doors between places
`@region`	the region a place belongs to	Locations and maps
`@wymiary`	a game map's size in tiles	Locations and maps
`@koordynaty`	a game map's position	Locations and maps
`@typ_lokacji`	whether a game map is exterior or interior	Locations and maps
`@ilość`	the amount in an item or coin holding	Transfer coin
`@generyczne_nazwy`	the coin type a holding is made of	Transfer coin

The eight entity types¶

Type	What it is	Explained in
`NPC`	a non-player character	Entities
`Grupa`	a faction, guild, or organization	Entities
`Lokacja`	a place in the world	Locations and maps
`Mapa`	a Margonem game map that depicts a place	Locations and maps
`Gracz`	a real player	People and roles
`Postać`	a character owned by a player	Player characters
`Przedmiot`	an item, a coin included	Entities
`Region`	a named group of places	Regions

Statuses¶

Status	What it is	Explained in
`Aktywny`	in play	Entities
`Nieaktywny`	not in play right now	Entities
`Usunięty`	retired	Entities
`Niepewny`	uncertain - a place the tool could not match	Locations and maps

Date forms¶

Form	What it is	Explained in
`YYYY`	a year	Entities
`YYYY-MM`	a year and a month	Entities
`YYYY-MM-DD`	a year, a month, and a day	Entities
`(from:to)`	a date range on a tag value	Entities
`(2026-07:)`	an open end - from July 2026 onward	Entities
`(:2026-06)`	an open start - until June 2026	Entities
`2022-12-21/22`	a session date spanning two days inside one month	Record a session
`2023-01-31/02-01`	a session date spanning two days across two months	Record a session

The four PU fields¶

Field	What it is	Explained in
`STARTOWE`	the points the character started with	Grant PU
`SUMA`	the character's running total right now	Grant PU
`ZDOBYTE`	the points the character earned through play	Grant PU
`NADMIAR`	the character's overflow reserve	Grant PU

The three coins¶

Coin	What it is	Explained in
`Korony Elanckie`	the gold coin, short form `Korony`	Transfer coin
`Talary Hirońskie`	the silver coin, short form `Talary`	Transfer coin
`Kogi Skeltvorskie`	the copper coin, short form `Kogi`	Transfer coin

Discord commands¶

Command	What it is	Explained in
`/zgłoś`	a form for filing a session the Rada reviews	Submit a session report
Zgłoś sesję	right-click a message, Apps: the same filing from a message you wrote	Submit a session report
`/zamknij-sesję`	closing a session, with an optional date or title	Record a session
Zamknij sesję	right-click a message, Apps: closing the session its header names	Record a session
`/status`	the tool's own state, and how many sessions await closing	Submit a session report
`/sesje-otwarte`	the sessions still needing a close	Submit a session report
`/pu`	your PU, per character	Submit a session report

Those seven are the whole set.

Dashboard tabs¶

Tab	What it is	Explained in
Transkrypty	who spoke, in which session, and what they said	Use the web dashboard
Sesje	every session of the campaign, by date, title, Narrator and place	Use the web dashboard
Minimapa	how the world connects, on one tile grid	Use the web dashboard
Higiena	forms the index does not know	Use the web dashboard
Repo	the lore files themselves	Use the web dashboard
Flota	which machine is running what	Use the web dashboard
Ustawienia	your key, and which campaign the site reads	Use the web dashboard