Skip to content

Nerthus.Core

Nerthus.Core manages the Nerthus tabletop-RPG lore repository, repozytorium-fabularne, the GitLab repo behind nerthus.pl. Markdown is the database: the tool reads and writes the repository's Polish Markdown files - entities, sessions, PU, currency, locations, governance - and keeps the campaign's records straight. The tool tracks campaign state; the game rules stay with the Narrators.

Polish is the domain language. Tags like @lokacja and types like Gracz or Postać are literals, written exactly as they appear on disk.

Pick your side

  • I run the campaign

    You are a Koordynator, Namiestnik, Narrator, or Radny. You write sessions, award PU, and keep the world records straight, by hand, in Markdown.

    One article per topic, steps first, no code. Each stands on its own - you never have to follow a link to finish a task.

    Start here

  • I work on the code

    You add or change daemon services, routes, cmdlets, tests, or pipelines.

    Architecture, the end-to-end feature recipe, the subsystem models, and the reference tables.

    Start here

If you are setting up for the first time

Set up the repository walks the one-time import that turns an existing lore repository into a managed one, ending with the unified index nerthus.entities.md. It is written for an operator and needs no programming knowledge.