Cheat sheet¶

This page is a recap card - the names, keys, and forms you need while you write, 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 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
`@margonemid`	a player's Margonem profile id	Players and characters
`@prfwebhook`	a player's Discord channel for PU and Intel notifications	Players and characters
`@tematy_zastrzeżone`	subjects a player wants kept out of their sessions	Players and characters
`@drzwi`	a passage between two places	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 seven 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	Players and characters
`Postać`	a character owned by a player	Players and characters
`Przedmiot`	an item, a coin included	Entities

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