Modding

Wo ist der Mods-Ordner?

Öffnen Sie Mods im Hauptmenü. Der Pfad wird oben auf dem Bildschirm angezeigt, daneben befindet sich eine Schaltfläche, die den Ordner in Ihrem Dateimanager öffnet.

Es befindet sich neben Ihren Spielständen und ist derselbe Ordner, unabhängig davon, ob Sie den Mod eines anderen installieren oder Ihren eigenen schreiben. Während das Spiel läuft, wird nichts gelesen, daher spielt es keine Rolle, ob das Spiel geöffnet ist, während Sie Dateien verschieben.

Installieren Sie eins

Ein Mod ist ein Ordner mit mod.json oben. Bei den meisten Downloads handelt es sich um diesen Ordner in einer ZIP-Datei.

Ein Mod, in den Sie kopieren, bleibt ausgeschaltet, bis Sie es sagen. Das Spiel lehnt ausführbare Dateien ohne Frage ab, aber ein Datenpaket kann trotzdem Preise, Gegenstände und Personen auf eine Art und Weise ändern, die Sie nicht gewünscht haben, und wenn eines von selbst in einem bereits laufenden Spiel auftaucht, ist das ein Problem, das niemand diagnostizieren möchte. Das Spiel fragt also. Beim ersten Mal ist es ein zusätzlicher Neustart und für dieses Paket nie wieder.

Es gibt keinen Launcher, keine Ladeauftragsdatei zum Bearbeiten und es gibt nichts zum Aufzeichnen. Die Ladereihenfolge ist eine Zahl in jedem Paket, die vom Autor ausgewählt wird.

Starte eine neue Partie für ein Paket, das Personen, Orte oder Quests hinzufügt. Ein bereits laufender Spielstand behält die Welt, mit der er erstellt wurde. Pakete, die nur Zahlen, Bilder oder Farben ändern, sind in einer bereits begonnenen Partie sichtbar. Audio- und Schriftdateien werden geprüft, aber noch keine laufende Paketoberfläche verbraucht sie.

Ist es geladen?

Mod, im Hauptmenü. Jedes gefundene Paket steht in einer Zeile mit einem Ein-Wort-Status: geladen, deaktiviert, ungültig, in Konflikt stehend, erfordert einen anderen Mod, ignoriert.

Ein Mod kann sich auch selbst ausschalten, und es wird angezeigt, warum. Der von Ihnen eingestellte Schalter gilt für das Paket, auf dem Sie ihn abgelegt haben, nicht für seinen Namen im Ordner. Die Mod-IDs werden von den Autoren ausgewählt und es gibt nichts, um sie zu koordinieren, daher sind zwei nicht verwandte Mods, die beide northern_reach heißen, ein gewöhnlicher Zufall – und ohne dies würde der zweite den Schalter des ersten erben. Wenn der Mod unter einer ID nicht der ist, den Sie aktiviert haben, heißt es in der Zeile: Dies ist nicht der Mod, den Sie aktiviert haben. Durch das Aktualisieren eines Mods bleibt Ihr Switch erhalten; Löschen Sie es und kopieren Sie eine andere Nummer.

Wenn Sie der Autor eines Mods sind und diese Zeile auf Ihrem Paket sehen, liegt eine ID-Kollision mit dem Mod einer anderen Person vor. Wählen Sie eine weniger offensichtliche ID.

Bei zwei dieser Worte geht es um einen Neustart, den Sie schulden, nicht um das Paket. Aktiv – zum Laden neu starten bedeutet, dass Sie es eingeschaltet haben und noch niemand es gelesen hat; Aus – zum Herunterladen neu starten bedeutet das Gegenteil und der Inhalt bleibt bis zum Neustart im Spiel. Das sind absichtlich getrennte Wörter: Ein Bildschirm, auf dem „Geladen“ steht, sobald Sie einen Schalter betätigen, würde Sie dazu veranlassen, die Welt nach etwas zu durchsuchen, das noch nicht da ist.

Wenn der Status nicht „geladen“ ist, erfahren Sie in der folgenden Zeile, warum Sie nicht geschrieben haben, in der Sprache, in der Sie spielen, und ohne Bezeichner: welche Datei das Spiel nicht ausführen möchte, welches Paket fehlt, welche Version es möchte. Nachfolgend sehen Sie, was der Inhalt des Pakets bewirkte: Wie viele Einträge wurden eingegeben, wie viele wurden abgelehnt. Details anzeigen öffnet den Rest, d. h. die IDs und die genaue Regel, gegen die jeder abgelehnte Datensatz verstoßen hat.

Zwei Zeilen teilen sich absichtlich ein Wort: Erfordert einen anderen Mod Für einen Spieler ist es das gleiche Problem, ob das Paket fehlt oder die falsche Version ist, und die Zeile darunter sagt welches. Und wenn zwei Pakete denselben Datensatz beanspruchen, schreibt dasjenige mit dem höchsten load_order zuletzt und gewinnt – aber eine Übernahme, die niemand deklariert hat, ist ein Fehler, keine Notiz. Beide Reihen werden gemeldet, und die Verliererreihe benennt den Gewinner, und der Gewinner wird immer noch berechnet, anstatt dem Zufall überlassen zu werden: Eine Ablehnung muss nicht unbedingt ein Münzwurf sein. Wenn zwei Mods dasselbe wollen erklärt, wie man absichtlich einen Mod deklariert.

„Hochgeladen“ bedeutet immer noch nicht, dass Sie es weltweit sehen können. Lesen Sie dazu die Zählungen unter der Zeile ab, und Jetzt im Spiel finden gibt an, wo welche Art von Dingen auftaucht.

Die Zählungen summieren sich immer. Betten werden angewendet, mehr abgelehnt, mehr durch einen anderen Mod ersetzt, mehr warten auf ihre eigenen Bedingungen – und die letzten beiden werden nominiert, anstatt ein Loch zu bleiben. Ein Datensatz, den ein anderes Paket zuletzt schreibt, wird nicht abgelehnt, weil daran nichts auszusetzen ist, und er wird nicht einmal erzwungen, weil das Spiel das nicht beibehalten hat. Es ist der Unterschied zwischen dem Lesen einer Zeile und dem Verbringen eines Abends mit der Suche nach einem Fehler in einer Datei, die keinen enthält. Details anzeigen zeigt an, welcher Datensatz und welches Paket ihn jetzt hat.

Eine Zahl steht neben dieser Summe und nicht darin: Dateien, die niemand gelesen hat. Eine Datei, deren Familie nicht in content_types enthalten ist, wurde noch nie geöffnet, daher gibt es keinen zu zählenden Datensatz und es gibt keine Möglichkeit zu wissen, wie viele darin enthalten sind. Es handelt sich um eine Zählung von Dateien, nicht von Datensätzen, und genau deshalb kann es kein sechster Term sein: Die Summe beginnt bei read, und diese wurden noch nie gelesen.

Bevor Sie jemanden um Hilfe bitten

Öffnen Sie Mod und klicken Sie auf Bericht kopieren. Fügen Sie alles in Ihre Nachricht ein und sagen Sie dann, was Sie erwartet haben.

Einfacher Text, bereit für ein Forum, eine Discord-Nachricht oder einen Fehlerbericht: der Build, auf dem Sie sich befinden, der Mods-Ordner, jedes Paket mit seiner Version, seine Ladereihenfolge und sein Status, der Grund für jede Ablehnung, die Anzahl für jeden Inhaltstyp und welches Paket jeden Kampf gewonnen hat.

the report the Mods screen copies

Bonemark mod report
game build: 0.0.0-dev
mods folder: C:/Users/you/AppData/Roaming/Godot/app_userdata/Bonemark/mods
packages: 2 found, 1 loaded

PACKAGES
  northern_reach  v0.1.0  order 100  active
    goods: 12 read, 12 applied, 0 rejected
  winter_roads  unreadable manifest
    - game_version must not be empty

CONTENT (1 families: 12 read, 12 applied, 0 rejected)
  goods: 12 read, 12 applied, 0 rejected

In neun von zehn Fällen steht die Antwort im Block und niemand muss Ihnen zuerst eine einzige Frage stellen. Es liest nichts außerhalb des Mods-Ordners, ändert nichts und enthält keine persönlichen Informationen.

Es ist auf Englisch, auch wenn Sie in einer anderen Sprache spielen. Dies ist beabsichtigt: Die Person, die Ihnen hilft, liest möglicherweise Ihre nicht, und alle darin enthaltenen Fakten – IDs, Versionen, Zählungen – sind in allen Sprachen immer noch gleich.

Entfernen Sie einen

Löschen Sie den Ordner und starten Sie neu. Die Deinstallation ist hier.

Nichts von Ihnen wird dabei gelöscht. Ein Speichervorgang behält die IDs, die nicht mehr aufgelöst werden können, markiert sie und gibt Dinge zurück, wenn das Paket neu installiert wird. Eine Sitzung, die einen Spielstand nicht verstehen kann, überschreibt ihn nicht einmal: Die Originaldatei bleibt genau so, wie sie war, und das ist der Unterschied zwischen einem verlorenen Nachmittag und einem verlorenen Spiel. Speichert ist der vollständige Bericht.

Wenn das Spiel nicht mehr läuft, nachdem Sie etwas installiert haben, ist das Spiel nicht mehr erforderlich. Öffnen Sie den Mods-Ordner und entfernen Sie das zuletzt hinzugefügte Element. Pakete können nur aus diesem Ordner gelesen werden. Ein Ordner, der nicht vorhanden ist, ist also ein Paket, das nicht geladen werden kann, und der nächste Start erfolgt wie zuvor. Sie benötigen dazu kein funktionierendes Menü, keine Konsole oder Startup.

Sogar das Spiel versucht es von alleine – Wenn das Spiel nicht startet ist es eine begrenzte Anzahl von Versuchen und dann ein Rückweg ohne geladene Pakete – aber das ist der Gürtel, und das Verschieben des Ordners ist der Hosenträger.

Was Sie heute bauen können

Jetzt, ohne jemanden zu fragen: Waren und ihre Händler, Gegenstände, Personen und ihre Standorte, Gebäude und ihre Dienste, Orte auf der Karte, Gespräche, Szenen, Questpläne, in Tiled gezeichnete Karten, Bilder und Farben sowie alle ihre Texte in sieben Sprachen. Audio- und Schriftdateien werden geprüft und gelesen, aber ihre Paketoberflächen werden noch nicht verbraucht; die Statustabelle sagt das ausdrücklich, statt sie als bereit zu bezeichnen. Alle Familien sind die gemessene Liste, und ihr Status stammt aus dem Build statt aus einem Versprechen.

Noch nicht, und Was du noch nicht tun kannst erklärt jeden Fall: die Familie quests, Paket-Audio, Paket-Schriften, verpackte Total Conversions und ein Paket, das eine Funktion statt Inhalt wäre.

Niemals, aufgrund der Projektauswahl: Code. Keine Skripte, keine Szenen, keine Ressourcendateien, nichts, was das Spiel ausführen könnte. Dies macht es sicher, den Mod eines Fremden herunterzuladen, und es ist keine Phase, die das Projekt durchläuft. Was ein Mod niemals tun kann.

Zeit bis zum ersten, was Sie im Spiel sehen können: Ungefähr zehn Minuten, die größtenteils mit der Suche nach dem Ordner verbracht werden. Ein Mod in zehn Minuten ist vollständig durch und das Schwert am Ende ist echt.

Was Sie noch nicht können und warum

Hier steht es gleich am Anfang, statt erst am Ende entdeckt zu werden. Das sind die Dinge, die der Build prüft, ohne sie derzeit auf eine spielerorientierte Paketoberfläche zu setzen, sowie Dinge, die überhaupt kein Paketinhalt sind.

Eine Mechanik, die das Spiel noch nie hatte, ist die vierte Reihe mit einem anderen Hut. Ein Schwert, das härter zuschlägt, ist eine Zahl und gehört dir; Eine Waffe, die einen Strahl abfeuert, benötigt die Regeln des Strahls, und die Regeln sind Code, den jemand schreibt und testet.

Was ist ein Mod?

Ein Ordner mit Textdateien. Sie schreiben keinen Code. Sie schreiben Listen mit Dingen, die Sie im Spiel haben möchten, und das Spiel liest sie, wenn es startet.

Die einzige Regel, aus der sich alles andere ergibt: Sie können Daten hinzufügen und ändern. Sie können das Spiel nicht dazu bringen, Code auszuführen. Das macht es sicher, einen Mod herunterzuladen: Das Schlimmste, was der Mod eines Fremden anrichten kann, ist, ein albernes Schwert auf dich zu legen.

34 Familien sind heute sofort einsatzbereit, darunter items, buildings, pois, npc_definitions, vendor_inventories, quest_plans, caravans und perks. Alle Familien bilden die vollständige Tabelle mit dem Zweck jeder Familie; Die Familien einzeln zeigen ihre Felder und einen kopierbaren Datensatz.

Wählen Sie Ihren Weg

Dies ist das Inhaltsverzeichnis des gesamten Leitfadens – hier wird über jedes Thema geschrieben, unabhängig davon, ob Sie es heute erstellen oder nicht. Oben in Teil 3 befindet sich ein zweiter, kürzerer Index: Das sind die sechs Tutorials in der Reihenfolge, in der sie aufeinander aufbauen. Wenn Sie hier sind, um etwas zu tun und nicht, um etwas zu suchen, dann gehen Sie direkt dorthin.

Oder die Sache, die dir durch den Kopf geht. Diese Anleitung ist in der Reihenfolge angeordnet, in der die Arbeit stattfindet – Manifestieren, dann Validieren, dann Inhalt, dann Berichten –, was die Reihenfolge ist, die jemand wählen würde, der das System bereits kennt. Diejenigen, die ihn nicht kennen, denken Ich möchte einen Händler hinzufügen und suchen nach dem Wort Händler:

Was brauchen Sie

Ein Editor, der JSON einfärbt, zeigt Ihnen ein fehlendes Komma an, während Sie es noch betrachten, anstatt dass das Spiel Ihnen später mitteilt, dass die Datei nicht lesbar war.

Python und die Konsole sind optional. Das Spiel genügt: Lege das Paket ab, starte neu und öffne Mods, wo jeder abgelehnte Datensatz samt Grund genannt wird. Der Autoren-Checkout ist öffentlich. Wer schneller iterieren oder Veröffentlichungen automatisieren möchte, kann den öffentlichen Bonemark-Checkout klonen und die Offline-Werkzeuge unter Offline-Werkzeuge ausführen; Spieler eines veröffentlichten Pakets benötigen weder Python noch Godot. Derselbe öffentliche Checkout enthält den Validator und die Runtime-Deklarationen, daher beschreiben die beiden Abschnitte eine gemeinsame Werkzeugkette. Die Werkzeuge verwenden dieselben Deklarationen wie das Spiel — Record-Schemas und Sicherheitsgrenze haben jeweils eine einzige Quelle — und antworten deshalb früher, niemals anders. Eine Debug-Konsole hilft beim Prüfen eines geladenen Pakets, ist aber zum Schreiben keines nötig.

Beginnen Sie mit dem, was Sie tun möchten

Alles unterhalb dieser Zeile ist in der Reihenfolge angeordnet, in der die Arbeit stattfindet: Plakat, dann Akten, dann Familien, dann Berichte. Es ist die richtige Reihenfolge, etwas zu suchen, und die falsche, damit anzufangen, denn niemand beginnt mit einem Manifest. Es beginnt mit Ich möchte einen Händler.

Dann: Wählen Sie den Satz, der dem ähnelt, was Sie tun möchten.

Die sechs Tutorials sind ein einzelnes Paket, das Stück für Stück zusammengebaut wird: eine Bienenwachskerze, das Bündel, das ein Spieler bei sich trägt, der Wachsmacher, der es verkauft, die Tür zu seinem Laden, die Grube hinter der Gerberei, aus der der Talg stammt, und schließlich eine Modifikation der Kerze, die das Spiel bereits hatte. Machen Sie sie der Reihe nach und erhalten Sie am Ende einen Mod, den jemand herunterladen könnte. Legen Sie eins in die Mitte und es funktioniert von alleine.

Wo sind die Spielnummern?

Jedes Tutorial hier bewertet eine neue Sache, indem es sie mit etwas vergleicht, das das Spiel bereits verkauft, denn eine Zahl ohne nichts daneben ist eine Schätzung, und eine Schätzung in einer Wirtschaft, die zwischen Städten Handel treibt, bleibt nicht dort, wo Sie sie eingegeben haben.

Sie können die Spieldateien nicht öffnen. Seine Datensätze sind Godot-Assets innerhalb des gepackten Builds – ein anderes Format als das JSON, das Sie schreiben, mit category = 1, wobei in Ihrer Datei "MANUFACTURED" steht. Es gibt keinen Ordner zum Kopieren und das Entpacken ist kein Arbeitsablauf, den jemand dokumentieren muss.

Du brauchst es nicht. Der Katalog veröffentlicht den Inhalt des Spiels, der bei jedem Build aus denselben Datensätzen generiert wird: 270 Gegenstände mit ihrer Kategorie, ihrem Gewicht, ihrem Münzwert und ihrer Stapelgröße, 49 Waffen, 42 Rüstungsteile, 37 Standorte. Es ist die Referenz, auf der dieser Leitfaden basiert, er kann nicht vom Spiel abweichen und der Name des Feldes ist neben jeder Zeile abgedruckt.

Ein Dutzend Werte, die Sie kennen sollten, bevor Sie einen Preis für etwas festlegen:

Wenn Ihr neues Ding mehr kostet als eine Plattenrüstung, ist etwas schief gelaufen, und das Spiel verrät es Ihnen nicht – es wird stillschweigend zur profitabelsten Fracht der Welt und jede Karawane wird sie transportieren.

Eine Ware zum Verkaufen

Sie werden über eine Ware verfügen, deren Preis die Wirtschaft zu bestimmen weiß, die an die Kerze gekoppelt ist, die das Spiel bereits verkauft, und die von einem Händler gehalten werden kann.

Screenshot: Noch nicht aufgenommen. Dieser Raum bleibt leer, bis es ein echtes gibt: Eine Zeichnung, wie es aussehen könnte, wäre das Einzige auf der Seite, das nicht real ist.

