Regelsätze für Game Mode schreiben

Ein Regelsatz erklärt Game Mode, wie ein Tischrollenspiel funktioniert: welche Würfel eine Probe wirft, was auf dem Charakterbogen steht, welche Ressourcen verbraucht werden und was eine Rast wiederherstellt. Schreib einen, um dein eigenes System in Game Mode zu bringen und es zu teilen. Wenn du mit einem fremden Regelsatz spielen möchtest, siehe Mit einem Regelsatz spielen.

Ein Regelsatz besteht aus einer JSON-Datei. Sie enthält Daten, keinen Code. Nichts darin wird ausgeführt, und der Import kann deinem Computer nicht schaden. Lies vor dem Import einer fremden Datei den Text für den Game Master, denn er wird in jedem Spiel mit diesem Regelsatz an das Modell gesendet.

Einen Regelsatz anlegen

1. Kopiere die Beispieldatei, deren Würfelmechanik zu deinem System passt:

• ember-roads.json ist ein kleines 2d6-System mit drei Werten. Es zeigt, dass das Format weder einen d20 noch sechs Attribute voraussetzt.
• gravewatch.json ist ein kleiner Pool mit zehnseitigen Würfeln, drei Grundwerten und sechs Tätigkeiten.
• Das offizielle Paket für 5e (SRD 5.1) ist ein vollständiges Beispiel. Der Agent Organizer installiert dessen ruleset.json und catalogs/.

1. Ersetze id durch deine eigene ID. Sie besteht aus Kleinbuchstaben, Ziffern und einzelnen Bindestrichen, etwa ember-roads.
2. Öffne deine Kopie in einem Texteditor wie Notepad oder VS Code und speichere sie mit der Endung .json. Ändere zuerst name, dann die Namen der Attribute in sheet, danach rests und den Text unter gm. Bestandteile der Datei führt jeden Schlüssel auf, und unter Referenzseiten findest du die Seiten, die sie erklären.
3. Importiere die Datei (siehe Deinen Regelsatz ausprobieren). Der Import prüft die gesamte Datei und nennt dir Zeile für Zeile die Fehler, bevor er etwas speichert.
4. Erstelle ein neues Spiel (siehe Game Mode: Erste Schritte), wähle deinen Regelsatz unter Rules (Regeln) und spiele einige Proben.

Wenn es nicht funktioniert hat, siehe Fehlerbehebung.

Damit dein Editor dir beim Schreiben hilft, füge folgende Zeile als erste Zeile innerhalb der äußeren geschweiften Klammern der Datei ein. Sie verweist den Editor auf das JSON-Schema:

"$schema": "https://raw.githubusercontent.com/Pasta-Devs/Marinara-Engine/staging/docs/extending/ruleset.schema.json",

Das Schema erkennt falsch geschriebene Schlüssel und falsche Typen. Es kann nicht prüfen, ob Namen auf vorhandene Dinge verweisen, etwa ob eine Fertigkeit ein existierendes Attribut nennt. Das prüft der Import. Du kannst in jedem Objekt eine Zeile "$comment": "..." als Notiz für dich ergänzen. Die Engine ignoriert sie.

Was ein Regelsatz kann und was nicht

Ein Regelsatz gestaltet eine Mechanik aus, die die Engine bereits kennt. Die Engine kennt fünf Arten, eine Probe aufzulösen, und deine Datei wählt eine davon mit resolution.kind:

• dice-sum: Würfel werfen, Zahlen vom Bogen addieren und einen Schwierigkeitswert erreichen oder übertreffen. Das deckt d20-Systeme, Systeme mit 2d6 plus Attribut und viele weitere ab.
• dice-pool: Die eigene Würfelanzahl des Charakters werfen und die Würfel zählen, die einen Zielwert erreichen. Das deckt Systeme ab, in denen ein Wert für eine Handvoll Würfel statt für einen Bonus steht.
• dice-highest: Einen Pool werfen und seinen höchsten Würfel ablesen oder seine höchsten paar Würfel addieren. Das deckt Blades in the Dark und Trophy Dark ab.
• roll-against: Auf oder unter (oder über) die Zahl vom Bogen würfeln. Das deckt Prozentfertigkeiten und GURPS-Proben ab.
• symbol-pool: Erzählwürfel zusammenstellen und aufwerten und dann gegnerische Symbole gegeneinander aufheben. Das deckt Genesys-Proben ab und seit Capability API 1.382 auch dessen Kämpfe.

