Start here¶

This is the tab for the people who run Nerthus. This page tells you what the tool is, how it knows who you are, and what your role lets you do. Every other page in this tab is one task you can complete from that page alone.

What the tool is¶

Nerthus.Core manages the Nerthus lore repository, repozytorium-fabularne - the GitLab repo behind nerthus.pl. Markdown is the database. You write sessions, entities, and the roster as Polish Markdown by hand, and the tool reads those files and keeps the campaign's state straight: who owns what, who earned which PU, where the coin went, what happened where. The tool tracks campaign state. The game rules stay with the Narrators - it records that a character advanced, it never decides whether they should have.

The repository is closed. Narrators, Radni, the Namiestnik, and the Koordynator can open it on GitLab; nobody else can. A Gracz never needs to - they reach the lore through Margonem sign-in and the Discord commands, and the tool shows them what their role allows.

Polish is the domain language. Tags like @lokacja, types like Gracz and Postać, and statuses like Usunięty are literals. You write them exactly as spelled, diacritics included.

How the tool knows who you are¶

Every player has a Gracz block in the index. The block carries their Margonem profile id:

## Gracze

### Eraster
- @typ: Gracz
- @margonemid: 9826541
- @status: Aktywny

The @margonemid tag is the anchor. Nicks change over the years - the Margonem profile id never does. Every sign-in, every permission, and every recorded action points at that id, not at the name above it. The rest of the block, and the ## Gracze roster section it sits in, belong to Players.

You sign in through Margonem itself. The browser add-on proves you own the game account, the tool matches the profile id to your Gracz block, and you are in. There is no separate password and no separate account to keep.

Discord works too, once your Discord account is linked to your Margonem id. After that, slash commands like /pu or /sesja zamknij run as you, and everything you do is attributed to your Gracz. An unlinked Discord account can do nothing at all. Linking is a one-time step a Radny performs for you.

Gracz¶

Every registered player. A Gracz can:

• read the shared lore - entities, sessions, locations (/encja Gildia Teologów, /postać Lord Tussal, /lokacja Thuzal)
• check their own PU (/pu)
• check their own coin holdings
• check whether they may vote in the yearly Rada election (/wybory)
• edit their own Postać records

The pattern is: everyone's lore, your own numbers. A Gracz reads any entity in the world and writes only what is theirs.

Narrator¶

Runs sessions. On top of everything a Gracz can do, a Narrator can:

• write, edit, open, and close session records (/sesja zamknij) - closing is what moves the session's coin and delivers its intel
• award the monthly PU (/pu przyznaj)
• read every player's PU and coin - needed to run and settle sessions fairly
• fetch and archive session logs
• send Discord announcements

Uprawnienia - what a Narrator may run¶

What a Narrator may run is a separate question from what the tool lets them do. The tool will happily let any Narrator write any session. What content they are cleared to run is the Council's decision, and the Council keeps it in a table called Uprawnienia - one row per Narrator:

Every cell is a ceiling, not a yes-or-no. Magia: do 3/5 means this Narrator may run magic content up to level 3 of 5. A level-4 magic session goes to someone with Magia: TAK or do 4/5. Walki PvP: do 4 graczy means a five-player fight goes to someone else. Reading the table upward like this is the point: it tells you who can take a session, not only who must be turned away.

The cells take a fixed vocabulary:

A row marked Ranga: Narrator nieaktywny is out of consideration for everything, whatever its other cells say.

The Nick column is display only. The row is tied to the Narrator's Margonem id, so a nick change never loses a row or creates a second one. The Radni read and edit this table through the tool (/uprawnienia).

Radny¶

A Council member - the Rada Świata Fabularnego, elected yearly. A Radny stewards the repository itself. On top of session-running powers, a Radny can:

• create and edit any entity, and manage player records
• edit the Uprawnienia table (/uprawnienia ustaw)
• link Discord accounts to Margonem ids
• grant or revoke an extra permission for a single person
• manage access tokens
• record coin adjustments

Koordynator and Namiestnik¶

Both can do everything the tool allows. They are two separate roles that share the same powers today. The Namiestnik holds standing oversight of the world, and the office is bezkadencyjny - it has no fixed term. The Koordynator operates the tool day to day. Keeping them separate means the Council can split their powers later without touching the code.

Where to go next¶

• Set up the repository - the one-time import that turns the repository into a managed one. Do this first, once.
• Record a session - when you have run a session and need to write it down, commit it, and close it.
• Grant PU - when you are awarding the monthly PU, or a character's numbers look wrong.
• Transfer coin - when money changes hands, or an item needs to leave circulation.
• Link session logs - when you want the game transcript archived alongside the session.
• Entities - when you are creating, editing, retiring, or renaming anything in the world.
• Players - when you are adding a player or a character, or fixing the roster.
• Locations - when you are placing somewhere on the map, or connecting two places.
• Monthly settlement - what the tool does each month, and what it needs from you.
• Cheat sheet - the block shapes and key names on one card, for when you only need reminding.