Glossary¶
One-line definitions of the Polish domain terms used throughout Nerthus.Core, in alphabetical order. The system speaks Polish natively — these terms appear verbatim in data, tags, and (as concepts) in cmdlets. Always use the canonical spelling with diacritics.
| Term | Meaning |
|---|---|
.nerthus/ |
The tool's on-disk namespace (state, the index-format version pointer, runtime, cache, logs, data tables). |
.robot/ (legacy) |
The previous-generation tooling dir; only its res/ is read at import — pu-sessions.md (the PU ledger) always, and maps.md on the bootstrap path (when the index has no ## Mapa registry yet). |
| Dodatkowe informacje | The bold-label charfile section holding a character's freeform notes; entries are API-editable and support temporal (from:to) ranges — see Players & Characters. |
| Gracz | A player — a real human, identified by the Margonem profile ID (nicks are fungible). Entity type Gracz. |
| Gracze.md | The original hand-maintained player roster — the roster source on the import's bootstrap path; retired during adoption once its contents move into the durable ## Gracze/## Postacie Graczy sections of nerthus.entities.md — see Players & Characters. |
| Grupa | A group / faction / organization. Entity type Grupa. |
| Karta Postaci (KP) | A character sheet — freeform, usually on the player's Margonem profile; the tool links to it, never parses it. |
| Kogi Skeltvorskie | The copper-tier currency denomination — the integer base unit (×1). |
| Koordynator | The coordinator who operates the tool day to day. Holds admin.all, like the Namiestnik. |
| Korony Elanckie | The gold-tier currency denomination (×10000 Kogi). |
| Log archive | nerthus.logs/ — the one committed transcript store (raw .log + parsed .json sidecar per URL), readable offline in every clone; the gitignored cache holds only .failed retry markers. |
| Logi | Session transcripts (game logs), linked by URL from a session's @Logi. |
| Lokacja | A location. Hierarchical via @lokacja; exterior status is signalled by @koordynaty/@outerior — see Locations. Entity type Lokacja. |
| Mapa | A Margonem game map, keyed by @margonemid and bound to the Lokacja it depicts. Entity type Mapa. |
| NADMIAR | The overflow PU pool — PU above the monthly cap, carried forward unbounded and drawn on in lean months. |
| Namiestnik | The governor — the top administrative authority. Maps to the admin.all capability bundle. |
| Narrator | The game master / session runner. Sessions credit a narrator in their header. |
| NPC | A character controlled by a Narrator rather than a player. Entity type NPC. |
| Physical / Virtual currency | Postać-owned coin = real Margonem in-game items (Physical); coin held by any other type (NPC, Grupa, Gracz, Lokacja) = pure RP bookkeeping (Virtual). |
| Postać | A character — an in-fiction persona, owned (@należy_do) by one Gracz. Entity type Postać. |
| PRFWebhook | A player's personal Discord webhook, used to deliver PU/Intel notifications; the @prfwebhook tag on the Gracz card in the committed index is its only source. |
| Przedmiot | An item. Currency is modelled as Przedmiot entities. Entity type Przedmiot. |
| PU (Punkty Umiejętności) | Skill points — the progression "currency". Awarded per character per session and settled monthly — see PU model. |
| Rada (Świata Fabularnego Nerthus) | The narrators' Council that governs the campaign. |
| Radny | A Council member (member of the Rada Świata Fabularnego Nerthus). Rank Narrator (Radny). |
| repozytorium-fabularne | The live GitLab lore repository at https://gitlab.com/margonem/nerthus/narratorzy/repozytorium-fabularne — the source behind nerthus.pl and the data this tool manages; private, readable only by contributors. |
| Rich / basic template | A transcript's content shape: rich is the log-saver JSON record, basic is raw text — see Logs model. |
| Rozliczenie | A settlement — one run applying every pending routine operation (distribution repairs, transfers, the month's PU); names the settle commits and merge requests — see Settlement model. |
| Sesja | One play session, identified by its unique header ### YYYY-MM-DD, Title, Narrator. |
| STARTOWE | A character's starting PU baseline (seeded once on creation/import). |
| SUMA | A character's total PU (= STARTOWE + all earned PU). |
| Sync (z origin) | Keeping a VM daemon's clone converged with the GitLab origin: an in-daemon scheduler fetches, publishes pending daemon writes as the bot account, and fast-forwards — see Sync. |
| SyncStale | The 403 refusal a sync-enabled daemon issues for writes once it has not converged with origin within the configured max age — fail-closed (a daemon that never converged is stale); a successful sync clears it (Sync). |
| Talary Hirońskie | The silver-tier currency denomination (×100 Kogi). |
| Tematy zastrzeżone | A player's restricted topics / content triggers — things they don't want at their sessions; recorded as the typed tag @tematy_zastrzeżone on the Gracz block. |
| Umiejętność / Atrybut / Potencjał Magiczny | Character-sheet vocabulary (skills like ekspert Złodziejstwa, attributes, magic potential) — reference only; never parsed or validated. |
| Uprawnienia | The narrator-permissions table: a narrator's rank and content ceilings (Magia, Polityka, Walki PvP), used as routing data — see Permissions. |
| Wątek | A "thread" — a Wątki/*.md file collecting related sessions. |
| WYBORY / UPRAWNIONY | Council elections / "eligible to vote". Eligibility is computed from PU activity over a rolling window — see PU model. |
| Zatrudnienia | An Uprawnienia column: whether the narrator may employ/recruit NPCs into player service (TAK / Podstawowe / NIE). |
| ZDOBYTE | PU earned through play (= SUMA − STARTOWE). |
See also¶
Architecture · Entities model · Tag schema · PU model · Permissions