Alle fünf werden unter Auflösungsarten vollständig beschrieben.

Eine Mechanik, die in keine dieser Formen passt, etwa vergleichende Pools, lässt sich nicht in einer Regelsatzdatei ausdrücken. Sie braucht eine neue Auflösungsart in der Engine, also einen Codebeitrag mit Tests. Wenn dein System so etwas benötigt, öffne einen Funktionswunsch im Engine-Repository und beschreibe die Mechanik anhand einiger durchgerechneter Würfe. Diese Würfe werden zu den Tests.

Game Mode löst einen Kampf entweder nach den eigenen Kampfregeln von Marinara oder nach den Regeln deines Regelsatzes auf. Ein optionaler battle-Block stellt Marinaras Kampfsystem die Zahlen deiner Charakterbögen bereit; siehe Kämpfe. Ein optionaler combat-Block legt fest, wie der Regelsatz den Kampf selbst auflöst; siehe Kampfregeln. Die Combat Preference (Kampfpräferenz) des Spiels wählt die Darstellung Classic oder, wenn der Regelsatz Entfernungen definiert, ein Schlachtfeld in Tactical. Ein Regelsatz kann mit combat.styles einschränken, welche dieser Stile seine Spiele verwenden (siehe Welche Stile ein Spiel verwenden darf).

Bestandteile der Datei

Die Datei darf bis zu 512 KB groß sein (vor Capability API 1.340 waren es 256 KB). Text, der in einem Prompt landet – Namen, Beschriftungen und Game-Master-Text –, darf keine Zeilenumbrüche, eckigen Klammern oder doppelten geschweiften Klammern enthalten.

IDs innerhalb des Bogens, etwa für Attribute, Fertigkeiten, Felder und Pools, bestehen aus Kleinbuchstaben, Ziffern und Unterstrichen und beginnen mit einem Buchstaben, zum Beispiel grit_max.

Referenzseiten

Diese Seite erklärt, wie du einen Regelsatz anlegst, ausprobierst und teilst. Die anderen Seiten behandeln jeweils ein Thema:

• Proben im Regelsatz: die fünf Auflösungsarten, Ergebnisbereiche, Proben, die auf ihre eigene Art würfeln, und Ressourcenausgaben oder Talismane, die einen Wurf verändern.
• Charakterbögen im Regelsatz: Attribute, Fertigkeiten, Felder und Listen, Live-Zustände, Wundleisten, Abzüge, Rasten, der Text für den Game Master, der Gruppenbogen und Fortschrittsuhren.
• Kataloge im Regelsatz: vorgefertigte Einträge, die der Bogeneditor in einer Auswahl anbietet.
• Mechanik von Regelsatzeinträgen: der mechanics-Block eines Katalogeintrags, den Proben, Rasten und Kämpfe lesen.
• Charaktererstellung im Regelsatz: einen Charakter schrittweise erstellen, von Volk und Klasse bis zu Werten, Ausbildungen, Zaubern und Ausrüstung.
• Gegenstände im Regelsatz: Kategorien, Waffen, Rüstungen, Munition, Beute, Geld, Startausrüstung und Märkte.
• Kämpfe im Regelsatz: der battle-Block und der combat-Block, mit Bestiarium, Brett, Reaktionen und vergleichenden Proben.
• Regelsatzebenen, Übersetzungen und Migrationen: Varianten, die ein Spieler für ein einzelnes Spiel einschaltet, Übersetzungen und das Übertragen von Werten auf neue IDs, wenn sich ein Charakterbogen ändert.

Deinen Regelsatz ausprobieren

Bevor du anfängst, schalte Allow custom Agent imports (Import eigener Agenten erlauben) unter Settings → Advanced → Danger Zone (Einstellungen → Erweitert → Gefahrenbereich) ein. Importierte Regelsätze verwenden denselben Sicherheitsschalter wie importierte Agenten, deshalb ist er aus, bis du ihn einschaltest. Der Import braucht außerdem Zugriff über localhost oder das Admin-Secret (Settings → Advanced → Admin Access).