Zuerst lesen: Was ist ein Mod · Ein Mod in zehn Minuten · Namen und IDs

Kopieren aus: dem Ordner namens chandlery, der sich bereits in Ihrem Mods-Ordner befindet. Das Spiel legt es dort ab, wenn es zum ersten Mal gestartet wird, wenn es ausgeschaltet ist, und es ist das Endergebnis dieser sechs Tutorials: Alle unten aufgeführten Datensätze sind vorhanden. Es ist auch das Paket, das die Testspur des Repositorys gegen den Loader dreht, daher gibt es hier keinen Datensatz, den das Spiel ablehnen würde. Schalten Sie es ein, um zu sehen, wie es funktioniert, oder kopieren Sie den Ordner, benennen Sie ihn um und machen Sie ihn zu Ihrem.

Wohin die Dateien gehen:

where the files go

mods
└ chandlery
  ├ mod.json
  └ content
    └ economy
      └ goods
        └ goods.json

Beginnen Sie mit der Kerze, die das Spiel bereits hat. Sie heißt candle, kostet 3, wiegt 0,5, ist MANUFACTURED und PRESERVED und wird vom Apotheker hergestellt. Bei Ihnen handelt es sich um dasselbe Ding aus besserem Wachs. Behalten Sie also alle Antworten bei und ändern Sie zwei.

Vor mod.json:

mod.json

{
  "id": "chandlery",
  "name": "The Chandlery",
  "version": "0.1.0",
  "game_version": "0.0.0-dev",
  "dependencies": [],
  "load_order": 100,
  "content_types": ["goods"],
  "overrides": [],
  "canon_safe": true
}

Dann content/economy/goods/goods.json:

a goods record

[
  {
    "id": "chandlery:beeswax_candle",
    "display_name": "Beeswax Candle",
    "category": "MANUFACTURED",
    "decay_tier": "PRESERVED",
    "base_price": 9,
    "weight": 0.4,
    "production_class": "chandler",
    "daily_consumption_class": "household",
    "tags": ["light", "household"]
  }
]

Fertig – jetzt finden Sie es im Spiel. Starten Sie neu, öffnen Sie Mod und in der Zeile unter Ihrer steht 1 entry added. Es ist alles, was eine Ware für sich allein tut: Sie hat einen Preis, sie ist marktfähig und sie liegt bei niemandem auf der Ladentheke, weil sie noch niemand hat. Es ist kein Misserfolg und es ist die Sache, die jeden einmal verwirrt. Fahren Sie fort mit Ein Händler, der es auf Lager hat.

Wenn nicht angezeigt: Nichts wurde angezeigt hat die sechs Gründe in der richtigen Reihenfolge. Die mit Abstand häufigste ist content_types – eine fehlende Familie in dieser Zeile bedeutet, dass der Ordner nie geöffnet wird, egal, was er enthält. Dann Bevor Sie jemanden um Hilfe bitten, was eine einzelne Schaltfläche ist.

Ein Gegenstand zum Tragen

Du erhältst das Ding, das ein Spieler aufnimmt, in seinen Rucksack stapelt und weiterverkauft, gepaart mit den Waren, die du gerade geschrieben hast.

Screenshot: Noch nicht aufgenommen.