1. Öffne das Panel Agents und wähle Import agents (Agenten importieren), das Download-Symbol in der Schaltflächenreihe oben im Panel.
2. Wähle Game Mode ruleset (Regelsatz für Game Mode) und deine JSON-Datei oder eine Regelsatz-Paketdatei mit der Endung .ruleset.json (siehe Deinen Regelsatz teilen).
3. Lies die Prüfung. Sie zeigt Name, Version, Lizenz, Umfang des Regelsatzes und den Text für den Game Master. Wähle Import (importieren).

Dein Regelsatz erscheint im Bereich Rules des Panels und in der Auswahl Rules des Einrichtungsassistenten für neue Spiele. Ein aus einer Datei importierter Regelsatz wird als local/<your id> abgelegt. Er wird dadurch nie mit einem offiziellen oder fremden Regelsatz verwechselt.

Einen bereits importierten Regelsatz ändern

Eine importierte Version wird niemals überschrieben. Importierst du eine geänderte Datei mit derselben version, wird der Import abgelehnt und fordert eine höhere Nummer. Ein Spiel ist an genau die Version gebunden, mit der es erstellt wurde, deshalb ändert sich die Mathematik einer laufenden Kampagne nie.

Beim Entwerfen lautet die Folge: bearbeiten, version erhöhen, importieren, neues Spiel beginnen. Alte Versionen bleiben neben der neuen installiert, bis du den Regelsatz aus dem Bereich Rules entfernst. Verwendet ein Spiel einen entfernten Regelsatz noch, meldet es ihn als fehlend, bis du ihn erneut importierst.

Änderst du die Form des Bogens durch Hinzufügen, Entfernen oder Umbenennen von Einträgen, erhöhe auch sheet.version. Vorhandene Bögen werden tolerant gelesen: Dem neuen Bogen unbekannte Werte bleiben erhalten, fehlende Werte verwenden ihre Standards.

Deinen Regelsatz teilen

Es gibt fünf Wege, ihn zu teilen.

Als Datei

Schick die JSON-Datei an einen Freund. Er importiert sie genauso wie du.

Als Paketdatei

Ein Regelsatz, der für eine einzelne Datei zu groß ist und Kataloge in eigenen Dateien hat, reist als eine einfache JSON-Datei namens <name>.ruleset.json. Sie enthält das Paketmanifest und die Dokumente des Regelsatzes, jedes als Base64 gespeichert (eine Art, eine Datei als reinen Text zu schreiben):

{
  "format": "marinara-ruleset",
  "version": 1,
  "manifest": { "kind": ["ruleset"], "…": "the package manifest" },
  "files": {
    "ruleset.json": "<base64>",
    "catalogs/spells.json": "<base64>"
  }
}

Das Manifest führt ruleset.json und jedes catalogs/<id>.json in contributions.assets.paths und in files auf, jeweils mit Größe und sha256 (einem Fingerabdruck der Datei). Ein Regelsatz-Editor wie Pixelforge erstellt eine solche Datei. Import agents → Game Mode ruleset nimmt die Datei an und zeigt dieselbe Prüfung wie für eine Regelsatzdatei, mit jedem Katalog und der Zahl seiner Einträge.

Die Datei wird als Daten gelesen und nie als Paket installiert. Nichts darin ist komprimiert, sie enthält also nie mehr als ihre eigene Größe. Grenzen:

• Sie wird wie eine Regelsatzdatei als local/<its id> abgelegt.
• Sie ist höchstens 132 MB groß und hat höchstens 12 Katalogdateien zu je 2 MB und 40 Übersetzungen zu je 8 MB (siehe unten).
• Eine Version umfasst ihren Regelsatz und ihre Kataloge zusammen, ein geänderter Katalog braucht also ebenfalls eine höhere version.
• Regelsatzpakete werden nicht als ZIP-Dateien angenommen.

Sie wird mit Begründung abgelehnt, wenn:

• sie einen anderen Schlüssel oder eine andere Datei enthält oder ein Dokument, das kein striktes Base64 oder kein UTF-8-Text ist
• ihr Manifest mehr verlangt, als ein Regelsatz braucht (Code, Berechtigungen oder andere Beiträge)
• eine Datei nicht die ist, die das Manifest aufführt
• ein $comment länger als 2.000 Zeichen ist oder $schema etwas anderes als das eigene Schema der Engine nennt
• sich der Regelsatz oder ein Katalog nicht lesen lässt

Über den offiziellen Agentenkatalog

Ein im Katalog veröffentlichter Regelsatz ist eine Regelsatz-Paketdatei genau dieser Form, <id>.ruleset.json, niemals ein Paket-Zip. Sein Manifest deklariert Capability API 1.374 oder neuer, sodass er einer älteren Engine nie angeboten wird. Die Engine liest ihn mit demselben Leseverfahren und denselben Prüfungen wie eine importierte Paketdatei, prüft ihn gegen das vom Katalog aufgeführte Manifest und installiert ihn wie jedes Katalogpaket. Ein Katalogregelsatz, dessen Artefakt ein Zip ist, wird abgelehnt, bevor etwas heruntergeladen wird; bereits installierte Regelsätze funktionieren weiter.

Aus einem GitHub-Repository

Verwahrst du deine Arbeit in einem öffentlichen GitHub-Repository, lege jeden Regelsatz als eigene Datei in einen Ordner rulesets auf dessen oberster Ebene:

your-repository/
  agents.json        (optional, only if you also share agents)
  rulesets/
    ember-roads.json
    another-system.json

Nutzer fügen dein Repository einmal hinzu, prüfen seinen Inhalt und synchronisieren es später, um neue Versionen zu erhalten. Die Liste eigener Repositories ist eine erweiterte Funktion. Wer den Server betreibt, schaltet sie mit ENABLE_CUSTOM_AGENT_REPOS=true ein und öffnet dann Agents → Agent Organizer → Custom Sources (Agenten → Agentenverwaltung → eigene Quellen). Regelsätze aus einem Repository werden unter dem Namen seines Besitzers abgelegt, etwa alice/ember-roads. So können zwei Autoren jeweils einen Regelsatz namens v20 veröffentlichen, ohne einander in die Quere zu kommen.

Es gelten zwei Grenzen. Ein Repository darf höchstens 32 JSON-Dateien direkt in rulesets enthalten; eines mit mehr wird abgelehnt. Ein Konto namens local kann keine Regelsätze veröffentlichen, denn local/ ist für Regelsätze reserviert, die aus einer Datei importiert wurden.

Im offiziellen Katalog

Ein verbreitetes System mit geklärten Lizenzrechten kann über Agent Organizer allen angeboten werden. Um eines vorzuschlagen, öffne einen Pull Request im Repository Marinara-Agents. Das dortige Paket ruleset-5e-2014 zeigt die Verzeichnisstruktur.

Lizenzierung

Veröffentliche nur Regeltexte, die du teilen darfst. Viele Systeme bieten ein Referenzdokument unter einer offenen Lizenz an; daraus darfst du kopieren. Trage unter license die Lizenz-ID (eine SPDX-ID, ein kurzer Standardname wie CC-BY-4.0) und den Urheberhinweis ein, den die Lizenz verlangt. Kopiere keine Texte aus nicht offen lizenzierten Regelbüchern. Ein Regelsatz braucht vor allem Namen und Zahlen. Formuliere den Text für den Game Master selbst.

Fehlerbehebung

• Der Import meldet einen unbekannten Namen. Etwas in der Datei verweist auf eine nicht deklarierte ID, etwa eine Fertigkeit auf ein entferntes Attribut. Die Meldung nennt den Pfad zur betroffenen Zeile.
• Der Import meldet eine bereits installierte Version mit anderem Inhalt. Erhöhe version und importiere erneut.
• Mein Regelsatz fehlt im Einrichtungsassistenten. Prüfe, ob Allow custom Agent imports eingeschaltet ist. Solange der Schalter aus ist, werden importierte Regelsätze für neue Spiele ausgeblendet, und Spiele, die bereits einen verwenden, funktionieren weiter.
• Ein Spiel meldet seinen Regelsatz als fehlend. Die genaue Version, mit der es erstellt wurde, ist nicht installiert. Importiere diese Dateiversion erneut.