Zuerst lesen: [Ein Gut zum Verkaufen](#ein Gut zum Verkaufen) · Namen und IDs

Kopieren von: chandlery/content/inventory/items/items.json in deinen Mods-Ordner.

Wohin die Dateien gehen:

where the files go

mods
└ chandlery
  ├ mod.json
  └ content
    ├ economy
    │ └ goods
    │   └ goods.json
    └ inventory
      └ items
        └ items.json

Eine Ware und ein Gegenstand sind zwei Hälften derselben Sache. Die Ware ist der Gesichtspunkt der Ökonomie: was eine Stadt produziert, was eine Karawane transportiert, wie viel sie wert ist. Das Objekt ist die Sicht des Spielers: Was passt in den Rucksack, was ist gestapelt, was wird in einem Laden ausgestellt. Weizen hat eine Ware und keinen Zweck, denn niemand trägt eine Tüte Weizen mit sich herum. Kerzen haben beides.

Fügen Sie "items" zu content_types in mod.json hinzu und schreiben Sie dann content/inventory/items/items.json:

a items record

[
  {
    "id": "chandlery:beeswax_candle_bundle",
    "display_name": "Bundle of Beeswax Candles",
    "category": "MATERIAL",
    "rarity": "COMMON",
    "weight": 0.4,
    "max_stack": 20,
    "base_value": 10,
    "sellable": true,
    "tags": ["light", "household"]
  }
]

Fertig – jetzt im Spiel finden. Ein Gegenstand, den niemand liefert, ist geladen und aus dem Nichts erreichbar. In einem Debug-Build legt item chandlery:beeswax_candle_bundle sofort einen in Ihren Rucksack und es ist der schnellste Beweis dafür, dass er geladen ist – aber dieser Befehl existiert nicht in dem Spiel, das die Leute herunterladen, also ist er eine Verknüpfung für Sie und niemals die Antwort für einen Spieler. Die eigentliche Antwort ist das nächste Tutorial.

Wenn nicht angezeigt: Nichts angezeigt, dann Bevor Sie jemanden um Hilfe bitten.

Ein Händler, der es besitzt

Sie werden eine Frau mit einem Namen haben, die in Old Seat mit einer Theke, Vorräten, die alle zwei Tage aufgefüllt werden, und Ihren Kerzen auf der Theke steht.

Screenshot: Noch nicht aufgenommen.

Zuerst lesen: Ein Gegenstand zum Tragen · Jetzt im Spiel finden

Kopieren von: chandlery/content/narrative/npcs/npcs.json und chandlery/content/world/vendor_inventories/vendors.json.

Wohin die Dateien gehen:

where the files go

mods
└ chandlery
  ├ mod.json
  └ content
    ├ economy
    │ └ goods
    ├ inventory
    │ └ items
    ├ narrative
    │ └ npcs
    │   └ npcs.json
    └ world
      └ vendor_inventories
        └ vendors.json

Hier müssen zwei Familien zustimmen. Die Person trägt die ID der Bank, die Bank trägt die ID der Person und jede Zeile der Bank trägt die ID eines Objekts. Drei IDs, und jede muss genau so geschrieben sein, wie Sie sie in die andere Datei geschrieben haben. Es ist der Fehler, der einen Abend kostet, und der Mods-Bildschirm benennt ihn: Eine Zeile, die auf eine ID zeigt, die niemand bereitstellt, wird als erfordert einen anderen Mod, der nicht installiert ist aufgeführt.

Fügen Sie "npc_definitions" und "vendor_inventories" zu content_types hinzu.

a npc_definitions record

[
  {
    "id": "chandlery:hesta",
    "display_name": "Hesta the Chandler",
    "title": "Candle Seller",
    "short_bio": "She renders fat behind the tannery and sells what burns longest.",
    "voice_tone": "brisk",
    "faction": "NONE",
    "role": "NONE",
    "settlement_id": "old_seat",
    "is_vendor": true,
    "vendor_inventory_id": "chandlery:candle_stall",
    "price_multiplier": 1.0,
    "personality_tags": ["brisk", "practical"],
    "offers_quest_ids": []
  }
]

a vendor_inventories record

[
  {
    "id": "chandlery:candle_stall",
    "display_name": "Chandler's Stall",
    "npc_id": "chandlery:hesta",
    "global_price_multiplier": 1.0,
    "buyback_rate": 0.35,
    "entries": [
      {
        "item_id": "chandlery:beeswax_candle_bundle",
        "kind": "misc",
        "daily_stock": 6,
        "price_multiplier": 1.0,
        "restock_days": 2,
        "min_standing": 0
      }
    ]
  }
]

Fertig – jetzt finden Sie ihn im Spiel. Starten Sie neu, reisen Sie zum Old Seat, finden Sie Hesta, öffnen Sie den Handelsbildschirm. Wenn die Bank leer ist, wurde sie noch nicht aufgefüllt: Das ist restock_days, kein Fehler. Die Kette kann auf drei Arten unterbrochen werden und alle drei sind auf dem Mod-Bildschirm zu sehen: die Waren, die niemand hält, der Zähler, der auf eine Artikel-ID zeigt, die nicht existiert, die Person, die auf eine Zähler-ID zeigt, die nicht existiert.

Sie kann auch sprechen. Eine dialogue_graph, deren ID speaker ist, macht Witze, wenn ein Spieler darauf klickt, und Ihr Paket muss nichts neu definieren, was das Spiel bereits benötigt, um sie zu erhalten – siehe Ihre Gespräche. Eine locales-Datei bietet Ihnen all dies in sieben Sprachen.

Wenn nichts angezeigt wird: Vergleichen Sie zuerst die drei IDs miteinander, dann Nichts wurde angezeigt und dann Bevor Sie jemanden um Hilfe bitten.

Der Service eines Gebäudes

Sie werden in einer Siedlung eine Tür mit Ihrem Etikett und Ihrer Farbe haben, die zu einem Innenraum führt, den das Spiel bereits hat.

Screenshot: Noch nicht aufgenommen.

Zuerst lesen: [Ein Händler, der es behält](#ein-Händler-der-es-auf Lager hat) · [Was ein Mod niemals tun kann](#was-ein-Mod-nicht-tun kann)

Kopieren von: chandlery/content/world/buildings/buildings.json.

Wohin die Dateien gehen:

where the files go

mods
└ chandlery
  └ content
    └ world
      └ buildings
        └ buildings.json

Sie kombinieren neu, nicht erstellen. Ein buildings-Eintrag fügt einen neuen Dienst mit einer Bezeichnung, einer Portfarbe und einer Routinerolle hinzu und kann eine Erweiterung, die das Spiel bereits hat, durch Benennung wiederverwenden. Eine Verlängerung ist nicht möglich. Eine Erweiterung ist eine Szene, eine Szene ist Code und ein Paket, das einen Pfad res:// oder einen .tscn nennt, wird abgelehnt, bevor dieser Datensatz überhaupt gelesen wird. Es ist kein Loch, das darauf wartet, gefüllt zu werden: Es ist die Zeile, die es sicher macht, den Mod eines Fremden zu installieren.

a buildings record

[
  {
    "id": "chandlery:chandlery",
    "label": "Chandlery",
    "role": "merchant",
    "color": { "r": 0.44, "g": 0.38, "b": 0.24 },
    "interior_service": "shop"
  }
]

Fertig – jetzt finden Sie es im Spiel. Starten Sie neu und betreten Sie eine Siedlung, die Ihren Dienst hat. Ein Datensatz ohne settlement wird geladen und nirgendwo platziert, was mit einem fehlgeschlagenen Datensatz identisch ist: Auf dem Mod-Bildschirm wird 1 entry added angezeigt, und Sie werden nichts finden. Lesen Sie die Zeile, bevor Sie nach der Tür suchen.

Wenn es nicht angezeigt wird: Nichts angezeigt · Bevor Sie jemanden um Hilfe bitten.

Ein Ort auf der Karte

Sie werden einen Punkt auf der Weltkarte haben, über den ein Spieler stolpern kann, mit einer Beschreibung davon und seiner Auswirkung auf die Stimmung der Party.

Screenshot: Noch nicht aufgenommen.

Zuerst lesen: Der Gebäudeservice · Jetzt im Spiel finden

Kopieren von: chandlery/content/world/pois/pois.json.

Wohin die Dateien gehen:

where the files go

mods
└ chandlery
  └ content
    └ world
      └ pois
        └ pois.json

Koordinaten sind absolut, und die Welt wird um von den Autoren angelegte Orte erzeugt. Die Karte misst 61 440 × 34 560 Weltpixel, und Old Seat liegt in jeder Partie genau im Zentrum bei (30720, 17280). Die von den Autoren angelegten Städte und Dörfer behalten ihre Namen und Positionen. Der Seed verändert das Gelände und die Biome darum, die Knappheit des Jahres, die politische Ordnung und die Wege, die sich lohnen. Ein Punkt bleibt also echt und stabil; was daneben liegt, ändert sich in jeder Partie. Zwei ehrliche Verwendungen: Setze einen POI nahe an eine von den Autoren angelegte Siedlung, damit ein Spieler dort vorbeikommt; oder wähle die Leere, denn eine Rendergrube, die seit Jahren niemand besucht hat, soll nirgendwo Bestimmtes liegen.

a pois record

[
  {
    "id": "chandlery:tallow_pit",
    "kind": "RUINS",
    "display_name": "The Tallow Pit",
    "description": "A rendering pit behind the tannery. The smell reaches the road.",
    "world_position": { "x": 5400.0, "y": 3000.0 },
    "discovery_radius": 2.0,
    "one_time_loot": false,
    "morale_modifier": -1,
    "awareness_modifier": 0.0
  }
]

Fertig – jetzt finden Sie es im Spiel. Los geht's. Es gibt keinen Teleport-Befehl, weder in einem Debug-Build noch außerhalb, also wählen Sie die Koordinaten so weit aus, wie Sie bereit sind, beim Versuch zu gehen.

Wenn es nicht angezeigt wird: Sie sind wahrscheinlich nicht mehr in discovery_radius, oder der Ort befindet sich irgendwo, wo der Match-Seed einen Ozean hinterlassen hat. Nichts wurde angezeigt.

Ändern, was bereits vorhanden ist

Sie haben einen Datensatz, den das Spiel mit sich gebracht hat, geändert – und Sie haben ihn deklariert, sodass die Änderung für den Spieler und jeden anderen Mod sichtbar ist.

Screenshot: Noch nicht aufgenommen.

Zuerst lesen: Ändern, was das Spiel bereits hat · Wenn zwei Mods dasselbe wollen

Kopieren von: chandlery/content/economy/goods/goods.json, wodurch ein Datensatz hinzugefügt und einer aus dem Spiel in derselben Datei korrigiert wird.

Wohin die Dateien gehen: Nirgendwo neu. Eine Änderung an etwas, das das Spiel bereits im selben Familienordner hat, in dem sich Ihre Datensätze befinden – in der Datei steht, welchen Datensatz es beabsichtigt und was es damit macht.

where the files go

mods
└ chandlery
  ├ mod.json          the change is declared here
  └ content
    └ economy
      └ goods
        └ goods.json  your record and the patch, in one file

Zwei Regeln vor der Datei. Eine Änderung am Datensatz einer anderen Person muss in overrides innerhalb von mod.json benannt werden – ein Datensatz, der auf einer ID landet, die Sie nicht deklariert haben, wird abgelehnt, sodass nichts heimlich umgeschrieben werden kann, dem der Spieler nicht zugestimmt hat. Und patch, das ein Feld ändert und den Rest in Ruhe lässt, erfordert "manifest_version": 2.

mod.json

{
  "id": "chandlery",
  "name": "The Chandlery",
  "version": "0.1.0",
  "game_version": "0.0.0-dev",
  "manifest_version": 2,
  "load_order": 100,
  "content_types": ["goods", "items", "npc_definitions", "vendor_inventories", "buildings", "pois"],
  "overrides": ["candle"],
  "canon_safe": true
}

a goods record

[
  {
    "op": "patch",
    "id": "candle",
    "changes": [
      { "op": "set", "field": "base_price", "value": 4 },
      { "op": "append_unique", "field": "tags", "value": "chandlery_touched" }
    ]
  }
]

Fertig – jetzt finden Sie es im Spiel. Der Mod-Bildschirm benennt den Datensatz, den Sie erworben haben. Der Bildschirm des anderen Autors macht dies auch, falls es einen gibt: Wenn zwei Pakete die gleiche ID schreiben, steht in der Zeile des Verlierers jetzt replaced: Candle – 'chandlery' writes it last, anstatt stillschweigend einen Eintrag weniger anzuzeigen, als er geschrieben hat. Wer den höchsten load_order hat, schreibt zuletzt und gewinnt.

Gewinnen ist nicht dasselbe wie Erlaubnis zu haben. Zwei Pakete, die einen Datensatz annehmen, ohne sich gegenseitig in supersedes zu benennen, werden als undeclared_collision gemeldet und die Zusammensetzung ist nicht in Ordnung: Der Offline-Validator sagt dasselbe und lehnt ab:

typed into the debug console

ERROR: conflict on goods:candle: ['early', 'late'] each supply the whole record
and none declares the others under `supersedes`

Der Gewinner wird noch ermittelt, denn eine Absage muss nicht auch ein Münzwurf sein, sondern zwei Autoren, die es beide wollten, müssen es sagen. Wenn zwei Mods dasselbe wollen ist diese Konversation.

Wenn es nicht erscheint: Die übliche Ursache ist overrides – die ID muss in dieser Liste genau geschrieben sein, andernfalls wird der Datensatz abgelehnt statt angewendet. Wenn zwei Mods dasselbe wollen · Nichts angezeigt.

Ein Mod in zehn Minuten

1. Erstellen Sie einen Ordner in Ihrem Mods-Ordner, mit dem Namen in Kleinbuchstaben und Unterstrichen: northern_reach. Da drin passiert alles.

2. Schreiben Sie oben mod.json:

mod.json

{
  "id": "northern_reach",
  "name": "The Northern Reach",
  "version": "0.1.0",
  "game_version": "0.0.0-dev",
  "dependencies": [],
  "load_order": 100,
  "content_types": ["items"],
  "overrides": [],
  "canon_safe": true
}

id muss mit dem Ordnernamen übereinstimmen. content_types listet die Familien auf, die Sie mitbringen – eine Familie, die in dieser Zeile fehlt, wird nie gelesen, egal, was sich im Ordner befindet.

3. Erstellen Sie die Ordner content/inventory/items und fügen Sie blades.json hinein:

a items record

[
  {
    "id": "northern_reach:frost_blade",
    "display_name_key": "northern_reach.item.frost_blade.name",
    "display_name": "Frost Blade",
    "category": "weapon",
    "base_value": 240,
    "weight": 3
  }
]

Die eckigen Klammern sind eine Liste: Fügen Sie so viele Schwerter hinzu, wie Sie möchten, durch Kommas getrennt. Jede .json-Datei in einem Familienordner wird gelesen, also teilen Sie sie nach Ihren Wünschen auf.

240 ist keine Zahl, die gewählt wurde, um zu beeindrucken. In diesem Spiel reichen Einhandwaffen von 50 bis 300, daher ist eine Frostklinge mit 240 ein teures Schwert und kein legendäres Schwert, und ein Spieler kann es sich ungefähr zu der Zeit leisten, in der er sich die guten Waffen leisten könnte, die der Schmied bereits verkauft. Wo sind die Spielnummern ist die Tabelle, die Sie sich ansehen sollten, bevor Sie eine Nummer auswählen. Ein Preis, an dem sich nichts befindet, ist eine Hypothese, und in einer Wirtschaft, die zwischen Städten Handel treibt, bleibt eine Hypothese nicht dort, wo man sie hinstellt.

4. Starten Sie das Spiel und öffnen Sie Mods im Hauptmenü. Ihr Paket erhält genau einen Status und Wurde es geladen? hat alle sechs.

5. Lesen Sie die folgende Zeile, um herauszufinden, was gelesen, beantragt und abgelehnt wurde, und geben Sie den Grund für jede Ablehnung an. Details anzeigen hat IDs.

6. Dein Schwert ist im Spiel. Alles, was danach kommt, ist mehr vom Gleichen.

Finden Sie es jetzt im Spiel

Der Bericht sagt applied. Das bedeutet, dass die Schallplatte geladen ist, und das ist nicht dasselbe wie davorgehen zu können. Hier hört jeder Reiseführer auf und jeder Autor beginnt zu raten.

settlement_id bezeichnet einen von den Autoren angelegten Ort. Siedlungs-IDs sind von den Autoren angelegt und stabil: Durnwall, Thorngate, Valdmere, Grentham und die zwölf Dörfer können alle benannt werden. Der Seed verändert das Gelände und die Biome darum, die Knappheit des Jahres und die politische Ordnung, nicht die ID. Wenn du eine Person an einem sicher besuchten Ort platzieren willst, verwende eine beliebige Autoren-Siedlungs-ID und führe den Namen in den Sprachdaten deines Pakets.

Koordinaten sind absolut, und die Welt wird um von den Autoren angelegte Orte erzeugt. Die Karte misst 61 440 × 34 560 Weltpixel, und Old Seat liegt in jeder Partie genau im Zentrum bei (30720, 17280). Die von den Autoren angelegten Städte und Dörfer behalten ihre Namen und Positionen. Der Seed verändert das Gelände und die Biome darum, die Knappheit des Jahres, die politische Ordnung und die Wege, die sich lohnen. Eine world_position von (6000, 2200) bleibt daher ein echter, stabiler Punkt im äußersten Nordwesten der Karte, während sich das in der Nähe Befindliche in jeder Partie ändert: Straße, Wald oder Niemandsland. Zwei ehrliche Verwendungen:

• Immer noch in der Mitte. Ein interessanter Punkt, der ein paar tausend Pixel von (30720, 17280) entfernt ist, befindet sich in jedem Spiel in der Nähe des Alten Sitzes, also ist es ein Ort, den ein Spieler finden wird.
• Du meinst Leere. Eine Ruine, an der seit hundert Jahren niemand vorbeigekommen ist, muss irgendwo sein. Dafür sind die absoluten Koordinaten genau richtig und der Seed entscheidet, welche Nachbarn er haben wird.

Die zeitsparendsten Konsolenbefehle. day [n] und hour [n] erhöhen die Zeit, sodass Sie ein Angebot sehen, ohne es zu erleben. item <id> [count] und gold <amount> legen die Dinge in Ihre Hände. flag, quest_start und faction_rep verschieben den Zustand, auf den eine Bedingung möglicherweise wartet. Es gibt keinen Teleportationsbefehl: Um an einen Ort zu gelangen, muss man dorthin reisen.

mod.json, Feld für Feld

Eine Abhängigkeit kann ein Objekt anstelle eines Namens sein: {"id": "some_mod", "version": "", "optional": true}.

Ein Wert, der ein anderes Paket benennt, ist eine modübergreifende Referenz, und die Referenz muss eine deklarierte Abhängigkeit sein. Wenn diese Abhängigkeit optional ist, geben Sie dem Feld einen fallback, andernfalls wird der Datensatz übersprungen, wenn die Abhängigkeit fehlt:

a goods record

[
  {
    "op": "add",
    "id": "northern_reach:alloy",
    "display_name": "Alloy",
    "linked_item_id": "absent_helper:ore",
    "fallback": { "linked_item_id": "iron_ore" }
  }
]

Wohin jede Datei geht

where the files go

northern_reach/
  mod.json                  the label
  content/assets/images/
    images.json             your art
  content/inventory/items/
    blades.json             your first record
  content/narrative/quest_plans/
    the_long_winter.json    your quest

Namen und IDs

Eine ID besteht aus Kleinbuchstaben, Ziffern und Unterstrichen und nichts anderem. frost_blade, nicht Frost Blade, nicht frost-blade und nicht frost.blade. Es verfügt nicht einmal über ein eigenes Trennzeichen, da ein Trennzeichen innerhalb einer ID der Ordner ist, der in den Namen eindringt: Wenn Sie die Datei verschieben, stimmt die ID nicht mehr mit der Festplatte überein. Die oben genannten :s sind die einzige Ausnahme und beide Hälften folgen der Regel.

Der Teil vor dem Doppelpunkt ist Ihre Paket-ID. Auf diese Weise können zwei Mods beide eine Frostklinge hinzufügen, ohne dass es zu Konflikten kommt.

Wörter, die ein Spieler liest

Der in einem Datensatz geschriebene Text ist Text in einer einzigen Sprache. Zeigen Sie stattdessen auf einen Schlüssel:

a locale CSV

northern_reach.item.frost_blade.name
northern_reach.item.frost_blade.description

Die Schlüssel sind Kleinbuchstaben, durch Punkte verbunden, mit dem Namensraum als IDs. Bringt Wörter in die Familie locales – ein .csv unter content/locale mit einer Spalte key und einer Sprachspalte. Die Familien, eine nach der anderen hat die genaue Form.

Schreiben Sie außerdem das einfache display_name neben den Schlüssel. Eine Aufzeichnung, die nur einen Satz enthält, muss am Tag der Übersetzung von Hand umgeschrieben werden, und bis dahin sind es vierhundert.

Die beiden Möglichkeiten, etwas falsch zu machen, scheitern auf sehr unterschiedliche Weise, und nur eine davon sagt Ihnen das. Ein Schlüssel, der auf nichts reagiert, erscheint als der Schlüssel selbst – northern_reach.item.frost_blade.name, auf dem Bildschirm, absichtlich hässlich, damit jemand ihn reparieren kann, und wird als Loch gezählt. Ein Datensatz, der nur Text und keine Tasten enthält, erscheint nie: Er funktioniert in Ihrer Sprache für jeden Player in jeder Sprache. Nichts wird abgelehnt und nichts fehlt, es wird also nichts gemeldet, und ein Spieler, der auf Portugiesisch liest, liest still Ihr Italienisch. Du findest den ersten Fehler. Der zweite findet Ihre Leser.

Übersetze einen Mod und werde übersetzt

Das Spiel erscheint in sieben Sprachen, sodass ein Paket mit in die Aufzeichnungen integriertem Englisch für sechs Siebtel derjenigen, die es installieren, als Englisch gelesen wird. Dies ist der Preis, den es kostet, es zu vermeiden, was fast nichts ist, wenn Sie es am ersten Tag tun, und ein Umschreiben, wenn Sie es am vierhundertsten tun.

Die Sprachen, die es gibt

Sieben, und diese Tabelle wird aus dem Build gelesen und nicht hier handgeschrieben, sodass eine Sprache, die ankommt oder geht, sie am selben Tag verschiebt:

Bei zwei der Codes ist eine zweite Schreibweise im Umlauf – pt-BR ist diejenige, die eine digitale Storefront verwendet, und diese Seite, pt_BR, ist diejenige, der die Engine entspricht – und in einer Spaltenüberschrift werden beide akzeptiert. Schreiben Sie die, die Sie kopiert haben.

Tragen Sie Wörter in mehr als einer Sprache

Eine CSV unter content/locale, mit key an erster Stelle und einer Spalte pro Sprache:

a locale CSV

key,en,it,de
northern_reach:GOOD_FROST_SALT,Frost Salt,Sale di Brina,Frostsalz
northern_reach:ITEM_FROST_BLADE_NAME,Frost Blade,Lama di Brina,Frostklinge

Wenn auf einen Schlüssel keine Antwort in der Sprache des Spielers erfolgt, geht das Spiel eine feste Leiter hinunter: die Sprache des Spielers, dann die Sprache, in der Ihr Paket angeblich geschrieben wurde, dann der Spielekatalog und dann der Schlüssel selbst. Der letzte Schritt ist absichtlich hässlich: Ein ungelöster Schlüssel muss falsch aussehen, damit ihn jemand reparieren kann. Bei einer vollständigen Konvertierung wird der Spielekatalog übersprungen, denn das Auftauchen von Old Seat in einer Welt, die auf einem anderen Kontinent spielt, ist kein kleines Übersetzungsversehen, sondern das Basisspiel, das durchscheint.

Schreiben Sie Texte, die übersetzt werden können

• Keine in Einzelteilen aufgebauten Sätze. Die Wortreihenfolge ist nicht in allen Sprachen gleich, sodass ein Name, der zur Laufzeit aus einer Spalte mit Adjektiven und einer Spalte mit Substantiven zusammengesetzt wird, auf Italienisch Oro Cervo ergibt. Für jede Sprache wurde ein Eintrag geschrieben, vollständig.
• Der Name einer Person wird niemals übersetzt oder flektiert. Aldric ist in allen Sprachen Aldric. Das bedeutet auch, dass ein Schlüssel einen Namen nicht in einer schrägen Position platzieren darf – "of {name}", "{name}'s" –, da viele Sprachen Eigennamen ablehnen und das Spiel dies nicht tut.
• Es gibt keine Zeichenbeschränkung, und das ist nicht dasselbe wie keine Beschränkung. Keine Felder zählen Zeichen; Was am Ende Platz auf dem Bildschirm ist. Deutsch ist etwa ein Drittel länger als Englisch und die Sprache, die den Ton angibt; der Chinese ist viel kürzer und tut es fast nie. Wenn Sie nur eine Übersetzung ausprobieren, versuchen Sie es mit Deutsch und geben Sie einer Bezeichnung die kürzeste Formulierung, die noch richtig ist.

Jemand, der Ihr Paket übersetzt

Fügt eine Spalte hinzu und sendet die Datei an Sie zurück. Der Arbeitsablauf ist vollständig, und deshalb ist das Format CSV und nicht etwas, das für Programmierer benutzerfreundlicher ist: Ein Übersetzer kann es in einer Tabellenkalkulation öffnen, und seine Tools lesen es bereits.

Zwei Dinge machen den Unterschied zwischen einem Paket, das übersetzt wird, und einem Paket, das nicht übersetzt wird. Schlüssel stabil halten – ein umbenannter Schlüssel ist eine verlorene Übersetzung, und der Übersetzer findet es heraus, wenn ein Spieler es herausfindet. Und sagen Sie, wozu eine Zeile dient: Ein Schlüssel namens NR_MSG_01 erhält eine Vermutung, während northern_reach:VENDOR_HERB_GREETING die Begrüßung eines Kräuterverkäufers erhält.

Wenn Sie das Paket eines anderen übersetzen, gelten für Sie dieselben Regeln: Die Spalten sind die Sprachen, die das Spiel trägt, die Schlüssel sind seine Schlüssel und nicht Ihre, und ein Name bleibt ein Name.

Ändern, was das Spiel bereits hat

part of mod.json

"overrides": ["iron_sword"]

overrides ist ein Versprechen. Ein Datensatz, der auf einer ID landet, die Sie nicht deklariert haben, wird abgelehnt, sodass Sie niemals stillschweigend etwas ändern können, von dem ein Spieler nichts wusste.

a goods record

[
  {
    "op": "patch",
    "id": "iron_ore",
    "changes": [
      { "op": "set", "field": "base_price", "value": 14 }
    ]
  }
]

Ein Patch benennt seine Änderungen einzeln:

• set – Schreibt value in field, was auch immer vorher dort war. Es ist mit field und value geschrieben.
• unset – Entfernt field aus dem Datensatz, sodass der Leser den Standardwert der Familie sieht. Es wird mit field geschrieben.
• append_unique – Fügt value zur Liste in field hinzu, falls es noch nicht vorhanden ist. Es ist mit field und value geschrieben.
• remove_value – Entfernt jedes Vorkommen von value aus der Liste in field. Es ist mit field und value geschrieben.

• Benennen Sie ein Feld nach Pfad, niemals nach Standort. tags.0 wird abgelehnt. Das heutige dritte Label ist das zweite Label, nachdem Sie den Mod einer anderen Person hochgeladen haben.
• Ein Pfad besteht aus bis zu vier durch Punkte verbundenen Kleinbuchstaben. Alles, was einen Operator enthält, wird abgelehnt.
• append_unique ist derjenige, den sich zwei Mods teilen können. Wenn beide dasselbe Label in die Warteschlange stellen, handelt es sich nicht um einen Konflikt und es verdoppelt sich nicht.

Nur manchmal

Eine Aufzeichnung kann Ihnen sagen, wann es sich lohnt. Fügen Sie einen when neben dem op in einem Paket mit "manifest_version": 2 hinzu:

a presentation_bindings record

{
  "op": "add",
  "id": "my_mod:snowy_cloak",
  "subject": "wool_cloak",
  "kind": "item",
  "slot": "icon",
  "cue": "my_mod:cloak_snowy",
  "when": { "season": { "is": "winter" } }
}

Es gibt keinen Operator und nichts zu berechnen. Alles, was eine Bedingung sagen kann, finden Sie in diesen beiden Tabellen.

Maximal vier Probanden in einem when, zwei Versuche pro Proband. Zwei Versuche zum gleichen Thema bilden ein Intervall: { "day": { "at_least": 10, "at_most": 30 } }.

Welche Familie nimmt was. Jede Familie nimmt die drei, die beim Laden festgelegt wurden. Nur presentation_bindings und effects übernehmen die vier, die sich während des Spiels bewegen, da nur diese beiden neu aufgebaut werden, wenn sich die Welt verändert. Die Nominierung von season an anderer Stelle wird abgelehnt und in der Nachricht steht, welche Themen diese Familie wirklich annimmt.

Der Grund sind die Rettungsaktionen. Ein Datensatz, der über einen Gegenstand, eine Person oder eine Mission entscheidet, muss beim nächsten Laden derselbe Datensatz sein, und eine Bewegungsbedingung ist genau das, was ihn daran hindert.

Ein saisonaler Skin geht auf den Link, nicht auf das Bild. Bringen Sie das Bild nur einmal mit, dann zwei presentation_bindings-Datensätze für sie: einen mit einem when, einen ohne. images, audio und fonts lehnen einen when ohne Diskussion ab.

Zurückgehalten wird nicht abgelehnt. Eine Bedingung, die nicht erfüllt ist, behält ihren Datensatz und der Ladebericht nennt ihn namentlich:

what the game prints back

WITHHELD my_mod:snowy_cloak from my_mod: season is winter, and it is spring

Ein Paket mit fünfzig Saisonrekorden ist jederzeit zu drei Vierteln gehalten. Es ist das Paket, das funktioniert.

Wenn eine bedingte Darstellungszuordnung verweigert wird, zeigt der Bericht die Familie weiterhin wie deklariert an und gibt bound=0 zusammen mit jeder WITHHELD-Zeile aus. meldet das Paket nicht fälschlicherweise als ohne Präsentationsfläche. Wenn keine unbedingte Bindung denselben Slot bereitstellt, wird auch NO_APPLICABLE kind/subject/slot mit der unbeantworteten Bedingung ausgegeben, was bedeutet, dass „in diesem Weltzustand nichts zutrifft“ und nicht „der Datensatz war ungültig“. Testen Sie die Bedingung in der Host- oder Laufzeitspur mit dem entsprechenden Weltstatus, bevor Sie davon ausgehen, dass die Zuordnung abgelehnt wurde.

Zwei Versionen derselben Sache. Bringt zwei add-Datensätze mit derselben ID und unterschiedlichen Bedingungen. Derjenige, dessen Zustand gilt, ist derjenige, der anklagt. Wenn beides zutrifft, wird das zweite als Duplikat abgelehnt. Auf diese Weise werden überlappende Bedingungen gemeldet, anstatt durch die Aktenordnung gelöst zu werden.

Etwas entfernen

remove bedeutet eingestellt, nicht nicht mehr vorhanden. Der Rekord löst sich immer weiter auf und wird markiert: Es wird nichts Neues mehr angeboten, vorrätig gehalten, hergestellt oder von ihm erzeugt, und alles, was ein Spieler bereits hat und der ihn nennt, liest weiterhin genau das, was er immer gelesen hat.

a goods record

{ "op": "remove", "id": "iron_ore" }

vendor_inventories ist die einzige Familie, die den Datensatz entfernt, und zwar nur, weil die Speicherregeln bereits besagen, dass niemand auf diese Zeile zeigt.

Ein remove kann keinen when tragen. Ein Rückzug, den eine Rettung benennen könnte, muss entschieden werden, sonst wird ein Ausweis an einem Abend geklärt und am nächsten nicht.

Eine Entfernung ist für eine Komposition dauerhaft. Ein nachfolgender patch, replace oder zweiter remove, der auf die zurückgezogene ID abzielt, wird abgelehnt, auch wenn ein Warenrückruf den alten Datensatz durch seine dauerhafte Entfernung lösbar hält. Dadurch wird verhindert, dass der Speicherbericht „zurückgezogen“ anzeigt, während ein nachfolgendes Paket dazu führt, dass sich der Datensatz wieder wie bereitgestellt verhält. Fügen Sie eine neue Namespace-ID hinzu, wenn Sie einen neuen Datensatz benötigen. Verlassen Sie sich nicht auf eine Entfernung, gefolgt von einer stillen Auferstehung.

Wenn zwei Mods dasselbe wollen

Beide laden. Jede Änderung wird komponiert, bevor etwas erstellt wird, sodass das Spiel beides sieht.

Gewinnen und die Erlaubnis zu bekommen sind zwei verschiedene Fragen, und das ist das Überraschende daran. Das Spiel berechnet immer, welches Paket es zuletzt schreibt – wenn man es dem Zufall überlässt, würde selbst ein Münzwurf zur Ablehnung führen – und markiert das Paar trotzdem als Kollision, die niemand erklärt hat. Der Offline-Validator lehnt dasselbe Paar ohne Diskussion ab, sodass Sie es vor einem Spieler herausfinden.

supersedes in Ihrem Manifest ist Ihre Art zu sagen, dass Sie es mit Absicht getan haben. Nennen Sie die ID des anderen Pakets und der Konflikt wird zu declared_replacement: registriert, mit Grund und kein Fehler mehr.

Geben Sie Ihrem Paket ein eigenes load_order. Zwei Pakete, die eine Nummer teilen, werden nicht abgelehnt, und dann fällt der Gewinner aus der alphabetischen Reihenfolge der Mod-ID: eine Reihenfolge, die keiner der Autoren gewählt hat und die kein Spieler auf dem Bildschirm lesen kann.

Bilder, Ton, Schrift, Farbe

Eine Datei mitzubringen und sie zu verwenden sind zwei separate Schritte und Sie benötigen beide. Eine Datei, auf die nichts verweist, wird gelesen, geprüft, gemessen und nie angezeigt.

Bringen Sie die Akte mit

Jede Ressourcenfamilie ist ein Dateideskriptor und die von ihm benannten Dateien. Der Deskriptor muss wie seine Familie benannt werden: images.json, audio.json, fonts.json.

where the files go

content/assets/images/
  images.json
  river_guard.png

a images record

[
  {
    "id": "northern_reach:river_guard",
    "file": "river_guard.png",
    "format": "png"
  }
]

Drei Regeln, die beißen:

• Der Header wird überprüft, bevor er von irgendetwas dekodiert wird. format ist das, was die Datei ist, nicht das, was die Erweiterung behauptet.
• Ein Name von file, der .. oder ~ enthält oder mit /, \, res:// oder user:// beginnt, wird für den Namen abgelehnt.
• Eine ID, die nicht aufgelöst wird, erhält einen Platzhalter und eine Warnung, niemals Stille.

Wetten Sie darauf

Auf einem Datensatz, den Sie bei sich tragen, mit einem Feld, das Ihre Bild-ID annimmt:

Auf alles, einschließlich Basisspielinhalten, mit einem presentation_bindings-Datensatz, der das Thema, seinen Typ und seinen Slot benennt:

a presentation_bindings record

[
  {
    "id": "northern_reach:iron_sword_icon",
    "subject": "iron_sword",
    "kind": "item",
    "slot": "icon",
    "cue": "northern_reach:river_guard",
    "alternative_key": "northern_reach_iron_sword_icon_alt"
  }
]

alternative_key ist obligatorisch, wenn ein Slot Informationen enthält: Es ist der Sprachschlüssel, der einem Spieler, der das Bild nicht empfangen kann, dasselbe sagt.

Klang

role ist ein Limit, keine Bezeichnung: Jedes hat seine eigene maximale Dauer, seine eigene Obergrenze dafür, wie viele zusammen spielen, und den Cursor, nach dem ein Spieler sucht.

Ein komprimiertes WAV wird abgelehnt: Für die Dekodierung ist ein Parser erforderlich, und der Parser ist genau das, was Sie vermeiden möchten.

Schriften

covers benennt die Sprachen, für die Ihre Schriftart Glyphen enthält, und der Build weigert sich, sie für alle anderen zu installieren. Ein Zeichen, dem eine Sprache fehlt, scheitert nicht: Zeichnen Sie kleine Quadrate, und der Bildschirm liest sich wie eine halbfertige Übersetzung, mit dem richtigen Text und dem Fehler der Schriftart.

fallback_font ist obligatorisch: Benennen Sie eine andere eigene Schriftart-ID oder eine Systemfamilie (Segoe UI, Noto Sans). sizes ist das, worauf der Glyphen-Cache berechnet wird.

Nur ein Zeichen, niemals eine Sammlung – ein .ttc enthält mehrere und welches ankommt, hängt von einem Index ab, den der Deskriptor nicht tragen kann. Kostenlose Schriftarten mit großer Abdeckung: Google Fonts, Font Squirrel. Überprüfen Sie, ob die Lizenz Ihnen die Weiterverbreitung der Datei erlaubt – Ihr Paket enthält sie.

Farbe

Tokens, niemals eine Szene, ein Skript oder ein Ressourcenpfad. Die Namen sind die des Spiels: bg_deep, bg_mid, bg_button, bg_hover, border, border_hi, text, text_dim, accent, gold. Ein Name, den dieser Build nicht kennt, wird im Protokoll erwähnt, anstatt dort zu stehen und den Anschein zu erwecken, dass er angewendet wird.

a themes record

[
  {
    "id": "northern_reach:dusk",
    "tokens": {
      "bg_deep": { "kind": "colour", "value": "#12131a" },
      "text": { "kind": "colour", "value": "#e8e2d0" },
      "border": { "kind": "colour", "value": "#7f6ab0" }
    },
    "contrast_pairs": [
      { "text": "#e8e2d0", "background": "#12131a" }
    ]
  }
]

contrast_pairs werden bei einem Verhältnis von 4,5 und darunter überprüft, dass das Thema abgelehnt wird. Das WebAIM-Messgerät zeigt Ihnen das Verhältnis eines Paares an, bevor Sie es tragen.

Schalten Sie das Paket aus und die Schnittstelle erhält ihre Farben und Schriften zurück.

Kunst, die sich gut anfühlt

Der Build prüft, ob ein Bild ein Bild ist. Es sagt nichts darüber aus, ob es richtig aussieht, und in einer in Grautönen gezeichneten Welt hört ein helles, fröhliches, hochauflösendes Schwert nicht auf, falsch zu sein, indem es jeder Prüfung standhält. Das ist heute bekannt.

Der vollständige Styleguide ist noch nicht veröffentlicht. Was es bringen wird: die Palette selbst, die Dimensionen, in denen jede Art von Dingen gezeichnet wird, und nebeneinander liegende Beispiele dafür, was in die Welt kommt und was aus ihr herauskommt. Es lohnt sich, darauf zu warten, anstatt zu raten, denn der Fehler, den es verhindert, ist keine abgelehnte Datei: Es ist ein Paket, das perfekt installiert wird und dem Spiel das Gefühl gibt, zwei Spiele zu sein.

Solange es nicht existiert, ist die zuverlässige Methode die, die keine Dokumente benötigt: Legen Sie Ihr Bild neben das Spielbild und schauen Sie sich beide zusammen an.

Ihre Karten

Zeichnen Sie in Gekachelt,, exportieren Sie es nach .tmj und indizieren Sie es nach content/world/maps/maps.json.

a maps record

[
  {
    "id": "northern_reach:river_bend",
    "file": "river_bend.tmj",
    "name_key": "NORTHERN_REACH_RIVER_BEND",
    "world_origin": [4096, 2560],
    "region_id": "northern_reach:lowlands"
  }
]

Ein Link, der Inhalte aus einem anderen Paket – oder dem Basisspiel – nennt, führt dazu, dass das gesamte Layout abgelehnt wird. modding_map_report benennt die Bestimmung und die Regel, die sie abgelehnt hat.

Ihre Missionen

Eine Mission ist eine Reihe von Datensätzen, die in content/narrative/quest_plans nur zusammen einen Sinn ergeben.

a quest_plans record

[
  {
    "kind": "arc",
    "id": "northern_reach:the_long_winter",
    "stages": ["northern_reach:bring_the_grain"]
  },
  {
    "kind": "quest",
    "id": "northern_reach:bring_the_grain",
    "name_key": "northern_reach.quest.bring_the_grain.name",
    "giver": "northern_reach:the_reeve",
    "in_arc": "northern_reach:the_long_winter",
    "objectives": ["northern_reach:gather_grain"],
    "rewards": [
      { "grant": "receive_coin", "coin": 250 }
    ]
  },
  {
    "kind": "objective",
    "id": "northern_reach:gather_grain",
    "quest": "northern_reach:bring_the_grain",
    "goal": "collect_item",
    "target": "northern_reach:winter_grain",
    "count": 40
  },
  {
    "kind": "ending",
    "id": "northern_reach:the_barns_are_full",
    "arc": "northern_reach:the_long_winter",
    "requires": ["northern_reach:bring_the_grain"]
  }
]

• Bei einem Plan geht es um alles oder nichts. Ein falscher Rekord und keiner wird installiert: Die Alternative ist ein Bogen, der auf halbem Weg stoppt und der Spieler das Schwert und nicht den Titel hält.
• Eine Belohnung ist ein grant, niemals ein kind. kind gibt an, um welchen der vier Datensätze es sich handelt. Eine mit kind geschriebene Belohnung liest sich sehr gut und wird abgelehnt.

Überprüfen Sie Ihre mit modding_quest_plan_report.

Ihre Gespräche

Eine Konversation besteht aus drei Arten von Datensätzen in content/narrative/dialogue: dem dialogue_graph, der sie benennt und angibt, in welcher Leiste sie geöffnet wird, den dialogue_node-Balken, bei denen es sich um die Zeilen handelt, und den dialogue_option-Auswahlmöglichkeiten darüber.

Ihre Zeile ist Ihre Zeile, und nichts schreibt sie um. Ein lokales Modell kann eine Frage beantworten, die der Spieler an den Charakter schreibt, und dabei innerhalb dessen bleiben, was Ihre Zeile sagt – und wenn es nicht darin bleiben kann, sagt es, dass es es nicht weiß. Es ist der Spieler, der entscheidet, ob diese Oberfläche überhaupt existiert; Bei ausgeschaltetem Modell sagt die Figur Ihren Satz und stoppt. Die Übersetzung Ihres Witzes stammt wie alles andere, was Sie schreiben, aus den Sprachdateien.

Das Diagramm nennt speaker, und der Auslöser ist vollständig vorhanden. Wenn Sie darauf klicken, fragt jeder Charakter im Spiel diese Familie, welche Gespräche über ihm laufen, sodass Sie dem Schmied etwas zu sagen geben können, ohne den Schmied neu zu definieren.

a dialogue record

[
  {
    "kind": "dialogue_graph",
    "id": "northern_reach:gate_toll",
    "entry": "northern_reach:gate_open",
    "speaker": "gate_warden",
    "name_key": "TALK_PACK_GATE"
  },
  {
    "kind": "dialogue_node",
    "id": "northern_reach:gate_open",
    "graph": "northern_reach:gate_toll",
    "voice": "line",
    "speaker": "gate_warden",
    "line_key": "TALK_PACK_GATE_OPEN"
  }
]

Sie schreiben das Gespräch, niemals die Worte: Jeder Witz ist ein Sprachschlüssel, sodass das gleiche Paket in allen Sprachen gelesen werden kann, die der Spieler hat. Ein Paket mit Prosa wird in die Datei statt auf den Bildschirm zurückgewiesen.

Ein Witz und eine Wahl können jede der Bedingungen beinhalten, und eine Wahl kann Befehle beinhalten. Eine Bedingung entscheidet darüber, ob das Ding dem Spieler überhaupt gezeigt wird; Ein Befehl ist das, was passiert, wenn er ihn annimmt.

• Eine Konversation, die etwas benennt, was dieser Build nicht kann, wird nie geöffnet. Nicht die Auswahl, die sie verwendet: die gesamte Konversation vor ihrer ersten Zeile. Eine Diskussion, die bei der dritten Option endet, hat dem Spieler bereits die Münzen genommen.
• Nichts bewegt sich mehr als da ist. Fragen Sie zuerst mit has_coin oder has_item; Ein Paket, das es vergisst, kann den Spieler nicht auf minus vierzig Münzen bringen, weil niemand eine Schuld angenommen hat und kein Bildschirm eine erklärt.
• Jeder Witz braucht einen Ausweg. Ein Witz, zu dem ein Spieler gelangen und dem er nicht entkommen kann, wird abgelehnt, wenn die Grafik geladen wird.

Überprüfen Sie Ihre mit modding_dialogue_report.

Deine Szenen

Eine Szene ist der einzige Inhaltstyp, der dem Spieler die Kontrolle entzieht, und daher ist sie auch die einzige mit einer Endregel. Die Szenen leben in content/narrative/scenes und jede benennt einen where, den Ort, an dem sie abgespielt wird. Betreten Sie diesen Ort und die Szene beginnt.

a scenes record

[
  {
    "id": "northern_reach:the_morning_after",
    "where": "northern_reach:waystation",
    "beats": [
      { "beat": "fade_in", "seconds": 1.5 },
      { "beat": "lock_player" },
      { "beat": "say", "actor": "gate_warden", "line_key": "SCENE_PACK_GREETING" },
      { "beat": "wait", "seconds": 1.0 },
      { "beat": "unlock_player" }
    ]
  }
]

• Eine Szene, die Kontrollen entfernt, muss sie zurückgeben. Eine Sequenz, die ohne unlock_player endet, wird abgelehnt, da die Alternative darin besteht, einen Raum zu schaffen, den der Spieler nur durch Beenden des Spiels verlassen kann.
• Zeilen folgen der Reihe nach und es wird eine Blockierungslinie erwartet. Dies macht eine Szene zu einer Szene und nicht zu einer Liste von Dingen, die auf einmal passieren.

Überprüfen Sie Ihre mit modding_scene_report.

Deine Screenshots

Das Layout eines Bildschirms gibt Aufschluss darüber, welche Abschnitte sich in welchem ​​Bereich eines Bildschirms befinden, über den das Spiel bereits verfügt, und in welcher Reihenfolge. Es legt die Teile dar, die dieser Build zeichnet. Er kann keinen hinzufügen, weil ein Abschnitt, den niemand geschrieben hat, nichts zu zeichnen hat.

Die Bestimmungen befinden sich in content/ui/screens. Die Familien, eine nach der anderen verfügt über Felder und einen Datensatz zum Kopieren.

Überprüfen Sie Ihre mit modding_screen_report.

Nichts erschien

Lesen Sie zuerst den Status auf dem Mod-Bildschirm. Fast jeder Staat benennt das Problem offen, auf der Linie, und auch der häufigste Fehler von allen: der, der einst ganz oben auf dieser Liste stand.

Die Familie fehlt in content_types. Sie schreiben goods.json, vergessen "goods" in der Manifestliste und der Ordner wird nie geöffnet: Es wird nichts abgelehnt, da nichts gelesen wurde. Das Paket wird leer geladen. Jetzt erfahren Sie auf dem Bildschirm, welche Datei durchlaufen wurde und was hinzugefügt werden muss:

what the game prints back

content/economy/goods/goods.json was not read — add "goods" to content_types in mod.json

Der Offline-Validator gibt denselben Satz aus, sodass die beiden nicht anderer Meinung sein können. Gehen Sie diese Liste nur durch, wenn in der Zeile „geladen“ steht und keine ungelesenen Dateien aufgeführt sind. Die Reihenfolge richtet sich danach, wie oft jeder der Täter ist.

Berichte geben einem nie Rätsel auf. Ein abgelehnter Datensatz wird benannt, was daran falsch war und normalerweise mit einem Code – siehe Jeder Diagnosecode.

Es ist aufgetaucht und es ist falsch

Der schwierigste Fall, da überhaupt nichts gemeldet wird. Zwei Dinge bestehen jeder Prüfung und geben Ihnen dennoch eine Aufzeichnung, die Sie nicht geschrieben haben.

Ein Feld, das Sie ausgelassen haben, ist kein Fehler, sondern ein Standardwert. Das Schema jeder Familie gibt an, ohne welche Felder ein Datensatz nicht installiert werden kann, und für fast alle Familien ist diese Liste kurz. goods erfordert genau eines: id. Lassen Sie base_price weg und es ist 1. Lassen Sie weight weg und es ist 1,0. Wenn Sie category weglassen, handelt es sich bei der Ware um einen Rohstoff. Nichts alarmiert Sie, denn es ist nichts falsch: Sie haben um eine Ware gebeten und eine bekommen.

Sogar ein Wert, der nicht zur Auswahl steht, ist ein Standardwert. Der Leser gibt vor der Suche alle Großbuchstaben ein, sodass manufactured und MANUFACTURED den gleichen Wert haben und Großschreibung nie das Problem ist: Beginnen Sie nicht damit, Dateien dafür neu zu schreiben. Das Problem ist MANUFACTURED_GOODS: Es ist kein Mitglied und wird daher zu RAW_MATERIAL. SLOW für einen decay_tier wird zu ETERNAL. Die Platte wird installiert, auf dem Bildschirm wird angezeigt, dass sie angewendet wurde, und Ihre Kerze hat den Preis und die Vergänglichkeit von etwas anderem.

Nichts im Spiel sagt das, weil es nichts zu sagen gibt: Das Feld wird als String deklariert, und ein falsch geschriebener String ist immer noch ein String. Der Validator ist der einzige Ort, an dem Sie es mitnehmen können, und jetzt nimmt es es:

typed into the debug console

$ python tools/quality/validate_mod_data.py --root mods/northern_reach
WARN: northern_reach:goods:goods.json#1: category is "MANUFACTURED_GOODS",
  which is not one of RAW_MATERIAL, MANUFACTURED, CONSUMABLE, AMMUNITION,
  EQUIPMENT. It loads as RAW_MATERIAL.
  ERROR=0 WARN=1

Eine Warnung und kein Fehler, da der Datensatz tatsächlich geladen wird und eine Ablehnung jetzt Pakete zerstören würde, die bereits funktionieren. --strict verwandelt es in einen Fehler und ist der Grund dafür, dass Sie --strict vor dem Posten ausführen.

Ein Feld, das Sie weggelassen haben, bleibt stumm, und das kann nicht übernommen werden: Das Weglassen von category und das Schreiben von RAW_MATERIAL sind dieselbe Anforderung. Daher markieren die Feldtabellen in Die Familien, eine nach der anderen Erforderlich und geben die Wertespalte als die Form an, die der Lader überprüft. Wenn ein Datensatz geladen wird und sich wie etwas anderes verhält, vergleichen Sie zunächst Ihre Felder mit dieser Tabelle: Sie suchen nach einem Feld, das Sie nicht geschrieben haben, oder nach einem Wort, das der Lader nicht erkannt hat.

Jede Familie

Ein Ordner und ein Bericht pro Familie. Die Statusspalte wird am Build gemessen, es handelt sich also nie um ein Versprechen, das das Spiel nicht hält. Was es ist ist nur die Eröffnungszeile, so dass die Tabelle etwas bleibt, durch das Sie mit Ihrem Auge scrollen können; Die vollständige Beschreibung jeder Familie mit ihren Feldern und einem zu kopierenden Datensatz ist ihr Eintrag in Die Familien, eine nach der anderen.

• Out of the Box – veröffentlichtes Formular, das Spiel installiert Ihre Dateien, es gibt ein Beispiel und Ihre IDs überleben ein Speichern und Neuladen.
• Geprüft, noch nichts verbraucht es — der Loader liest und prüft die Familie, aber keine spielerorientierte Paketoberfläche verbraucht sie. Audio- und Schriftpakete gehören in diese Stufe: Ein sauberer Bericht lässt kein stummes Signal und keine ungenutzte Schrift im Spiel erscheinen.
• Überprüft, noch nicht installiert – das Spiel erkennt die Familie und überprüft Ihre Datei, und nichts fügt sie in ein laufendes Spiel ein. Ein Paket, das darauf abzielt, besteht alle Prüfungen und lädt nichts. Es steht mit Absicht auf der Seite: Die Alternative wäre, dass jemand einen Abend dort verbringt, ohne jemals zu merken, dass er nichts falsch gemacht hat.

Vollständig entschieden, ohne Familie, die sie trägt, sodass kein Poster sie fragen kann:

Das ist keine Verschwendung. Was ein Mod niemals tun kann ist diese Liste.

Die Familien, eine nach der anderen

Jede Familie kennt den Build, was er akzeptiert, und einen Datensatz, den Sie kopieren können.

• Die Pflichtfelder sind diejenigen Felder, ohne die ein Datensatz nicht installiert werden kann.
• Die Wertespalte ist die Form, die der Lader überprüft, kein Hinweis.
• Wenn eine Familie dies angibt, wird ein Feld, das die Tabelle nicht benennt, zusammen mit dem Datensatz, in dem es sich befindet, abgelehnt. Ein Tippfehler in einem Feldnamen bedeutet, dass ein Datensatz nicht geladen wird, und im Familienbericht wird dies namentlich angegeben.

In jedem Eintrag steht auch, was mit einem Save-the-Day passiert, wenn ein Spieler Sie deinstalliert:

Hier ist nichts handgeschrieben. Die Felder stammen aus dem veröffentlichten Schema jeder Familie. Jedes Beispiel ist eines der Pakete, die das Test-Array des Frameworks gegen den Loader dreht, wieder unter den Namespace northern_reach stellt und beim Aufrufen dieser Seite erneut anhand seines Musters überprüft: Ein Beispiel, das das Spiel ablehnen würde, führt dazu, dass der Build fehlschlägt.

Die Welt und die Orte, die sie enthält

5 Familien: buildings, caravans, maps, pois, world_generation.

buildings

Definitionen von Gebäuden und Dienstleistungen der Siedlung: Bezeichnung, Farbe, Rolle und eine wiederverwendete Innenausstattung.

• Status Einsatzbereit
• Reist Der Service eines Gebäudes
• Ordner content/world/buildings
• Für das id-Feld weitergeleitete Datensätze
• Bericht modding_building_report
• Wenn ein Spieler Sie deinstalliert substitute_placeholder. Eine Siedlung mit einem Loch, in dem ein Aufschlag stattfand, ist unspielbar; Ein sichtbar fehlendes Gebäude wird ausgelesen und wiederhergestellt.

Felder. Ein Feld, das diese Tabelle nicht benennt, wird mit dem Datensatz abgelehnt.

In einer Datei namens buildings.json oder einem beliebigen Namen .json in diesem Ordner:

a buildings record, under content/world/buildings

[
  {
    "id": "northern_reach:guildhall",
    "label": "Guild Hall",
    "role": "reeve",
    "color": {
      "r": 0.4,
      "g": 0.34,
      "b": 0.26
    },
    "interior_service": "moot_hall"
  }
]

caravans

Handelsrouten, die eine Karawane zurücklegt: wo sie abfährt, wohin sie geht, was sie mitbringt, wie gut sie begleitet wird und wie schnell sie geht.

• Status Einsatzbereit
• Ordner content/logistics/caravans
• Für das id-Feld weitergeleitete Datensätze
• Bericht modding_caravan_report
• Wenn ein Spieler Sie deinstalliert preserve_inert_reference. Eine Route, deren Paket verschwunden ist, behält ihren Namen und trägt nichts. Das Ersetzen eines Ziels würde die Waren eines Spielers an einen Ort schicken, den er nie akzeptiert hätte.

Felder. Ein Feld, das diese Tabelle nicht benennt, wird mit dem Datensatz abgelehnt.

In einer Datei namens caravans.json oder einem beliebigen Namen .json in diesem Ordner:

a caravans record, under content/logistics/caravans

[
  {
    "id": "northern_reach:salt_road_run",
    "display_name": "Salt Road Run",
    "origin_settlement_id": "valdmere",
    "destination_settlement_id": "old_seat",
    "cargo_type": "salt",
    "cargo_value": 240,
    "guard_strength": "light",
    "daily_progress": 0.08,
    "initial_spawn_offset_days": 3
  }
]

maps

Anordnungen, die ein Paket in Tiled zeichnet, benannt nach ID: der Datei, wo sie sich auf der Welt befindet und dem Sprachschlüssel, unter dem sie bekannt ist. Der Index ist der Datensatz; Die Anordnung daneben wird als Daten und niemals als Ressource gelesen, in kanonische Form normalisiert, mit dem veröffentlichten Bausatz verglichen und zusammengestellt, bevor etwas platziert wird. Ein abgelehntes Layout platziert überhaupt nichts, da die Hälfte der Karte eine Region ist, die der Spieler betritt, ohne dass er wissen kann, welche Hälfte angekommen ist.

• Status Einsatzbereit
• Ordner content/world/maps
• Für das id-Feld weitergeleitete Datensätze
• Bericht modding_map_report
• Wenn ein Spieler Sie deinstalliert drop_optional_presentation. Keine Rettung nennt eine Disposition. Eine Speicherung benennt den Punkt von Interesse, um den ein Layout verschoben wurde, und dieser Datensatz behält seine Koordinaten, sodass eine zurückgezogene Karte das Layout und niemals den Inhalt kostet. Wenn man es fallen lässt, kehrt die Welt zu dem zurück, was ihre Aufzeichnungen sagen, anstatt eine Position einzunehmen, die niemand mehr vorgibt.

Felder. Ein Feld, das diese Tabelle nicht benennt, wird mit dem Datensatz abgelehnt.

In einer Datei namens maps.json oder einem beliebigen Namen .json in diesem Ordner:

a maps record, under content/world/maps

[
  {
    "id": "northern_reach:river_bend",
    "file": "river_bend.tmj",
    "name_key": "MAP_RIVER_BEND",
    "world_origin": [
      4096,
      2560
    ],
    "region_id": "northern_reach:lowlands"
  }
]

pois

Durch Koordinaten auf der handgeschriebenen Weltkarte platzierte Sehenswürdigkeiten.

• Status Einsatzbereit
• Route nach Ein Ort auf der Karte
• Ordner content/world/pois
• Für das id-Feld weitergeleitete Datensätze
• Bericht modding_poi_report
• Wenn ein Spieler Sie deinstalliert preserve_inert_reference. Ein entdeckter Ort bleibt entdeckt. Missionen und Reisegeschichte deuten auf die Identität hin.

Felder. Ein Feld, das diese Tabelle nicht benennt, wird mit dem Datensatz abgelehnt.

In einer Datei namens pois.json oder einem beliebigen Namen .json in diesem Ordner:

a pois record, under content/world/pois

[
  {
    "id": "northern_reach:drowned_mile",
    "kind": "RUINS",
    "display_name": "The Drowned Mile",
    "description": "A stretch of road the river took back. The milestones still stand, chest deep.",
    "world_position": {
      "x": 0.0,
      "y": 0.0
    },
    "discovery_radius": 3.0,
    "one_time_loot": true,
    "morale_modifier": -1,
    "awareness_modifier": 0.05,
    "narrative_significance_key": "POI_DROWNED_MILE_LORE"
  }
]

world_generation

Generierungsprofile, die nur aus Daten bestehen: gewichtete Auswahl von Biom und Standort, Eigentum des Wirts.

• Status Einsatzbereit
• Ordner content/world/generation
• Für das id-Feld weitergeleitete Datensätze
• Melde nichts von ihm; modding_preflight_report kümmert sich darum
• Wenn ein Spieler Sie deinstalliert preserve_inert_reference. Beim Speichern wird die ID des ausgewählten Profils aufgezeichnet. Wenn das Paket fehlt, ist es sicherer, diese ID beizubehalten und zu melden, als das Spiel stillschweigend mit der Basisspielkarte neu zu erstellen.

Felder. Ein Feld, das diese Tabelle nicht benennt, wird mit dem Datensatz abgelehnt.

In einer Datei namens profiles.json oder einem beliebigen Namen .json in diesem Ordner:

a world_generation record, under content/world/generation

[
  {
    "kind": "generation_profile",
    "id": "northern_reach:ashen_reach",
    "stream": "northern_reach:world_stream",
    "tables": {
      "biomes": [
        {
          "id": "plains",
          "weight": 60
        },
        {
          "id": "forest",
          "weight": 30
        },
        {
          "id": "hills",
          "weight": 10
        }
      ],
      "settlements": [
        {
          "id": "northern_reach:hamlet",
          "weight": 100
        }
      ],
      "buildings": [
        {
          "id": "northern_reach:longhouse",
          "weight": 100
        }
      ],
      "pois": [
        {
          "id": "northern_reach:standing_stone",
          "weight": 100
        }
      ]
    }
  }
]

Menschen, Familien und was sie tun können

8 Familien: enemy_archetypes, enemy_variants, group_archetypes, mercenary_templates, noble_houses, npc_definitions, perks, relationships.

enemy_archetypes

Arten von Feinden, die die strategische Ebene kennt: Rang, welche Varianten sie einsetzen, wo sie lagern, wie groß die Garnison ist und wie oft sie überfallen.

• Status Einsatzbereit
• Ordner content/threat/enemy_archetypes
• Für das id-Feld weitergeleitete Datensätze
• Bericht modding_enemy_archetype_report
• Wenn ein Spieler Sie deinstalliert preserve_inert_reference. Ein Lager weist immer noch darauf hin, was es begründet hat. Ein Austausch würde stillschweigend verändern, was eine Siedlung belagert; Benennung der Abwesenheit, die wir lesen.

Felder. Ein Feld, das diese Tabelle nicht benennt, wird mit dem Datensatz abgelehnt.

In einer Datei namens enemy_archetypes.json oder einem beliebigen Namen .json in diesem Ordner:

a enemy_archetypes record, under content/threat/enemy_archetypes

[
  {
    "id": "northern_reach:salt_reavers",
    "display_name": "Salt Reavers",
    "description": "Coastal raiders who winter inland and burn what they cannot carry.",
    "tier": 2,
    "corruption_chance": 0.1,
    "preferred_camp_biomes": [
      "marsh",
      "coast"
    ],
    "camp_count": 3,
    "garrison_min": 8,
    "garrison_max": 16,
    "aggression": 0.4,
    "raid_cooldown_days": 5,
    "sortie_size_min": 4,
    "sortie_size_max": 9,
    "target_preferences": [
      "caravan",
      "settlement"
    ],
    "camp_glyph": "tent"
  }
]

enemy_variants

Statistikblöcke für einen feindlichen Körpertyp auf dem Spielfeld: Klasse, Rang, die fünf Attribute und die IDs der Waffe, der Nebenhand und des Schildes, die er trägt.

• Status Einsatzbereit
• Ordner content/combat/enemy_variants
• Für das id-Feld weitergeleitete Datensätze
• Bericht modding_enemy_variant_report
• Wenn ein Spieler Sie deinstalliert substitute_placeholder. Ein Körper, der sich bereits auf dem Spielfeld befindet und keinen Statistikblock hat, kann nicht bekämpft werden. Ein stabiler Ersatz, über den die Engine verfügt, sorgt dafür, dass der Kampf lösbar bleibt und gleichzeitig die ursprüngliche ID erhalten bleibt.

Felder. Ein Feld, das diese Tabelle nicht benennt, wird mit dem Datensatz abgelehnt.

In einer Datei namens enemy_variants.json oder einem beliebigen Namen .json in diesem Ordner:

a enemy_variants record, under content/combat/enemy_variants

[
  {
    "id": "northern_reach:salt_reaver_archer",
    "archetype_id": "northern_reach:salt_reavers",
    "display_name": "Salt Reaver Archer",
    "variant_class": "archer",
    "tier": 2,
    "strength": 3.0,
    "agility": 5.0,
    "constitution": 3.5,
    "aim": 6.0,
    "will": 2.5,
    "main_weapon_id": "short_bow",
    "ai_behavior": "keeps distance and gives ground rather than trade blows"
  }
]

group_archetypes

Einstellbare Strategieparameter für eine auf der Weltkarte lebende Gruppe: Warnradius, Zielpräferenz, Mitgliederzahl, Nachschub- und Rückzugsschwellen.

• Status Einsatzbereit
• Ordner content/strategic/group_archetypes
• Für das id-Feld weitergeleitete Datensätze
• Bericht modding_group_archetype_report
• Wenn ein Spieler Sie deinstalliert substitute_placeholder. Strategische Intelligenz muss irgendwo einen Schwellenwert erkennen. Es reagiert auf einen Standardwert der Engine, auf den diese Familie bereits zurückgreift.

Felder. Ein Feld, das diese Tabelle nicht benennt, wird mit dem Datensatz abgelehnt.

In einer Datei namens group_archetypes.json oder einem beliebigen Namen .json in diesem Ordner:

a group_archetypes record, under content/strategic/group_archetypes

[
  {
    "id": "northern_reach:pilgrim_column",
    "display_name": "Pilgrim Column",
    "kind": "nomad",
    "faction_id": "",
    "target_preference": "wandering",
    "aggression": "avoid_player",
    "alarm_radius_px": 300.0,
    "night_aggression_multiplier": 0.5,
    "min_members": 6,
    "max_members": 14,
    "behavior_profile_mix": [
      "coward",
      "balanced"
    ],
    "provisions_max": 6,
    "retreat_hp_pct": 0.6
  }
]

mercenary_templates

Anheuerbare Söldnermodelle: Name, Klasse, Herkunft, anfängliche Gesundheit und Moral, Anheuerkosten und Tag ihres ersten Erscheinens.

• Status Einsatzbereit
• Ordner content/character/mercenaries
• Für das id-Feld weitergeleitete Datensätze
• Bericht modding_mercenary_report
• Wenn ein Spieler Sie deinstalliert preserve_inert_reference. Bereits angeworbene Söldner leben als Einheit in der Rettung; Lediglich die Wirtshausliste verliert ihre Vorlage. Die ID bleibt benannt, so dass die Herkunft des Organischen weiterhin ablesbar ist.

Felder. Ein Feld, das diese Tabelle nicht benennt, wird mit dem Datensatz abgelehnt.

In einer Datei namens mercenaries.json oder einem beliebigen Namen .json in diesem Ordner:

a mercenary_templates record, under content/character/mercenaries

[
  {
    "id": "northern_reach:ditchwater_sapper",
    "display_name": "Ditchwater Sapper",
    "class_id": "skirmisher",
    "background": "Dug siege trenches for whoever was paying, and stopped asking which side it was.",
    "hp_max": 24,
    "morale_start": 70,
    "hire_cost": 180,
    "available_from_day": 6
  }
]

noble_houses

Ausgangsdaten eines Adelshauses: der Herr, der Erbe, welche Siedlungen dem Haus unterstehen und wer als Rivale oder Verbündeter gilt.

• Status Einsatzbereit
• Ordner content/politics/noble_houses
• Für das id-Feld weitergeleitete Datensätze
• Bericht modding_noble_house_report
• Wenn ein Spieler Sie deinstalliert preserve_inert_reference. Die Wertschätzung eines Spielers für ein Haus wird auf seinem Ausweis vermerkt. Eines zu ersetzen würde umschreiben, ohne den Loyalen etwas zu sagen.

Felder. Ein Feld, das diese Tabelle nicht benennt, wird mit dem Datensatz abgelehnt.

In einer Datei namens noble_houses.json oder einem beliebigen Namen .json in diesem Ordner:

a noble_houses record, under content/politics/noble_houses

[
  {
    "id": "northern_reach:house_tidewatch",
    "display_name_key": "VALID_NOBLE_HOUSE_MOD_HOUSE_TIDEWATCH",
    "display_name": "House Tidewatch",
    "strength": "reduced",
    "alignment": "isolationist",
    "corruption_risk": "moderate",
    "is_minor": true,
    "lord_state": "ailing",
    "captain_initial_stance": "suspicious",
    "captain_initial_opinion": 35,
    "apex_ambition": 20,
    "apex_claim_legitimacy": 15,
    "house_power_base": 25,
    "lore_summary": "Kept the coast road open for two hundred years and was paid in salt for it."
  }
]

npc_definitions

Definitionen benannter NPCs.

• Status Einsatzbereit
• Pathed in Ein Händler, der es besitzt
• Ordner content/narrative/npcs
• Für das id-Feld weitergeleitete Datensätze
• Bericht modding_npc_report
• Wenn ein Spieler Sie deinstalliert preserve_inert_reference. Eine Person mit einem Namen, an den sich die Welt erinnert, ist nicht dasselbe wie jemand, der nie existiert hat, und Berichte deuten auf die Identität hin.

Felder. Ein Feld, das diese Tabelle nicht benennt, wird mit dem Datensatz abgelehnt.

In einer Datei namens npcs.json oder einem beliebigen Namen .json in diesem Ordner:

a npc_definitions record, under content/narrative/npcs

[
  {
    "id": "northern_reach:wandering_herbalist",
    "display_name": "Wandering Herbalist",
    "title": "Travelling Healer",
    "role": "NONE",
    "settlement_id": "old_seat",
    "is_vendor": true,
    "vendor_inventory_id": "northern_reach:herb_stall",
    "personality_tags": [
      "gentle",
      "secretive"
    ]
  }
]

perks

Deklarative Berechtigungen: Trigger und Effekte, ohne dass ein Handler im Code geschrieben ist.

• Status Einsatzbereit
• Ordner content/character/perks
• Für das id-Feld weitergeleitete Datensätze
• Bericht modding_perk_report
• Wenn ein Spieler Sie deinstalliert preserve_inert_reference. Ein Charakter behält, was er verdient hat. Durch das Entfernen einer Funktion wird ein Gebäude, in dem der Spieler ein Spiel verbracht hat, stillschweigend neu geschrieben.

Felder. Ein Feld, das diese Tabelle nicht benennt, wird mit dem Datensatz abgelehnt.

In einer Datei namens perks.json oder einem beliebigen Namen .json in diesem Ordner:

a perks record, under content/character/perks

[
  {
    "id": "northern_reach:stoneskin",
    "skill": "armour",
    "name_key": "PERK_STONESKIN",
    "description_key": "PERK_STONESKIN_DESC",
    "kind": "lateral",
    "side": "L",
    "col": 0,
    "row": 7,
    "level": 100,
    "parents": [],
    "icon": "northern_reach:stoneskin_icon"
  }
]

relationships

Partnermuster, Richtlinien für begrenzte Beziehungen, Einstellungsbedingungen und deklarative Bindungen.

• Status Einsatzbereit
• Ordner content/companion/relationships
• Für das id-Feld weitergeleitete Datensätze
• Melde nichts von ihm; modding_preflight_report kümmert sich darum
• Wenn ein Spieler Sie deinstalliert preserve_inert_reference. Der Kern der Beziehung eines Partners bleibt an seiner Identität hängen, sodass das Entfernen eines Pakets nicht stillschweigend Vertrauen, Groll oder die Geschichte der Verlassenheit löschen kann.

Felder. Diese Familie enthält mehr als einen Datensatztyp und jeder Typ wird anhand seiner eigenen Liste überprüft. Ein Feld, das in dieser Tabelle nicht benannt ist, wird zusammen mit dem Datensatz abgelehnt.

Ein Datensatz mit kind: bond:

Ein Datensatz mit kind: companion_template:

Ein Datensatz mit kind: recruit_terms:

Ein Datensatz mit kind: relationship_policy:

In einer Datei namens relationships.json oder einem beliebigen Namen .json in diesem Ordner:

a relationships record, under content/companion/relationships

[
  {
    "id": "northern_reach:marsh_policy",
    "kind": "relationship_policy",
    "relation_kinds": [
      "comrade",
      "feud",
      "sworn"
    ],
    "bounds": {
      "floor": -100,
      "ceiling": 100
    },
    "bands": [
      {
        "name": "hostile",
        "from": -100,
        "to": -61
      },
      {
        "name": "cold",
        "from": -60,
        "to": -31
      },
      {
        "name": "wary",
        "from": -30,
        "to": -11
      },
      {
        "name": "neutral",
        "from": -10,
        "to": 10
      },
      {
        "name": "warm",
        "from": 11,
        "to": 40
      },
      {
        "name": "trusted",
        "from": 41,
        "to": 70
      },
      {
        "name": "devoted",
        "from": 71,
        "to": 100
      }
    ],
    "max_change_per_event": 12,
    "decay_per_day": 1
  },
  {
    "id": "northern_reach:hire_terms",
    "kind": "recruit_terms",
    "means": "hire",
    "cost": 240
  },
  {
    "id": "northern_reach:marsh_companion",
    "kind": "companion_template",
    "unit": "northern_reach:marsh_unit",
    "recruit": "northern_reach:hire_terms",
    "loyalty": "northern_reach:marsh_policy",
    "starting_regard": 8,
    "leave_below": -60
  }
]

Dinge, Handel und die Zahlen hinter einem Zusammenstoß

5 Familien: combat_balance, goods, items, recipes, vendor_inventories.

combat_balance

Begrenzte Kampfbalancewerte, die bestehende Solver-Parameter anpassen, ohne Regeln, Operationen oder Mechaniken hinzuzufügen.

• Status Einsatzbereit
• Ordner content/combat/balance
• Für das id-Feld weitergeleitete Datensätze
• Bericht modding_combat_balance_report
• Wenn ein Spieler Sie deinstalliert substitute_placeholder. Bei dem Kontostand handelt es sich um Definitionsdaten, die vom Host gespeichert werden, nicht um das Inventar des Spielers. Wenn sein Paket fehlt, reagiert das kanonische und stabile Balancing und das anschließende Laden bringt keine zweite Möglichkeit mit sich, die Anpassungen zu speichern.

Felder. Ein Feld, das diese Tabelle nicht benennt, wird mit dem Datensatz abgelehnt.

In einer Datei namens balance.json oder einem beliebigen Namen .json in diesem Ordner:

a combat_balance record, under content/combat/balance

[
  {
    "id": "northern_reach:coastal_balance",
    "values": {
      "zone_penalty_head": 22,
      "crit_damage_mult": 1.75,
      "friendly_fire_redirect_chance": 0.2
    }
  }
]

goods

Marktfähige Güter und ihre wirtschaftlichen Eigenschaften.

• Status Einsatzbereit
• Reist [Ein Gut zum Verkaufen](#ein Gut zum Verkaufen)
• Ordner content/economy/goods
• Für das id-Feld weitergeleitete Datensätze
• Bericht modding_goods_report
• Wenn ein Spieler Sie deinstalliert preserve_inert_reference. Eine Escort Dame, die eine Ware benennt, die niemand liefert, ist ehrlich. Sie zu ersetzen würde stillschweigend ändern, was ein Spieler hat.

Felder. Ein Feld, das diese Tabelle nicht benennt, wird mit dem Datensatz abgelehnt.

In einer Datei namens goods.json oder einem beliebigen Namen .json in diesem Ordner:

a goods record, under content/economy/goods

[
  {
    "id": "northern_reach:spiced_wine",
    "display_name": "Spiced Wine",
    "category": "consumable",
    "decay_tier": "preserved",
    "base_price": 12,
    "weight": 0.5,
    "tags": [
      "luxury",
      "drink"
    ]
  }
]

items

Inventargegenstände, einschließlich Waffen und Rüstungen.

• Status Einsatzbereit
• Gesucht in Ein Gegenstand zum Tragen
• Ordner content/inventory/items
• Für das id-Feld weitergeleitete Datensätze
• Bericht modding_items_report
• Wenn ein Spieler Sie deinstalliert preserve_inert_reference. Das Repository benennt ständig, was darin enthalten war, und das ist der einzige Grund, warum es ihnen bei einer Neuinstallation zurückgegeben wird.

Felder. Ein Feld, das diese Tabelle nicht benennt, wird mit dem Datensatz abgelehnt.

In einer Datei namens items.json oder einem beliebigen Namen .json in diesem Ordner:

a items record, under content/inventory/items

[
  {
    "id": "northern_reach:spiced_wine_bottle",
    "display_name": "Bottle of Spiced Wine",
    "category": "CONSUMABLE",
    "rarity": "UNCOMMON",
    "weight": 0.5,
    "max_stack": 10,
    "base_value": 14,
    "sellable": true,
    "tags": [
      "drink",
      "luxury"
    ]
  }
]

recipes

Bastelrezepte: Was wird verzehrt, was kommt dabei heraus, wo wird es hergestellt, wie viel kostet es und wie wahrscheinlich ist es, dass es schlecht wird.

• Status Einsatzbereit
• Ordner content/economy/recipes
• Für das id-Feld weitergeleitete Datensätze
• Melde nichts von ihm; modding_preflight_report kümmert sich darum
• Wenn ein Spieler Sie deinstalliert preserve_inert_reference. Nichts in einer Sicherung benennt ein Rezept: Eine Sicherung benennt das Objekt, das ein Prozess erzeugt hat, und die Familie dieses Objekts ist dafür verantwortlich. Was ein zurückgezogenes Rezept hinterlässt, ist eine Station, die etwas nicht mehr anbietet, was gemeldet und nicht repariert wird, denn die Erfindung eines Ersatzrezepts würde dem Spieler einen Gegenstand auf die Hand geben, den es in keinem Paket gibt.

Felder. Ein Feld, das diese Tabelle nicht benennt, wird mit dem Datensatz abgelehnt.

In einer Datei namens recipes.json oder einem beliebigen Namen .json in diesem Ordner:

a recipes record, under content/economy/recipes

[
  {
    "id": "northern_reach:salt_cured_ration",
    "display_name_key": "VALID_RECIPE_MOD_SALT_CURED_RATION",
    "recipe_kind": "normal",
    "inputs": {
      "salt": 1,
      "dried_meat": 2
    },
    "output_item_id": "northern_reach:salt_cured_ration",
    "output_count": 3,
    "requires_service": "kitchen",
    "gold_cost": 4,
    "time_cost_minutes": 20,
    "success_chance": 0.95,
    "failure_policy": "lose_fuel",
    "quality_policy": "material_inputs",
    "legality": "legal"
  }
]

vendor_inventories

Händler-Liefertabellen.

• Status Einsatzbereit
• Pathed in Ein Händler, der es besitzt
• Ordner content/world/vendor_inventories
• Für das id-Feld weitergeleitete Datensätze
• Bericht modding_vendor_inventory_report
• Wenn ein Spieler Sie deinstalliert drop_optional_presentation. Bestände werden regeneriert. Ein Händler mit einem leeren Regal ist ein lesbarer Zustand und die Zeile weist auf nichts anderes hin.

Felder. Ein Feld, das diese Tabelle nicht benennt, wird mit dem Datensatz abgelehnt.

In einer Datei namens vendors.json oder einem beliebigen Namen .json in diesem Ordner:

a vendor_inventories record, under content/world/vendor_inventories

[
  {
    "id": "northern_reach:herb_stall",
    "display_name": "Herbalist's Stall",
    "npc_id": "northern_reach:wandering_herbalist",
    "global_price_multiplier": 1.0,
    "buyback_rate": 0.4,
    "entries": [
      {
        "item_id": "northern_reach:spiced_wine_bottle",
        "kind": "consumable",
        "daily_stock": 3,
        "price_multiplier": 1.1,
        "restock_days": 2,
        "min_standing": 0
      }
    ]
  }
]

Geschichte, Missionen und die Wörter, die ein Spieler liest

9 Familien: dialogue, locales, lore, mr_lines, progress, quest_metadata, quest_plans, quests, scenes.

dialogue

Gespräche als Aufzeichnungen: die Grafik, ihre Witze und die darauf liegenden Entscheidungen. Drei Typen teilen sich die Familie und kind sagt, welcher. Ein Paket schreibt die Konversation, niemals die Wörter – jeder Tastendruck ist eine Sprachtaste – und jede Bedingung und jede Konsequenz ist eine Prüfung oder ein Befehl, den dieser Build bereits ausführt.

• Status Einsatzbereit
• Ordner content/narrative/dialogue
• Für das id-Feld weitergeleitete Datensätze
• Bericht modding_dialogue_report
• Wenn ein Spieler Sie deinstalliert preserve_inert_reference. Bei einem Speichervorgang wird aufgezeichnet, was eine Konversation bewirkt hat – eine Mission, die sich bewegt hat, ein Objekt, das den Besitzer gewechselt hat, eine Wahrheit, die man erfahren hat –, niemals die Konversation selbst, die in dem Moment beendet ist, in dem Sie etwas schreiben. Wenn das Paket verschwindet, bleiben die Konsequenzen bestehen, da sie nie Teil des Gesprächs waren und das Gespräch einfach nicht mehr angeboten wird. Es zu ersetzen würde einem Charakter Worte in den Mund legen, die sein Autor nie geschrieben hat.

Felder. Diese Familie enthält mehr als einen Datensatztyp und jeder Typ wird anhand seiner eigenen Liste überprüft. Ein Feld, das in dieser Tabelle nicht benannt ist, wird zusammen mit dem Datensatz abgelehnt.

Ein Datensatz mit kind: dialogue_graph:

Ein Datensatz mit kind: dialogue_node:

Ein Datensatz mit kind: dialogue_node:

Ein Datensatz mit kind: dialogue_node:

Ein Datensatz mit kind: dialogue_option:

In einer Datei namens gate_toll.json oder einem beliebigen Namen .json in diesem Ordner:

a dialogue record, under content/narrative/dialogue

[
  {
    "kind": "dialogue_graph",
    "id": "northern_reach:gate_toll",
    "entry": "northern_reach:gate_open",
    "speaker": "gate_warden",
    "name_key": "TALK_PACK_GATE_TOLL_NAME",
    "description_key": "TALK_PACK_GATE_TOLL_DESC"
  },
  {
    "kind": "dialogue_node",
    "id": "northern_reach:gate_open",
    "graph": "northern_reach:gate_toll",
    "voice": "line",
    "speaker": "gate_warden",
    "line_key": "TALK_PACK_GATE_OPEN"
  },
  {
    "kind": "dialogue_option",
    "id": "northern_reach:opt_pay_the_toll",
    "node": "northern_reach:gate_open",
    "label_key": "TALK_PACK_OPT_PAY",
    "goto": "northern_reach:gate_paid",
    "commands": [
      {
        "step": "pay_coin",
        "coin": 25
      },
      {
        "step": "change_relation",
        "subject": "player",
        "target": "gate_warden",
        "delta": 4
      }
    ]
  }
]

Das Fixture enthält 12 Datensätze; 3 werden angezeigt.

locales

Die Wörter, die ein Spieler liest, im CSV-Format mit einer Spalte pro Sprache: die eigenen Schlüssel des Pakets und die des Spiels, bei dem das Paket das Überschreiben angibt.

• Status Einsatzbereit
• Ordner content/locale
• Bericht modding_locale_report
• Wenn ein Spieler Sie deinstalliert preserve_inert_reference. Eine Speicherung benennt den Datensatz, niemals die Wörter, die ihn ausdrücken. Daher kostet ein Paket, das zwischen zwei Sitzungen zurückgezogen wird, eine Übersetzung und nichts. Der Schlüssel bleibt erhalten und wird angezeigt, was eher wie eine fehlende Übersetzung als wie ein fehlender Inhalt aussieht.

Spalten. Eine Spalte, die diese Tabelle nicht benennt, wird mit dem Datensatz abgelehnt.

In einer Datei namens words.csv. Der Dateiname ist die Hälfte der Adresse und die Zeilen-ID die andere Hälfte, sodass zwei Dateien dieselbe Zeilen-ID enthalten können, ohne dass es zu Kollisionen kommt:

a locales file

key,en,it
word_pack:GOOD_FROST_SALT,Frost Salt,Sale di Brina

lore

Kodexeinträge: Orte, Menschen, Ereignisse, Bräuche und Dinge, über die eine Welt Geschichten erzählt. Ein hochgeladener Eintrag ist kein bekannter Eintrag.

• Status Einsatzbereit
• Ordner content/narrative/lore
• Für das id-Feld weitergeleitete Datensätze
• Bericht modding_lore_report
• Wenn ein Spieler Sie deinstalliert preserve_inert_reference. Ein Codexeintrag, den ein Spieler gelesen hat, ist etwas, das er gesehen hat. Wenn er es wegnimmt, löscht er einiges von dem, was er über eine Welt weiß, in der er Zeit verbracht hat, und Quests und andere Einträge weisen auf die ID hin.

Felder. Ein Feld, das diese Tabelle nicht benennt, wird mit dem Datensatz abgelehnt.

In einer Datei namens lore.json oder einem beliebigen Namen .json in diesem Ordner:

a lore record, under content/narrative/lore

[
  {
    "id": "northern_reach:the_drowned_causeway",
    "category": "place",
    "title_key": "STORY_PACK_DROWNED_CAUSEWAY_TITLE",
    "body_key": "STORY_PACK_DROWNED_CAUSEWAY_BODY",
    "era": "before_the_mark",
    "citation_key": "STORY_PACK_CAUSEWAY_CITATION"
  },
  {
    "id": "northern_reach:the_tide_watch",
    "category": "custom",
    "title_key": "STORY_PACK_TIDE_WATCH_TITLE",
    "body_key": "STORY_PACK_TIDE_WATCH_BODY",
    "relates_to": [
      "northern_reach:the_drowned_causeway"
    ]
  }
]

mr_lines

Strukturierte Linien im mittelalterlichen Realismus, weitergeleitet nach Datei- und Zeilen-ID anstelle eines ID-Felds im JSON.

• Status Einsatzbereit
• Ordner content/medieval_realism/structured
• Bericht modding_mr_lines_report
• Wenn ein Spieler Sie deinstalliert drop_optional_presentation. Ein Farbwitz, auf den sich nichts bezieht. Das Entfernen kostet nichts und das Beibehalten würde eine leere Zeichenfolge anzeigen.

Spalten. Eine Spalte, die diese Tabelle nicht benennt, ist zulässig und muss ein einfacher Wert anstelle einer Liste oder eines Objekts sein.

Jeder Datensatz benötigt mindestens einen von public_line, public_label, public_summary_line.

Diese Namen werden ohne Frage abgelehnt, unabhängig davon, was sie enthalten: unsafe_example, unsafe_reason, audit_note, expected_block_reason, script, scene, resource_path. Einige sind die Verifizierungsspalten, mit denen diejenigen schreiben, die das Spiel spielen, und die anderen sind die codeförmigen Namen, die What a mod can never do überall ablehnt. Ein Rekordhalter wird abgelehnt, anstatt stillschweigend abgewischt zu werden.

In einer Datei namens MR_L03_TAVERN_INN_LINES.csv. Der Dateiname ist die Hälfte der Adresse und die Zeilen-ID die andere Hälfte, sodass zwei Dateien dieselbe Zeilen-ID enthalten können, ohne dass es zu Kollisionen kommt:

a mr_lines file

line_id,tavern_state,speaker_role,tone,public_line,mechanical_hint
northern_reach:tavern_extra_01,evening_rush,innkeeper,welcoming,"Warm bread and a clean cup if you've the coin for it, friend.",food_only

progress

Spielerfortschrittsaufzeichnungen: Ziele, sichere Schwierigkeitsprofile und Spielprofile innerhalb der Regeln des Gastgebers.

• Status Einsatzbereit
• Ordner content/player/progress
• Für das id-Feld weitergeleitete Datensätze
• Melde nichts von ihm; modding_preflight_report kümmert sich darum
• Wenn ein Spieler Sie deinstalliert preserve_inert_reference. Erreichte Erfolge und ausgewählte Spielprofile bleiben benannt, wenn ihr Paket fehlt; Sie stillschweigend wegzunehmen würde die Geschichte des Spielers oder den Spielvertrag neu schreiben.

Felder. Diese Familie enthält mehr als einen Datensatztyp und jeder Typ wird anhand seiner eigenen Liste überprüft. Ein Feld, das in dieser Tabelle nicht benannt ist, wird zusammen mit dem Datensatz abgelehnt.

Ein Datensatz mit kind: achievement:

Ein Datensatz mit kind: difficulty_profile:

Ein Datensatz mit kind: run_profile:

In einer Datei namens progress.json oder einem beliebigen Namen .json in diesem Ordner:

a progress record, under content/player/progress

[
  {
    "id": "northern_reach:hard_tide",
    "kind": "difficulty_profile",
    "name_key": "DIFF_HARD_TIDE",
    "description_key": "DIFF_HARD_TIDE_DESC",
    "modifiers": {
      "enemy_strength_percent": 140,
      "coin_gain_percent": 80
    },
    "permadeath": true
  },
  {
    "id": "northern_reach:tide_run",
    "kind": "run_profile",
    "name_key": "RUN_TIDE",
    "description_key": "RUN_TIDE_DESC",
    "difficulty": "northern_reach:hard_tide",
    "seed_stream": "tide"
  },
  {
    "id": "northern_reach:held_tide",
    "kind": "achievement",
    "name_key": "ACH_HELD_TIDE",
    "description_key": "ACH_HELD_TIDE_DESC",
    "condition": [
      {
        "when": "days_survived",
        "count": 30
      }
    ],
    "icon": "tower"
  }
]

quest_metadata

Quest-Metadatensätze, indiziert nach quest_id statt nach id.

• Status Einsatzbereit
• Ordner content/narrative/quest_metadata
• Für das quest_id-Feld weitergeleitete Datensätze
• Bericht modding_quest_metadata_report
• Wenn ein Spieler Sie deinstalliert preserve_inert_reference. Er beschreibt Missionen, die selbst bereits auf einen Grabstein reduziert werden könnten; Wenn man es wegnimmt, bleiben sie ohne Beschreibung zurück, statt dass sie fehlen.

Felder. Ein Feld, das diese Tabelle nicht benennt, wird mit dem Datensatz abgelehnt.

In einer Datei namens quests.json oder einem beliebigen Namen .json in diesem Ordner:

a quest_metadata record, under content/narrative/quest_metadata

[
  {
    "quest_id": "northern_reach:tavern_errand",
    "world_reason": "settlement_shortage",
    "quest_role": "recovery",
    "difficulty_band": "standard",
    "urgency_band": "soon"
  }
]

quest_plans

Missionspläne als Aufzeichnungen: Die Handlungsstränge, Missionen, Ziele und Enden, die ein Paket schreibt und aus denen das Spiel seine eigenen Missionen aufbaut. Die Aufzeichnungsform einer Mission, neben handschriftlichen Ressourcen statt an deren Stelle.

• Status Einsatzbereit
• Ordner content/narrative/quest_plans
• Für das id-Feld weitergeleitete Datensätze
• Bericht modding_quest_plan_report
• Wenn ein Spieler Sie deinstalliert preserve_inert_reference. Ein Plan baut die gleichen Missionen auf, die das Spiel ausführt, sodass ein pensionierter Plan die gleiche Lücke hinterlässt, die die Handschrift hinterlassen würde. Der Fortschritt ist das Einzige, was ein Spieler nicht rekonstruieren kann: Eine ungelöste Mission wird gemeldet und nie abgeschlossen oder stillschweigend abgebrochen.

Felder. Diese Familie enthält mehr als einen Datensatztyp und jeder Typ wird anhand seiner eigenen Liste überprüft. Ein Feld, das in dieser Tabelle nicht benannt ist, wird zusammen mit dem Datensatz abgelehnt.

Ein Datensatz mit kind: arc:

Ein Datensatz mit kind: ending:

Ein Datensatz mit kind: objective:

Ein Datensatz mit kind: quest:

In einer Datei namens the_long_winter.json oder einem beliebigen Namen .json in diesem Ordner:

a quest_plans record, under content/narrative/quest_plans

[
  {
    "kind": "arc",
    "id": "northern_reach:the_long_winter",
    "name_key": "northern_reach.arc.the_long_winter.name",
    "stages": [
      "northern_reach:bring_the_grain"
    ]
  },
  {
    "kind": "quest",
    "id": "northern_reach:bring_the_grain",
    "name_key": "northern_reach.quest.bring_the_grain.name",
    "description_key": "northern_reach.quest.bring_the_grain.description",
    "giver": "northern_reach:the_reeve",
    "in_arc": "northern_reach:the_long_winter",
    "objectives": [
      "northern_reach:gather_grain",
      "northern_reach:pay_the_toll"
    ],
    "deadline_days": 30,
    "rewards": [
      {
        "grant": "receive_coin",
        "coin": 250
      },
      {
        "grant": "give_item",
        "item": "northern_reach:reeves_seal",
        "count": 1
      }
    ]
  },
  {
    "kind": "objective",
    "id": "northern_reach:gather_grain",
    "quest": "northern_reach:bring_the_grain",
    "goal": "collect_item",
    "target": "northern_reach:winter_grain",
    "count": 40,
    "name_key": "northern_reach.objective.gather_grain.name"
  }
]

Das Gerät enthält 5 Datensätze; 3 werden angezeigt.

quests

Handgeschriebene Missionsressourcen, die pro Route geladen werden, anstatt als Aufzeichnungen interpretiert zu werden. Ein Paket, das eine eigene Mission haben möchte, schreibt quest_plans.

• Status Geprüft, noch nicht installiert
• Ordner content/narrative/quests
• Melde nichts von ihm; modding_preflight_report kümmert sich darum
• Wenn ein Spieler Sie deinstalliert preserve_inert_reference. Fortschritt ist das Einzige, was ein Spieler nicht wieder aufbauen kann. Eine ungelöste Mission wird gemeldet und nie abgeschlossen oder stillschweigend abgebrochen.

Diese Familie wird nach Pfad geladen und nicht als Datensatz gelesen, und ein Paket kann nicht die gewünschte Datei enthalten. siehe Was ein Mod niemals tun kann. Schreiben Sie stattdessen quest_plans.

scenes

Inszenierte Szenen: der Raum, wer sich darin befindet und die Linien, die sich der Reihe nach entfalten. Es ist der einzige Inhalt, der dem Player die Kontrolle entzieht, weshalb eine Sequenz, die niemals end erreicht, abgelehnt und nicht abgespielt wird. Witze und Requisiten sind Namen, die veröffentlichten Listen entnommen sind; Hier werden keine Godot-Szenen, keine Assets und keine Skripte geladen.

• Status Einsatzbereit
• Ordner content/narrative/scenes
• Für das id-Feld weitergeleitete Datensätze
• Bericht modding_scene_report
• Wenn ein Spieler Sie deinstalliert preserve_inert_reference. Eine Speicherung zeichnet auf, was eine Szene getan hat – einen Namen gewählt, eine Mission verschoben, eine Tür geöffnet – nie die Tatsache, dass sie angeschaut wurde. Es wird innerhalb einer einzigen Sitzung abgespielt und endet, sodass ein Paket, das die Szene verlässt, die Szene kostet und niemals eine Folge davon ist, dass man es gesehen hat. Es zu ersetzen würde etwas inszenieren, was der Autor nie unter dem Namen von etwas geschrieben hat, das er geschrieben hat.

Felder. Ein Feld, das diese Tabelle nicht benennt, wird mit dem Datensatz abgelehnt.

In einer Datei namens scenes.json oder einem beliebigen Namen .json in diesem Ordner:

a scenes record, under content/narrative/scenes

[
  {
    "id": "northern_reach:tollhouse_wake",
    "name_key": "STAGE_PACK_TOLLHOUSE_WAKE",
    "stage": {
      "room": [
        880,
        600
      ],
      "light": "candle",
      "props": [
        {
          "prop": "bed",
          "at": "bedside"
        },
        {
          "prop": "storage",
          "at": "east",
          "label_key": "STAGE_PACK_BELONGINGS"
        },
        {
          "prop": "light_marker",
          "at": "north",
          "light": "candle"
        },
        {
          "prop": "walkway",
          "at": "bedside",
          "to": "door"
        }
      ]
    },
    "cast": [
      {
        "actor": "northern_reach:tollkeeper",
        "name_key": "STAGE_PACK_TOLLKEEPER",
        "sprite": "default",
        "at": "bedside"
      }
    ],
    "beats": [
      {
        "beat": "lock_player"
      },
      {
        "beat": "fade_in",
        "seconds": 2.0
      },
      {
        "beat": "say",
        "actor": "northern_reach:tollkeeper",
        "line_key": "STAGE_PACK_WAKE_1"
      },
      {
        "beat": "wait",
        "seconds": 0.8
      },
      {
        "beat": "say",
        "actor": "northern_reach:tollkeeper",
        "line_key": "STAGE_PACK_WAKE_2"
      },
      {
        "beat": "play_cue",
        "cue": "northern_reach:door_latch"
      },
      {
        "beat": "walk_to",
        "actor": "northern_reach:tollkeeper",
        "anchor": "door"
      },
      {
        "beat": "remove_actor",
        "actor": "northern_reach:tollkeeper"
      },
      {
        "beat": "show_exit"
      },
      {
        "beat": "unlock_player"
      },
      {
        "beat": "end"
      }
    ]
  }
]

Wie man alles sieht und hört

7 Familien: audio, effects, fonts, images, presentation_bindings, screens, themes.

audio

Sounds, die ein Paket enthält, benannt nach ID: Musik, Ambiente, Effekte und Stimme, wobei jeder auf eine Datei in seinem eigenen Ordner verweist und die Rolle angibt, die ihn abgrenzt.

• Status Geprüft, noch nichts verbraucht es
• Ordner content/assets/audio
• Für das id-Feld weitergeleitete Datensätze
• Bericht modding_audio_report
• Wenn ein Spieler Sie deinstalliert preserve_inert_reference. Ein Save benennt das Thema und niemals den Ton darüber, sodass ein Paket, das zwischen zwei Sitzungen zurückgezogen wird, eine Atmosphäre und nichts kostet. Der Bezug wird bewahrt und berichtet: Schweigen, ohne zu sagen, warum genau dieser Zustand zu vermeiden ist, den diese Familie vermeiden will.

Felder. Ein Feld, das diese Tabelle nicht benennt, wird mit dem Datensatz abgelehnt.

In der Datei audio.json, die die einzige Datei ist, über die dieser Ordner gelesen wird:

a audio record, under content/assets/audio

[
  {
    "id": "northern_reach:hearth_hum",
    "file": "hearth_hum.wav",
    "codec": "wav",
    "role": "ambience",
    "duration_seconds": 0.25,
    "sha256": "23fc92432963f74bd638f38ea9d7ddb475853f022810bdc8b344269bf43d5830"
  }
]

effects

Wetter, Staub, Funken und Lichter, zusammengestellt ausgehend von den Modellen, die der Gastgeber zur Verfügung stellt. Ein Paket benennt ein Modell und legt Parameter innerhalb deklarierter Bereiche fest; Es gibt nirgendwo ein Feld, das einen Shader, eine Szene oder ein Skript enthält – und das ist es, was es einem fremden Paket ermöglicht, nach Feuer zu fragen, ohne nach einem Programm fragen zu können.

• Status Einsatzbereit
• Ordner content/assets/effects
• Für das id-Feld weitergeleitete Datensätze
• Bericht modding_effect_report
• Wenn ein Spieler Sie deinstalliert preserve_inert_reference. Nichts in einem Spielstand benennt einen Effekt. Die Luft kehrt zu dem zurück, was das Basisspiel zieht, wenn das Rudel geht, was einen Aspekt und nichts kostet, was ein Spieler besitzt.

Felder. Ein Feld, das diese Tabelle nicht benennt, wird mit dem Datensatz abgelehnt.

In einer Datei namens effects.json oder einem beliebigen Namen .json in diesem Ordner:

a effects record, under content/assets/effects

[
  {
    "id": "northern_reach:moor_drift",
    "template": "dust_drift",
    "parameters": {
      "amount": 64,
      "lifetime": 6,
      "scale": 2,
      "wind": 4,
      "colour": "#c8bfa8"
    },
    "priority": 40
  }
]

fonts

Schriftarten, die ein Paket enthält, benannt nach ID: der Datei, der Größe, in der sie gezeichnet werden, und den Sprachen, deren Glyphen sie enthalten. Das Cover behauptet stattdessen, entlarvt zu sein, weil ein Zeichen, dem die Glyphen einer Sprache fehlen, nicht scheitert: Es zeichnet kleine Quadrate und der Bildschirm liest sich wie eine Übersetzung, die jemand halbfertig hinterlassen hat.

• Status Geprüft, noch nichts verbraucht es
• Ordner content/assets/fonts
• Für das id-Feld weitergeleitete Datensätze
• Bericht modding_font_report
• Wenn ein Spieler Sie deinstalliert preserve_inert_reference. Nichts in einem Spielstand benennt einen Charakter. Beim Verlassen des Pakets wird die Benutzeroberfläche auf die Toolkit-Schriftart zurückgesetzt. Dies ist die einzige Schriftart, die ein Autor auswählen musste.

Felder. Ein Feld, das diese Tabelle nicht benennt, wird mit dem Datensatz abgelehnt.

In der Datei fonts.json, die die einzige Datei ist, über die dieser Ordner gelesen wird:

a fonts record, under content/assets/fonts

[
  {
    "id": "northern_reach:plain",
    "file": "plain.ttf",
    "format": "ttf",
    "sizes": [
      12,
      16,
      24
    ],
    "oversampling": 1,
    "covers": [
      "en"
    ],
    "fallback_font": "Segoe UI",
    "sha256": "613b1d24f9f8b0365a94f01214155af8e87ca72aa6633befd5e0ee05b3dc4122"
  }
]

images

Bilder, die ein Paket mitbringt, benannt nach ID: Symbole, Porträts und Spritesheets, die jeweils auf eine Datei in einem eigenen Ordner verweisen.

• Status Einsatzbereit
• Ordner content/assets/images
• Für das id-Feld weitergeleitete Datensätze
• Bericht modding_image_report
• Wenn ein Spieler Sie deinstalliert preserve_inert_reference. Eine Speicherung benennt Objekte und Personen, niemals ein Bild von einem von ihnen. Ein Bild, das nicht mehr aufgelöst wird, kostet also eine Zeichnung und kein Ding. Der Verweis wird beibehalten und gemeldet: Ersetzen durch Grafiken aus einem anderen Paket würde dem Spieler etwas zeigen, das kein Autor ausgewählt hat, und das stille Entfernen der ID würde dazu führen, dass das fehlende Symbol wie ein Designfehler aussieht.

Felder. Ein Feld, das diese Tabelle nicht benennt, wird mit dem Datensatz abgelehnt.

In der Datei images.json, die die einzige Datei ist, über die dieser Ordner gelesen wird:

a images record, under content/assets/images

[
  {
    "id": "northern_reach:salt_pouch",
    "file": "salt_pouch.png",
    "format": "png"
  }
]

presentation_bindings

Welche Paketressource welchen Platz zu welchem ​​Thema füllt: das Symbol auf einem Objekt, das Sprite auf einer Einheit oder einem Plättchen, das Banner auf einer Fraktion, sowohl für den Inhalt des Pakets als auch für den des Basisspiels.

• Status Einsatzbereit
• Ordner content/presentation/bindings
• Für das id-Feld weitergeleitete Datensätze
• Melde nichts von ihm; modding_preflight_report kümmert sich darum
• Wenn ein Spieler Sie deinstalliert preserve_inert_reference. Ein Speichervorgang benennt das Subjekt – das Objekt, die Person, das Stück – und niemals das Bild, auf dem es abgebildet ist. Daher kostet ein Link, der nicht mehr aufgelöst wird, eine Zeichnung und kein Ding. Der Bezug bleibt erhalten und wird berichtet: Das Thema kehrt zu der Grafik zurück, die der Build bereits hatte, was die einzige Antwort ist, die kein Autor wählen musste.

Felder. Ein Feld, das diese Tabelle nicht benennt, wird mit dem Datensatz abgelehnt.

In einer Datei namens bindings.json oder einem beliebigen Namen .json in diesem Ordner:

a presentation_bindings record, under content/presentation/bindings

[
  {
    "op": "add",
    "id": "northern_reach:cloak_icon",
    "subject": "wool_cloak",
    "kind": "item",
    "slot": "icon",
    "cue": "northern_reach:cloak_plain",
    "alternative_key": "item_wool_cloak_icon_alt"
  },
  {
    "op": "add",
    "id": "northern_reach:cloak_icon_winter",
    "subject": "wool_cloak",
    "kind": "item",
    "slot": "icon",
    "cue": "northern_reach:cloak_snowy",
    "alternative_key": "item_wool_cloak_icon_alt",
    "when": {
      "season": {
        "is": "winter"
      }
    }
  }
]

screens

Bildschirmlayouts: Welche Abschnitte passen in welches Feld eines Bildschirms, über den das Spiel bereits verfügt, und in welcher Reihenfolge? Es enthält Teile, die dieser Build zeichnet und die nicht hinzugefügt werden können: Ein neuer Bildschirm würde Widgets, Datenquellen und Klick-Handler benötigen, die zusammen eine Programmiersprache darstellen.

• Status Einsatzbereit
• Ordner content/ui/screens
• Für das id-Feld weitergeleitete Datensätze
• Bericht modding_screen_report
• Wenn ein Spieler Sie deinstalliert preserve_inert_reference. Nichts in einer Rettung nennt eine Disposition. Es entscheidet, wie eine Seite gezeichnet wird, während das Paket geladen wird, und die Seite kehrt beim Verlassen zu dem Layout zurück, das dieser Build mitnimmt: Sie kostet einen Skin und nichts, was ein Spieler besitzt.

Felder. Ein Feld, das diese Tabelle nicht benennt, wird mit dem Datensatz abgelehnt.

In einer Datei namens screens.json oder einem beliebigen Namen .json in diesem Ordner:

a screens record, under content/ui/screens

[
  {
    "id": "northern_reach:character_sheet",
    "screen": "character_sheet",
    "panels": {
      "header": [
        "header"
      ],
      "left": [
        "vitals",
        "combat"
      ],
      "middle": [
        "attributes",
        "skills"
      ],
      "right": [
        "service",
        "weight",
        "background"
      ]
    }
  }
]

themes

Schnittstellenpaletten als Token: benannte Farben, Größen und Abstände, mit Paaren, deren Kontrast ein Spieler lesen können muss. Niemals eine Szene, ein Skript oder ein Ressourcenpfad.

• Status Einsatzbereit
• Ordner content/assets/themes
• Für das id-Feld weitergeleitete Datensätze
• Bericht modding_theme_report
• Wenn ein Spieler Sie deinstalliert preserve_inert_reference. Nichts in einem Spielstand benennt ein Thema. Die Benutzeroberfläche kehrt beim Verlassen des Pakets zu den Toolkit-Farben zurück. Dies ist die einzige Palette, die ein Autor bisher auswählen musste.

Felder. Ein Feld, das diese Tabelle nicht benennt, wird mit dem Datensatz abgelehnt.

In einer Datei namens themes.json oder einem beliebigen Namen .json in diesem Ordner:

a themes record, under content/assets/themes

[
  {
    "id": "northern_reach:dusk",
    "tokens": {
      "bg_deep": {
        "kind": "colour",
        "value": "#12131a"
      },
      "bg_panel": {
        "kind": "colour",
        "value": "#1b1c26"
      },
      "bg_panel_hi": {
        "kind": "colour",
        "value": "#262838"
      },
      "text": {
        "kind": "colour",
        "value": "#e8e2d0"
      },
      "text_bright": {
        "kind": "colour",
        "value": "#f4efe2"
      },
      "text_mute": {
        "kind": "colour",
        "value": "#6f6a80"
      },
      "border": {
        "kind": "colour",
        "value": "#7f6ab0"
      },
      "border_dark": {
        "kind": "colour",
        "value": "#14151c"
      },
      "border_soft": {
        "kind": "colour",
        "value": "#4a4560"
      },
      "danger": {
        "kind": "colour",
        "value": "#d4564b"
      },
      "success": {
        "kind": "colour",
        "value": "#7fc46a"
      },
      "warning": {
        "kind": "colour",
        "value": "#e0b13c"
      },
      "accent_player": {
        "kind": "colour",
        "value": "#6f97e8"
      },
      "accent_enemy": {
        "kind": "colour",
        "value": "#c94a4a"
      }
    },
    "contrast_pairs": [
      {
        "text": "#e8e2d0",
        "background": "#12131a"
      },
      {
        "text": "#f4efe2",
        "background": "#1b1c26"
      },
      {
        "text": "#e8e2d0",
        "background": "#262838"
      }
    ]
  }
]

Was kontrolliert der Spieler und was beobachtet er

3 Familien: adaptive, input_bindings, settings.

adaptive

Profile, die sich mit dem Verlauf eines Spiels befassen und einen anderen Ansatz vorschlagen. Das Ergebnis ist ein Rat und niemals eine Änderung: Ein Profil, das agieren könnte, wäre das Einzige, was ein Paket mit sich bringt, das in der Lage ist, ein Spiel zu ändern, ohne dass der Spieler oder Gast danach gefragt hätte, und in einem Diff würde es genau wie eine Anpassungstabelle aussehen. Eingaben sind eine veröffentlichte Liste von Spielaggregaten, jeweils eine Anzahl oder ein Durchschnitt, den das Spiel bereits über sich selbst hat.

• Status Einsatzbereit
• Ordner content/player/adaptive
• Für das id-Feld weitergeleitete Datensätze
• Bericht modding_adaptive_report
• Wenn ein Spieler Sie deinstalliert drop_optional_presentation. Keine Namen für ein Profil speichern. Was ein Profil berührt hat, ist ein Multiplikator, der von den aktiven Mutatoren bei jeder Änderung neu berechnet wird, sodass ein zurückgezogenes Paket nicht mehr konsultiert wird und das Spiel genau zu dem zurückkehrt, was der Spieler ausgewählt hat. Nichts bleibt erhalten, also gibt es auch nichts zu bewahren.

Felder. Diese Familie enthält mehr als einen Datensatztyp und jeder Typ wird anhand seiner eigenen Liste überprüft. Ein Feld, das in dieser Tabelle nicht benannt ist, wird zusammen mit dem Datensatz abgelehnt.

Ein Datensatz mit kind: adaptive_profile:

Ein Datensatz mit kind: threshold_set:

In einer Datei namens adaptive.json oder einem beliebigen Namen .json in diesem Ordner:

a adaptive record, under content/player/adaptive

[
  {
    "kind": "adaptive_profile",
    "id": "northern_reach:hard_roads",
    "name_key": "ADAPTIVE_HARD_ROADS",
    "description_key": "ADAPTIVE_HARD_ROADS_BODY",
    "policy": "pace_encounters",
    "reads": [
      "battles_won_ratio",
      "days_survived",
      "party_size"
    ],
    "fallback_policy": "event_cadence",
    "confidence_floor_percent": 60,
    "sample_days": 14
  },
  {
    "kind": "threshold_set",
    "id": "northern_reach:hard_roads_lines",
    "profile": "northern_reach:hard_roads",
    "name_key": "ADAPTIVE_HARD_ROADS_LINES",
    "thresholds": [
      {
        "signal": "battles_won_ratio",
        "above": 80,
        "advise": "raise"
      },
      {
        "signal": "battles_won_ratio",
        "below": 35,
        "advise": "lower"
      },
      {
        "signal": "party_size",
        "below": 3,
        "advise": "lower"
      },
      {
        "signal": "days_survived",
        "above": 60,
        "advise": "hold"
      }
    ]
  }
]

input_bindings

Eigene Aktionen eines Pakets, mit dem Schlüssel, den sie möchten. Der Spieler entscheidet: Ein Vorschlag, der auf einer von ihm bereits zugewiesenen Kombination landet, verliert, und die Aktion kommt ohne Knopf, weil ein Knopf, der stillschweigend etwas anderes tut, schlechter ist als ein Knopf, der nichts tut.

• Status Einsatzbereit
• Ordner content/input
• Für das action_id-Feld weitergeleitete Datensätze
• Bericht modding_input_report
• Wenn ein Spieler Sie deinstalliert preserve_inert_reference. Die Neuzuweisung eines Spielers bleibt unter der Aktions-ID gespeichert, sodass bei der Neuinstallation des Pakets die Schaltfläche dort gefunden wird, wo Sie sie abgelegt haben. Die Aktion selbst wird aus der Befehlszuordnung entfernt, wenn das Paket verlässt, sodass im Zuweisungsbildschirm nie etwas aufgeführt wird, das auf nichts reagiert.

Felder. Ein Feld, das diese Tabelle nicht benennt, wird mit dem Datensatz abgelehnt.

In einer Datei namens bindings.json oder einem beliebigen Namen .json in diesem Ordner:

a input_bindings record, under content/input

[
  {
    "action_id": "northern_reach:call_scout",
    "label_key": "KEY_PACK_CALL_SCOUT",
    "context": "exploration",
    "suggested_keyboard": "f9"
  }
]

settings

Optionen, die ein Spieler ändern kann, können erklärt und nicht gezogen werden. Ein Paket sagt, was die Option ist, welche Werte sie haben kann und wo der Wert lebt; Die Steuerung wird vom Gast erstellt. Nichts, was diese Grenze überschreitet, ist ein Steuerelement oder ein Skript, und das ist der einzige Grund, warum ein Einstellungsmenü die Optionen eines Fremden anzeigen kann, ohne seinen Code auszuführen.

• Status Einsatzbereit
• Ordner content/settings
• Für das key-Feld weitergeleitete Datensätze
• Bericht modding_settings_report
• Wenn ein Spieler Sie deinstalliert preserve_inert_reference. Ein gespeicherter Wert verbleibt unter seinem Schlüssel, so dass die Neuinstallation des Pakets die Wahl des Spielers dort findet, wo er es hinterlassen hat. Was das Paket hinterlässt, ist eine Zeile in einem Profil, die niemand liest: Es kostet nichts und bewahrt eine vom Spieler getroffene Wahl.

Felder. Ein Feld, das diese Tabelle nicht benennt, wird mit dem Datensatz abgelehnt.

In einer Datei namens settings.json oder einem beliebigen Namen .json in diesem Ordner:

a settings record, under content/settings

[
  {
    "key": "northern_reach:patrol_density",
    "type": "int",
    "default": 3,
    "minimum": 1,
    "maximum": 9,
    "scope": "campaign",
    "label_key": "OPTION_PACK_PATROL_DENSITY",
    "help_key": "OPTION_PACK_PATROL_DENSITY_HELP"
  },
  {
    "key": "northern_reach:show_road_names",
    "type": "bool",
    "default": true,
    "scope": "presentation",
    "label_key": "OPTION_PACK_SHOW_ROAD_NAMES"
  }
]

Konsolenverknüpfungen

Dies ist eine Abkürzung, kein Schritt. Alles unten hat seinen Platz auf dem Mods-Bildschirm, wo der normale Weg hingeht und wo jeder, der Ihr Paket heruntergeladen hat, nachsehen kann. Die Konsole ist schneller, wenn Sie iterieren, sie ist bereits geöffnet und existiert nur in einem Debug-Build: Eine veröffentlichte Kopie des Spiels hat keine Konsole, sodass nichts, was ein Paketautor benötigt, hier allein leben kann.

Beginnen Sie bei modding_manifest_report – erkennt das Spiel Ihr Paket und in welchem ​​Zustand? – dann modding_preflight_report für ein einziges Urteil über alles, was installiert ist. Dann der Bericht der einzelnen Familie.

modding_reload liest deine Dateien ohne Neustart erneut. Bearbeite sie, wechsle per Alt-Tab, gib den Befehl ein und sieh nach. Es baut auf, was nichts festhält — Bindings, Effekte und Bilder — und nennt jede Familie, die es auslässt, weil eine Partie auf Datensätzen steht, die ein Spielstand benennen kann:

what the game prints back

HELD BY THE RUN items: edited files are read on the next load

modding_reload all liest alles noch einmal und ist für einen Begrüßungsbildschirm ohne laufendes Spiel vorgesehen. modding_condition_report gibt aus, was das Spiel jetzt für einen when beantworten kann und was nicht.

Offline-Tools

Diese Werkzeuge sind für Autoren und Veröffentlichungsautomatisierung gedacht. Sie liegen im öffentlichen Bonemark-Checkout; Spieler eines veröffentlichten Mods benötigen weder Python noch Godot. Wenn du einen Mod schreibst, klone den passenden Stand von github.com/tallowgames/Bonemark, halte dein Arbeitspaket außerhalb des Spielerordners mods und führe die folgenden Befehle aus diesem Checkout aus. Das Spiel bleibt die letzte Runtime-Autorität.

Python 3.10 oder neuer; Godot nur für die Laufzeitspur. Bewahren Sie Ihr Paket außerhalb des Ordners mods des Players auf und versuchen Sie es mit einer Kopie.

a command line

python tools/modding/new_mod.py --list
python tools/modding/new_mod.py --id my_mod --family goods --family items

Es schreibt ein Paket, das die Validierung besteht, bevor Sie überhaupt etwas geschrieben haben: ein vorkompiliertes mod.json, einen Arbeitsdatensatz für jede von Ihnen angeforderte Familie und eine README-Datei mit den nächsten beiden Befehlen. Die Datensätze stammen von Vorrichtungen, die der Build bereits für diese Familien überprüft. Ein Anlasser, der nicht mehr funktioniert, führt also zu derselben Prüfung, die dazu führt, dass die Vorrichtung ausfällt, anstatt innerhalb eines Modells zu verrotten. Es weigert sich, in einen Ordner namens mods zu schreiben.

a command line

python tools/quality/validate_mod_data.py --root "<mod-root>"
python tools/quality/validate_mod_data.py --strict --root "<mod-root>"

Überprüfen Sie mod.json, Familienordner, IDs, Schemata, Referenzen, Grenzwerte und blockierte Nutzlasten. --strict verwandelt Warnungen in Fehler.

Modding-Oberfläche mit Version vergleichen

Wenn sich das Spiel ändert, vergleichen Sie den archivierten Oberflächen-Snapshot, bevor Sie ein Paket aktualisieren. Es enthält einen Digest sowie Felder und Operationen für jede öffentliche Familie, sodass das Ergebnis angibt, welche Familie sich geändert hat und warum:

a command line

python tools/quality/modding_surface_contract.py --json
python tools/quality/modding_surface_contract.py --before "<previous-build>/game/games/bonemark/modding/data/mod_surface_contract.json" --json

Der Unterschied ist unchanged, additive oder breaking. Die Fehlergründe sind eindeutig: field_removed, required_added, type_changed, default_changed, constraint_changed, operation_removed und root_changed, format_changed, id_field_changed, catalogue_changed, family_removed und contract_major_changed_without_new_id. Kompatibler Modifikationsname field_added, required_removed, operation_added oder family_added. Der Befehl ohne --before prüft zusätzlich die hinterlegte Baseline. Wenn sich die aktuelle Oberfläche verschoben hat, schlägt die Prüfung fehl, bis ein Betreuer die genauen Vorher/Nachher-Digests in tools/quality/modding_surface_contract_changes.json untersucht. Bei einer bahnbrechenden Änderung müssen außerdem jeder Grund, die Entscheidung, der Migrationshinweis und der Prüfer erfasst werden. Die Werbung für einen absichtlich überarbeiteten Schnappschuss ist explizit:

a command line

python tools/quality/modding_surface_contract.py --write-baseline

Dies ist eine Betreuer-/Release-Prüfung; Mod-Autoren benötigen nur den --before-Vergleich, und Spieler, die ein veröffentlichtes Paket installieren, müssen es nicht ausführen.

a command line

python tools/modding/mod_test_host.py --root "<mod-root>" --repo-root "<framework-root>" --json

Liest das Manifest, die Abhängigkeiten, die Kompatibilität und die Ladereihenfolge, ohne Godot zu starten und ohne eines Ihrer Pakete auszuführen.

Öffnet niemals eine Inhaltsdatei. Das ist die Arbeitsteilung: Der Host antwortet diese Pakete werden zusammen geladen, der Validator antwortet dieser Datensatz ist korrekt – aber das bedeutet, dass ein Paket, das der Validator ablehnt, hier trotzdem sauber zusammengestellt werden kann. Gemessen an vierzehn absichtlich gebrochenen Paketen sind sich die beiden bei jeder Ablehnung nicht einig: Der Host stellt alle vierzehn leeren refused bereit, einschließlich eines mit scripts/payload.sh, das nur der Validator findet. Wählen ist nicht dasselbe wie eine sichere Installation. Führen Sie beides vor der Veröffentlichung aus. Wiederholen Sie --root, wenn der Testsatz in Ordner unterteilt ist. Der Host stellt dann den gesamten Satz nach einem deterministischen Plan zusammen.

a command line

python tools/modding/mod_test_matrix.py --repo-root "<framework-root>" --root "<mod-root>" --godot "<godot-exe>" --require-runtime --report "mod_test_matrix.json"

Es führt den Validator, den Testhost, das Fixture jeder Familie sofort und die Godot-Laufzeitspur aus. Entfernen Sie --require-runtime, wenn Sie Godot nicht haben. Im Bericht steht dann, dass der Laufzeittest übersprungen und nicht bestanden wurde.

Wiederholen Sie für einen zusammengesetzten Satz die Option:

a command line

python tools/modding/mod_test_matrix.py --repo-root "<framework-root>" --root "<mod-a>" --root "<mod-b>" --godot "<godot-exe>" --require-runtime

Der Bericht behält ein Ergebnis pro Stamm und fügt composed_set für den vollständigen Satz hinzu. In diesem Block werden Paketkonflikte, doppelte IDs und Abhängigkeitsfehler demonstriert. Eine saubere Verpackung allein ist kein Beweis dafür, dass das Set zusammen geladen wird. Der Bericht enthält außerdem surface_contract, die aktuelle Version des Familienvertrags und den Audit-Digest, sodass eine Matrix nicht grün sein kann, während der Repository-Kompatibilitäts-Snapshot veraltet ist. Lesen Sie mit --require-runtime runtime.reachability.loaded_families und runtime.reachability.reachable_families. Der erste besagt, dass die zusammengesetzten Datensätze geladen wurden; der zweite wird nur dann bevölkert, wenn ein echter Pfad, der auf Spieler der Godot-Sonde abzielt, sie verschlungen hat. runtime.reachability.observations verwaltet das Paket, die Familie, die Datensatz-ID, den Pfad und den Status für jede Zeile, während unreachable die geladenen Zeilen auflistet, die noch keinen Pfad haben. Eine Familie kann validiert und inszeniert werden, aber dennoch in reachable_families fehlen: „geladen“ ist nicht dasselbe wie „ein Spieler kann sie erreichen“.

Jeder oben genannte Befehl wird beim Erstellen dieser Seite mit den Tools selbst verglichen: Das Skript muss vorhanden sein und jede Option muss eine akzeptierende Option sein.

Jeder Diagnosecode

Lesen Sie diese Liste nicht der Reihe nach. Es ist hier, damit ein Code, auf den Sie in einem Bericht stoßen, eine Frage mit einer Antwort ist – ein kleines Wort in Kleinbuchstaben wie asset_missing. Fügen Sie einen in das Suchfeld oben auf dieser Seite ein.

Manche Codes gehören zu Mechanismen, die ein Paket noch nicht erreichen kann. Mir geht es genauso: Ein Code, den man nicht auslösen kann, kostet eine Zeile, die man nie lesen wird, und ein Code, der fehlt, kostet einen Abend.