Moddage

Où se trouve le dossier mods

Ouvrez Mods depuis le menu principal. Le chemin est écrit en haut de l'écran, avec un bouton à côté qui ouvre le dossier dans votre gestionnaire de fichiers.

Il se trouve à côté de vos sauvegardes, et c'est le même dossier, que vous installiez le mod de quelqu'un d'autre ou que vous écriviez le vôtre. Rien n'est lu pendant que le jeu est en cours d'exécution, donc peu importe si le jeu est ouvert pendant que vous déplacez des fichiers.

Installer un mod

A est un dossier avec mod.json en haut. La plupart des téléchargements se trouvent dans ce dossier dans un zip.

Un mod dans lequel vous copiez reste désactivé jusqu'à ce que vous le disiez. Le jeu rejette les exécutables sans aucun doute, mais un paquet de données peut toujours modifier les prix, les articles et les personnes d'une manière que vous n'avez pas demandée, et un qui apparaît tout seul dans un jeu déjà en cours est un problème que personne ne veut diagnostiquer. Alors le jeu demande. C'est un redémarrage supplémentaire la première fois, et plus jamais pour ce package.

Il n'y a pas de lanceur, il n'y a pas de fichier d'ordre de chargement à modifier et il n'y a rien à enregistrer. L'ordre de chargement est un numéro à l'intérieur de chaque package, choisi par son auteur.

Commencez une nouvelle partie pour un package qui ajoute des personnes, des lieux ou des quêtes. Une sauvegarde déjà en cours conserve le monde avec lequel elle a été créée. Les packages qui ne changent que les nombres, les images ou les couleurs sont visibles dans une partie déjà commencée. Les fichiers audio et de police sont validés, mais aucune surface de package en cours d'exécution ne les consomme encore.

Est-il chargé ?

Mod, dans le menu principal. Chaque package trouvé tient sur une seule ligne, avec un statut en un mot : chargé, désactivé, invalide, en conflit, nécessite un autre mod, ignoré.

Un mod peut également s'arrêter, et il indique pourquoi. Le commutateur que vous mettez s'applique au package sur lequel vous l'avez mis, pas à son nom dans le dossier. Les identifiants de mod sont choisis par les auteurs et il n'y a rien pour les coordonner, donc deux mods sans rapport appelés northern_reach sont un accident ordinaire - et sans cela, le second hériterait du commutateur du premier. Si le mod sous un identifiant n'est pas celui que vous aviez activé, la ligne le dit : ce n'est pas le mod que vous avez activé. La mise à jour d'un mod en place préserve votre switch ; supprimez-le et copiez-en un autre n°

Si vous êtes l'auteur d'un mod et que vous voyez cette ligne sur votre package, vous avez une collision d'identifiant avec le mod de quelqu'un d'autre. Choisissez un identifiant moins évident.

Deux de ces mots concernent un redémarrage que vous devez, et non le package. Actif — redémarrer pour charger signifie que vous l'avez activé et que personne ne l'a encore lu ; Désactivé — redémarrer pour télécharger signifie le contraire, et son contenu reste dans le jeu jusqu'à ce que vous redémarriez. Ce sont des mots volontairement séparés : un écran qui indique "Chargé" au moment où vous actionnez un interrupteur vous enverrait chercher dans le monde quelque chose qui n'est pas encore là.

Lorsque l'état n'est pas "chargé", la ligne ci-dessous vous indique pourquoi, dans la langue dans laquelle vous jouez et sans identifiants vous n'avez pas écrit : quel fichier le jeu refuse de s'exécuter, quel paquet lui manque, quelle version il veut. Ci-dessous, ce qu'a fait le contenu du colis : combien d'entrées ont été entrées, combien ont été rejetées. Afficher les détails ouvre le reste, c'est-à-dire les identifiants et la règle exacte que chaque enregistrement rejeté a enfreint.

Deux lignes partagent volontairement un mot : Nécessite un autre mod C'est le même problème pour un joueur, que le package dont il a besoin soit manquant ou la mauvaise version, et la ligne ci-dessous indique laquelle. Et lorsque deux paquets revendiquent le même enregistrement, celui avec le load_order le plus élevé écrit en dernier et gagne – mais une prise de contrôle que personne n'a déclarée est une erreur, pas une note. Les deux lignes sont signalées, et la ligne du perdant nomme le gagnant, et le gagnant est toujours calculé au lieu d'être laissé au hasard : un rejet ne doit pas nécessairement être un tirage au sort. Quand deux mods veulent la même chose explique comment en déclarer un volontairement.

« Chargé » ne signifie pas que vous pouvez encore le voir dans le monde. Pour cela, lisez les décomptes sous la ligne, et Maintenant, trouvez-le dans le jeu indique où chaque type de chose apparaît.

Les décomptes s'additionnent toujours. La lecture est appliquée, davantage rejetée, davantage remplacée par un autre mod, davantage en attente selon ses propres conditions — et les deux derniers sont nommés au lieu de rester un trou. Un enregistrement écrit en dernier par un autre paquet n'est pas rejeté, car il n'y a rien de mal à cela, et il n'est même pas appliqué, car ce n'est pas ce que le jeu a conservé. C'est la différence entre lire une ligne et passer une soirée à chercher un bug dans un fichier qui n'en a pas. Afficher les détails indique quel enregistrement et quel package le contient actuellement.

Un nombre se trouve à côté de cette somme au lieu d'être à l'intérieur : des fichiers que personne n'a lus. Un fichier dont la famille n'est pas dans content_types n'a jamais été ouvert, il n'y a donc aucun enregistrement à compter et il n'y a aucun moyen de savoir combien il y en a. Il s'agit d'un décompte de fichiers, pas d'enregistrements, et c'est exactement pourquoi il ne peut pas s'agir d'un sixième terme : la somme commence à partir de lecture, et ceux-ci n'ont jamais été lus.

Avant de demander de l'aide à quelqu'un

Ouvrez Mod et appuyez sur Copier le rapport. Collez tout dans votre message, puis dites ce à quoi vous vous attendiez.

Texte simple, prêt pour un forum, un message Discord ou un rapport de bug : la version sur laquelle vous vous trouvez, le dossier mods, chaque package avec sa version, son ordre de chargement et son statut, la raison de chaque rejet, le nombre de comptes pour chaque type de contenu et quel package a remporté chaque conflit.

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

Neuf fois sur dix, la réponse est dans le bloc et personne n'est obligé de vous poser une seule question en premier. Il ne lit rien en dehors du dossier mods, ne change rien et ne contient aucune information personnelle.

Il est en anglais même lorsque vous jouez dans une autre langue. C'est intentionnel : la personne qui vous aide ne peut pas lire le vôtre, et tous les faits qu'il contient (identifiants, versions, comptes) sont toujours les mêmes dans toutes les langues.

Supprimez-en un

Supprimez son dossier et redémarrez. La désinstallation est là.

Rien de vous n'est supprimé avec. Une sauvegarde conserve les identifiants qu'elle ne peut plus résoudre, les marque et renvoie des éléments si le package est réinstallé. Une session qui ne comprend pas une sauvegarde ne l'écrase même pas : le fichier original reste exactement tel qu'il était, et c'est la différence entre un après-midi perdu et une partie perdue. Saves est le rapport complet.

Si le jeu ne fonctionne plus après avoir installé quelque chose, la sortie n'a pas besoin du jeu. Ouvrez le dossier mods et supprimez la dernière chose que vous avez ajoutée. Les packages ne peuvent être lus qu'à partir de ce dossier, donc un dossier qui n'existe pas est un package qui ne peut pas être chargé, et le prochain démarrage est le même qu'avant. Vous n'avez pas besoin d'un menu fonctionnel, d'une console ou d'un démarrage pour ce faire.

Même le jeu essaie tout seul — Si le jeu ne démarre pas c'est un nombre limité de tentatives, puis un retour sans aucun paquet chargé — mais c'est la ceinture, et déplacer le dossier est les bretelles.

Ce que vous pouvez construire aujourd'hui

Maintenant, sans demander à personne : les marchandises et les marchands qui les vendent, les objets, les personnes et leurs positions, les bâtiments et leurs services, les lieux de la carte, les conversations, les scènes, les plans de quête, les cartes dessinées dans Tiled, les images et les couleurs, ainsi que tous leurs textes en sept langues. Les fichiers audio et de police sont vérifiés et lus, mais leurs surfaces de package ne sont pas encore consommées ; le tableau de statut le dit au lieu de les appeler prêts. Toutes les familles constituent la liste mesurée, et leur statut vient du build plutôt que d'une promesse.

Pas encore, et Ce que vous ne pouvez pas encore faire explique chaque cas : la famille quests, l'audio de package, les polices de package, les conversions totales empaquetées et un package qui serait une fonctionnalité plutôt que du contenu.

Jamais, en raison du choix du projet : code. Pas de scripts, pas de scènes, pas de fichiers de ressources, rien pour exécuter le jeu. C'est ce qui permet de télécharger en toute sécurité le mod d'un étranger, et ce n'est pas une phase que traverse le projet. Ce qu'un mod ne peut jamais faire.

Temps jusqu'à la première chose que vous pouvez voir dans le jeu : Une dizaine de minutes, principalement consacrées à la recherche du dossier. Un mod en dix minutes est complet et l'épée à la fin est réelle.

Ce que vous ne pouvez pas encore faire et pourquoi

Écrit ici, près du début, plutôt que laissé à découvrir en quittant la page. Voici ce que le build valide sans le placer actuellement sur une surface de package destinée au joueur, ainsi que ce qui n'est pas du contenu de package.

Une mécanique que le jeu n'a jamais eu est la quatrième rangée avec un autre chapeau. Une épée qui frappe plus fort est un nombre et c'est le vôtre ; une arme qui tire un faisceau a besoin des règles du faisceau, et les règles sont du code que quelqu'un écrit et teste.

Qu'est-ce qu'un mod

Un dossier de fichiers texte. Vous n'écrivez pas de code. Vous écrivez des listes de choses que vous voulez dans le jeu, et le jeu les lit au démarrage.

La seule règle dont découle tout le reste : vous pouvez ajouter et modifier des données. Vous ne pouvez pas faire en sorte que le jeu exécute du code. C'est ce qui rend le téléchargement d'un mod sûr : le pire qu'un mod étranger puisse faire est de vous lancer une épée idiote.

34 familles prêtes à l'emploi, dont items, buildings, pois, npc_definitions, vendor_inventories, quest_plans, caravans et perks. Toutes les familles forment le tableau complet avec ce que chacune permet ; Les familles, une par une donne pour chacune ses champs et un enregistrement à copier.

Choisissez votre chemin

Voici la table des matières de l'intégralité du guide — où chaque sujet est abordé, que vous le construisiez aujourd'hui ou non. En haut de la partie 3 se trouve un deuxième index, plus court : il s'agit des six didacticiels, dans l'ordre où ils s'appuient les uns sur les autres. Si vous êtes ici pour faire quelque chose et non pour chercher quelque chose, allez-y directement.

Ou pour ce qui vous passe par la tête. Ces conseils sont organisés dans l'ordre dans lequel le travail se déroule (manifeste, puis validation, puis contenu, puis rapport), ordre que choisirait une personne connaissant déjà le système. Ceux qui ne le savent pas pensent Je veux ajouter un commerçant, et cherchent le mot commerçant :

De quoi avez-vous besoin

Un éditeur qui colore JSON vous montre une virgule manquante pendant que vous le regardez encore, au lieu que le jeu vous dise plus tard que le fichier était illisible.

Python et la console sont facultatifs. Le jeu suffit : placez le package, redémarrez et ouvrez Mods, qui indique chaque enregistrement refusé et pourquoi. Le checkout destiné aux auteurs est public. Ceux qui veulent itérer plus vite ou automatiser la publication peuvent cloner le checkout public de Bonemark et exécuter les outils hors ligne dans Outils hors ligne ; les joueurs qui installent un package publié n'ont besoin ni de Python ni de Godot. Ce même checkout public contient le validateur et les déclarations du runtime, les deux sections décrivent donc une seule chaîne d'outils. Les outils utilisent les mêmes déclarations que le jeu — les schémas d'enregistrement et la limite de sécurité ont chacun une source unique — et donnent donc une réponse plus tôt, jamais différente. Une console de débogage aide à inspecter un package chargé, mais elle n'est pas nécessaire pour en écrire un.

Commencez par ce que vous voulez faire

Tout ce qui se trouve en dessous de cette ligne est classé dans l'ordre dans lequel le travail se déroule : affiche, puis dossiers, puis familles, puis rapports. C'est le bon ordre pour chercher quelque chose et le mauvais pour commencer, car personne ne commence par un manifeste. Cela commence par Je veux un marchand.

Ensuite : choisissez la phrase qui ressemble à ce que vous essayez de faire.

Les six tutoriels forment un seul paquet, construit pièce par pièce : une bougie en cire d'abeille, le paquet qu'un joueur emporte avec lui, le cirier qui le vend, la porte de sa boutique, la fosse derrière la tannerie d'où vient le suif, et enfin une modification de la bougie que le jeu possédait déjà. Faites-les dans l'ordre et obtenez un mod que quelqu'un pourrait télécharger. Mettez-en un au milieu et cela fonctionnera tout seul.

Où sont les numéros de jeu

Chaque tutoriel ici évalue une nouvelle chose en la comparant à quelque chose que le jeu vend déjà, car un nombre sans rien à côté est une supposition, et une supposition dans une économie qui fait du commerce entre les villes ne reste pas là où vous la mettez.

Vous ne pouvez pas ouvrir les fichiers du jeu. Ses enregistrements sont des actifs Godot à l'intérieur de la version emballée — un format différent de celui du JSON que vous écrivez, avec category = 1 où votre fichier indique "MANUFACTURED". Il n'y a pas de dossier à partir duquel copier, et en décompresser un n'est pas un flux de travail que quiconque doit documenter.

Vous n'en avez pas besoin. Le catalogue publie le contenu du jeu, généré à partir de ces mêmes enregistrements à chaque construction : 270 objets avec leur catégorie, leur poids, leur valeur de pièce et la taille de leur pile, 49 armes, 42 pièces d'armure, 37 emplacements. C'est la référence à laquelle ce guide est ancré, il ne peut s'écarter du jeu, et le nom du terrain est imprimé à côté de chaque ligne.

Une douzaine de valeurs à connaître avant de mettre un prix sur quelque chose :

Si votre nouveau produit coûte plus cher qu'une armure de plaques, quelque chose s'est mal passé et le jeu ne vous le dira pas - il deviendra silencieusement la cargaison la plus rentable au monde et chaque caravane la transportera.

Une marchandise à vendre

Vous aurez une marchandise que l'économie sait évaluer, liée à la bougie que le jeu vend déjà, prête à être détenue par un commerçant.

Capture d'écran : Pas encore prise. Cet espace reste vide jusqu'à ce qu'il y en ait un réel : un dessin de ce à quoi il pourrait ressembler serait la seule chose sur la page qui ne soit pas réelle.

Lisez d'abord : [Qu'est-ce qu'un mod](#qu'est-ce qu'un mod-est) · Un mod en dix minutes · Noms et identifiants

Copier depuis : le dossier appelé chandlery, qui se trouve déjà dans votre dossier mods. Le jeu le met là au premier démarrage, éteint, et c'est le résultat final de ces six tutoriels : chaque enregistrement ci-dessous est là. C'est également le package que la ligne de test du référentiel fait tourner contre le chargeur, il n'y a donc aucun enregistrement ici que le jeu rejetterait. Allumez-le pour le voir fonctionner, ou copiez le dossier, renommez-le et personnalisez-le.

Où vont les fichiers :

where the files go

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

Partez de la bougie que le jeu possède déjà. Elle s'appelle candle, elle coûte 3, elle pèse 0,5, c'est MANUFACTURED et PRESERVED, et elle est fabriquée par l'apothicaire. Le vôtre est le même objet fait d'une meilleure cire, alors gardez toutes ces réponses et changez-en deux.

D'abord 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
}

Ensuite 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"]
  }
]

Terminé — trouvez-le maintenant dans le jeu. Redémarrez, ouvrez Mod et la ligne en dessous de la vôtre indique 1 entry added. C'est tout ce qu'une marchandise fait par elle-même : elle a un prix, elle est commercialisable et elle ne se trouve sur le comptoir de personne, car personne ne l'a encore. Ce n’est pas un échec et c’est ce qui déroute tout le monde une fois. Continuez avec Un commerçant qui le détient.

Si non affiché : Rien n'est affiché a les six raisons dans l'ordre. Le plus courant est de loin content_types : une famille manquante sur cette ligne signifie que le dossier n'est jamais ouvert, quel que soit son contenu. Ensuite, [Avant de demander de l'aide à quelqu'un](#avant-de-demander-de-l'aide à quelqu'un), qui est un seul bouton.

Un objet à transporter

Vous aurez la chose qu'un joueur collectionne, empile dans son sac à dos et revend, couplée aux biens que vous venez de a écrit.

Capture d'écran : pas encore prise.

Lire en premier : Un bien à vendre · Noms et identifiants

Copier depuis : chandlery/content/inventory/items/items.json dans votre dossier mods.

Où vont les fichiers :

where the files go

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

Un bien et un objet, ce sont les deux moitiés de la même chose. La marchandise est le point de vue de l'économie : ce qu'une ville produit, ce qu'une caravane transporte, combien elle vaut. L'objet est le point de vue du joueur : ce qui rentre dans le sac à dos, ce qui est empilé, ce qui est exposé dans un magasin. Le blé est une marchandise et aucun objet, car personne ne transporte un sac de blé. Les bougies ont les deux.

Ajoutez "items" à content_types dans mod.json, puis écrivez 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"]
  }
]

Terminé — trouvez-le maintenant dans le jeu. Un objet qui personne ne livre est chargé et accessible à partir de rien. Dans une version de débogage, item chandlery:beeswax_candle_bundle en met un immédiatement dans votre sac à dos, et c'est la preuve la plus rapide qu'il est chargé - mais cette commande n'existe pas dans le jeu que les gens téléchargent, c'est donc un raccourci pour vous et jamais la réponse pour un joueur. La vraie réponse est le tutoriel suivant.

S'il n'apparaît pas : [Rien n'est apparu](#rien-est apparu), alors [Avant de demander de l'aide à quelqu'un](#avant-de-demander-de-l'aide-à-personne).

Un commerçant qui le garde

Vous aurez une femme avec un nom affiché à Old Seat avec un comptoir, des fournitures réapprovisionnées tous les deux jours et vos bougies sur le comptoir.

Capture d'écran : pas encore prise.

À lire en premier : Un objet à transporter · Trouvez-le maintenant dans le jeu

Copier depuis : chandlery/content/narrative/npcs/npcs.json et chandlery/content/world/vendor_inventories/vendors.json.

Où vont les fichiers :

where the files go

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

C'est celui où deux familles doivent s'entendre. La personne porte l'identifiant de la banque, la banque porte l'identifiant de la personne et chaque ligne de la banque porte l'identifiant d'un objet. Trois identifiants, et chacun doit être écrit exactement comme vous l'avez écrit dans l'autre fichier. C'est l'erreur qui coûte une soirée, et l'écran Mods la nomme : une ligne pointant vers un identifiant que personne ne fournit est répertoriée comme nécessite un autre mod qui n'est pas installé.

Ajoutez "npc_definitions" et "vendor_inventories" à content_types.

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
      }
    ]
  }
]

Terminé – trouvez-le maintenant dans le jeu. Redémarrez, voyagez vers Old Seat, trouvez Hesta, ouvrez l'écran de trading. Si la banque est vide, c'est qu'elle n'a pas encore été réapprovisionnée : c'est restock_days, pas un bug. La chaîne peut être brisée de trois manières et toutes les trois sont sur l'écran du Mod : les marchandises que personne ne détient, le compteur qui pointe vers un identifiant d'article qui n'existe pas, la personne qui pointe vers un identifiant de compteur qui n'existe pas.

Elle peut aussi parler. Un dialogue_graph dont speaker est son identifiant lui donne des plaisanteries lorsqu'un joueur clique dessus, et votre package n'a pas besoin de redéfinir quoi que ce soit que le jeu a déjà pour les obtenir - voir [Vos conversations] (#conversations-of-your-own). Un fichier locales vous donne tout cela en sept langues.

Si rien ne s'affiche : vérifiez d'abord les trois identifiants les uns par rapport aux autres, puis Rien ne s'est affiché, puis [Avant de demander de l'aide à quelqu'un](#avant de demander de l'aide à quelqu'un).

La desserte d'un immeuble

Vous aurez une porte dans une colonie avec votre étiquette et votre couleur dessus, qui s'ouvre sur un intérieur que le jeu possède déjà.

Capture d'écran : pas encore prise.

À lire en premier : Un marchand qui le garde · [Ce qu'un mod ne peut jamais faire](#ce qu'un mod-peut-ne-jamais-faire)

Copier depuis : chandlery/content/world/buildings/buildings.json.

Où vont les fichiers :

where the files go

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

Vous recombinez, pas construisez. Un enregistrement buildings ajoute un nouveau service avec une étiquette, une couleur de port et un rôle de routine, et peut réutiliser une extension que le jeu possède déjà en la nommant. Impossible d'apporter une prolongation. Une extension est une scène, une scène est du code, et un paquet nommant un chemin res:// ou un .tscn est rejeté avant même que cet enregistrement ne soit lu. Ce n'est pas un trou qui attend d'être comblé : c'est la ligne qui permet d'installer en toute sécurité le mod d'un étranger.

a buildings record

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

Terminé – trouvez-le maintenant dans le jeu. Redémarrez et entrez dans une colonie qui a votre service. Un enregistrement sans settlement est chargé et placé nulle part, ce qui est identique à un enregistrement raté : l'écran Mod dira 1 entry added et vous ne trouverez rien. Lisez la ligne avant de chercher la porte.

Si elle n'apparaît pas : [Rien n'apparaît](#rien-est apparu) · [Avant de demander de l'aide à quelqu'un](#avant-de-demander-de-l'aide-à-personne).

Un endroit sur la carte

Vous aurez un point sur la carte du monde qu'un joueur peut rencontrer, avec sa propre description et son effet sur l'humeur de l'entreprise.

Capture d'écran : pas encore prise.

Lire en premier : Le service de construction · Maintenant, trouvez-le dans le jeu

Copier depuis : chandlery/content/world/pois/pois.json.

Où vont les fichiers :

where the files go

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

Les coordonnées sont absolues et le monde est généré autour de lieux créés par les auteurs. La carte mesure 61 440 × 34 560 pixels du monde et Old Seat se trouve exactement au centre, (30720, 17280), dans chaque partie. Les villes et villages créés par les auteurs gardent leurs noms et leurs positions. La seed change le terrain et les biomes autour d'eux, la pénurie de l'année, l'organisation politique et les routes qui valent la peine d'être prises. Un point reste donc un emplacement réel et stable ; ce qui se trouve à côté change à chaque partie. Deux façons honnêtes de l'utiliser : ancrer un point près d'une colonie créée par les auteurs, pour qu'un joueur le traverse ; ou choisir le vide, car une fosse de rendu que personne n'a visitée depuis des années est censée être nulle part en particulier.

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
  }
]

Terminé – trouvez-le maintenant dans le jeu. Allez-y. Il n'y a pas de commande de téléportation, que ce soit dans une version de débogage ou à l'extérieur, alors choisissez les coordonnées aussi loin que vous êtes prêt à marcher pendant que vous essayez.

S'il n'apparaît pas : Vous n'avez probablement plus de discovery_radius, ou l'emplacement est quelque part où la graine de match a placé un océan. [Rien ne s'est présenté](#rien-s'est présenté).

Changer ce qui est déjà là

Vous aurez modifié un enregistrement apporté par le jeu — et vous l'aurez déclaré, afin que le changement soit visible par le joueur et tous les autres mods.

Capture d'écran : pas encore prise.

À lire en premier : Changer ce que le jeu a déjà · Quand deux mods veulent la même chose

Copier depuis : chandlery/content/economy/goods/goods.json, qui ajoute un enregistrement et corrige celui du jeu dans le même fichier.

Où vont les fichiers : Nulle part nouveau. Une modification apportée à quelque chose que le jeu possède déjà se trouve dans le même dossier familial dans lequel se trouvent vos enregistrements - le fichier indique quel enregistrement il vise et ce qu'il lui fait.

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

Deux règles avant le fichier. Une modification apportée à l'enregistrement de quelqu'un d'autre doit être nommée dans overrides à l'intérieur de mod.json — un enregistrement qui atterrit sur un identifiant que vous n'avez pas déclaré est rejeté, donc rien ne peut réécrire secrètement quelque chose que le joueur n'a pas accepté. Et patch, qui modifie un champ et laisse le reste tranquille, nécessite "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" }
    ]
  }
]

Terminé — trouvez-le maintenant dans le jeu. L'écran Mod nomme l'enregistrement que vous avez acquis. L'écran de l'autre auteur fait la même chose, s'il y en a un : lorsque deux paquets écrivent le même identifiant, la ligne du perdant indique désormais remplacé : bougie — 'chandlery' l'écrit en dernier, au lieu d'afficher silencieusement une entrée de moins que celle qu'il a écrite. Celui qui a le load_order le plus élevé écrit en dernier et gagne.

Gagner n'est pas la même chose qu'avoir la permission. Deux paquets prenant un enregistrement sans que l'un ou l'autre nomme l'autre dans supersedes sont signalés comme undeclared_collision et la composition n'est pas correcte : le validateur hors ligne dit la même chose et rejette :

typed into the debug console

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

Le gagnant est toujours calculé, car un rejet ne doit pas nécessairement être un tirage au sort, mais deux auteurs qui le souhaitaient tous deux doivent le dire. Quand deux mods veulent la même chose est cette conversation.

Si elle n'apparaît pas : la cause habituelle est overrides — l'identifiant doit être dans cette liste, écrit exactement, sinon l'enregistrement est rejeté au lieu d'être appliqué. Quand deux mods veulent la même chose · [Rien ne s'est affiché](#rien-s'est montré).

Un mod en dix minutes

1. Créez un dossier dans votre dossier mods, avec le nom en minuscules et traits de soulignement : northern_reach. Tout se passe là-dedans.

2. Écrivez mod.json en haut :

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 doit correspondre au nom du dossier. content_types répertorie les familles que vous apportez — une famille manquante sur cette ligne n'est jamais lue, peu importe ce qu'il y a dans le dossier.

3. Créez les dossiers content/inventory/items et placez-y blades.json:

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
  }
]

. Les crochets sont une liste : ajoutez autant d'épées que vous le souhaitez, séparées par des virgules. Chaque fichier .json d'un dossier familial est lu, alors divisez-les comme bon vous semble.

240 n'est pas un nombre choisi pour impressionner. Les armes à une main dans ce jeu vont de 50 à 300, donc une lame de givre à 240 est une épée coûteuse et non une épée légendaire, et un joueur peut se le permettre à peu près autant qu'il pourrait se permettre les bonnes lames que le forgeron vend déjà. Où sont les numéros du jeu est le tableau à consulter avant de choisir un numéro ; un prix sans rien à côté est une hypothèse, et dans une économie qui fait du commerce entre les villes, une hypothèse ne reste pas là où vous la mettez.

4. Lancez le jeu et ouvrez Mods depuis le menu principal. Votre package obtient exactement un statut, et Est-ce qu'il s'est chargé ? a les six.

5. Lisez la ligne ci-dessous pour découvrir ce qui a été lu, appliqué et rejeté, avec la raison de chaque rejet. Afficher les détails a l'id.

6. Votre épée est dans le jeu. Tout ce qui vient après est à peu près pareil.

Trouvez-le maintenant dans le jeu

Le rapport indique applied. Cela veut dire que le disque est chargé, et ce n'est pas la même chose que de pouvoir marcher devant. C'est ici que chaque guide s'arrête et chaque auteur commence à deviner.

settlement_id désigne un lieu créé par les auteurs. Les identifiants de colonie sont créés par les auteurs et stables : Durnwall, Thorngate, Valdmere, Grentham et les douze villages peuvent tous être nommés. La seed change le terrain et les biomes autour d'eux, la pénurie de l'année et l'organisation politique, pas l'identifiant. Si vous voulez qu'une personne soit certainement rencontrée, utilisez n'importe quel identifiant de colonie créé par les auteurs et gardez son nom dans les données de langue de votre package.

Les coordonnées sont absolues et le monde est généré autour de lieux créés par les auteurs. La carte mesure 61 440 × 34 560 pixels du monde et Old Seat se trouve exactement au centre, (30720, 17280), dans chaque partie. Les villes et villages créés par les auteurs gardent leurs noms et leurs positions. La seed change le terrain et les biomes autour d'eux, la pénurie de l'année, l'organisation politique et les routes qui valent la peine d'être prises. Ainsi, une world_position de (6000, 2200) reste un point réel et stable dans le nord-ouest lointain de la carte, tandis que ce qui se trouve à proximité change à chaque partie : route, forêt ou plein milieu de nulle part. Deux façons de l'utiliser honnêtement :

• Toujours au centre.Un point d'intérêt situé à quelques milliers de pixels (30720, 17280) se trouve à proximité du vieux siège dans chaque jeu, c'est donc un endroit qu'un joueur trouvera.
• Vous voulez dire le vide. Une ruine par laquelle personne n'est passé depuis cent ans doit être quelque part. Les coordonnées absolues sont exactement bonnes pour cela, et la graine décidera quels voisins elle aura.

Les commandes de console qui font gagner le plus de temps. day [n] et hour [n] avancent le temps, et c'est ainsi que vous voyez un approvisionnement sans en faire l'expérience. item <id> [count] et gold <amount> mettent les choses entre vos mains. flag, quest_start et faction_rep déplacent l'état qu'une condition peut attendre. Il n'y a pas de commande de téléportation : pour vous rendre à un endroit, voyagez-y.

mod.json, champ par champ

A peut être un objet au lieu d'un nom : {"id": "some_mod", "version": "", "optional": true}.

Une valeur qui nomme un autre package est une référence cross-mod, et la référence doit être une dépendance déclarée. Si cette dépendance est facultative, attribuez au champ un fallback, sinon l'enregistrement est ignoré lorsque la dépendance est absente :

a goods record

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

Où va chaque fichier

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

Noms et identifiant

Un identifiant est constitué de lettres minuscules, de chiffres et de traits de soulignement, et rien d'autre. frost_blade, pas Frost Blade, pas frost-blade et pas frost.blade. Il ne comporte même pas son propre séparateur, car un séparateur à l'intérieur d'un identifiant est le dossier qui s'infiltre dans le nom : déplacez le fichier et l'identifiant ne correspond plus au disque. Les : ci-dessus sont la seule exception, et les deux moitiés suivent la règle.

La partie avant les deux points est l'identifiant de votre package. C'est ainsi que deux mods peuvent tous deux ajouter une Frost Blade sans entrer en collision.

Mots qu'un joueur lit

Le texte écrit dans un enregistrement est un texte en une seule langue. Au lieu de cela, il pointe vers une clé :

a locale CSV

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

Les clés sont en minuscules, reliées par des points, avec l'espace de noms comme identifiant. Introduire des mots dans la famille locales — un .csv sous content/locale avec une colonne key et une colonne de langue. Les familles, une par une a la forme exacte.

Écrivez également le simple display_name à côté de la clé. Un enregistrement qui ne contient qu'une seule phrase doit être réécrit à la main le jour où vous le traduisez, et il y en aura alors quatre cents.

Les deux façons de se tromper échouent de manières très différentes, et une seule des deux vous l'indique. Une clé qui ne répond à rien apparaît comme la clé elle-même - northern_reach.item.frost_blade.name, sur l'écran, délibérément laide pour que quelqu'un la répare, et comptée comme un trou. Un enregistrement contenant uniquement du texte et aucune clé n'apparaît jamais : il fonctionne, dans votre langue, pour chaque joueur et dans toutes les langues. Rien n'est rejeté et rien ne manque, donc rien ne le signale, et un joueur lisant en portugais lit silencieusement votre italien. Vous trouvez la première erreur. Le second trouve vos lecteurs.

Traduire un mod et être traduit

Le jeu sort en sept langues, donc un paquet avec l'anglais intégré dans les archives se lit en anglais pour les six septièmes de ceux qui l'installent. C'est ce qu'il en coûte pour l'éviter, c'est-à-dire presque rien si vous le faites le premier jour et une réécriture si vous le faites le quatre centième.

Les langues qui sont là

Sept, et ce tableau est lu à partir de la construction plutôt que manuscrit ici, donc une langue qui arrive ou qui part le déplace sur le même jour :

Deux des codes ont une deuxième orthographe en circulation - pt-BR est celui qu'ils utilisent dans une vitrine numérique et cette page, pt_BR est celle à laquelle le moteur se conforme - et dans un en-tête de colonne, les deux sont accepté. Écrivez celui que vous avez copié.

Portant des mots dans plusieurs langues

A CSV sous content/locale, avec key en premier et une colonne par langue :

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

Lorsqu'une clé n'a pas de réponse dans la langue du joueur, le jeu descend une échelle fixe : la langue du joueur, puis la langue dans laquelle votre package prétend avoir été écrit, puis le catalogue du jeu, puis la clé elle-même. La dernière étape est volontairement moche : une clé non résolue doit avoir une mauvaise apparence pour que quelqu'un puisse la réparer. Une conversion totale ignore le catalogue du jeu, car Old Seat faisant surface dans un monde se déroulant sur un autre continent n'est pas un petit oubli de traduction, c'est le jeu de base qui transparaît.

Écrire un texte pouvant être traduit

• Aucune phrase construite en morceaux. L'ordre des mots n'est pas le même dans toutes les langues, donc un nom assemblé lors de l'exécution à partir d'une colonne d'adjectifs et d'une colonne de noms produit Oro Cervo en italien. Une entrée écrite pour chaque langue, complète.
• Le nom d'une personne n'est jamais traduit ni fléchi. Aldric est Aldric dans toutes les langues. Ce qui signifie aussi qu'une touche ne doit pas mettre un nom en position oblique — "of {name}", "{name}'s" — car de nombreuses langues déclinent les noms propres et le jeu ne le fait pas.
• Il n'y a pas de limite de caractères, et ce n'est pas la même chose que de n'avoir aucune limite. Aucun champ ne compte les caractères ; ce qui finit par être de l'espace à l'écran. L'allemand est environ un tiers plus long que l'anglais et est la langue la plus utilisée ; le chinois est beaucoup plus petit et ne le fait presque jamais. Si vous essayez une seule traduction, essayez l’allemand et attribuez à une étiquette la formulation la plus courte qui soit encore correcte.

Quelqu'un qui traduit votre colis

Ajoute une colonne et vous renvoie le fichier. Le flux de travail est là, et c'est pourquoi le format est CSV au lieu de quelque chose de plus convivial pour un programmeur : un traducteur peut l'ouvrir dans une feuille de calcul, et ses outils le lisent déjà.

Deux choses font la différence entre un package traduit et un autre non. Gardez les clés stables — une clé renommée est une traduction perdue, et le traducteur le découvre lorsqu'un joueur le découvre. Et dites à quoi sert une ligne : une clé appelée NR_MSG_01 obtient une supposition, tandis que northern_reach:VENDOR_HERB_GREETING reçoit le message d'accueil d'un vendeur d'herbes.

Si c'est vous qui traduisez le paquet de quelqu'un d'autre, les mêmes règles vous lient : les colonnes sont les langues que porte le jeu, les clés sont ses clés et non les vôtres, et un nom reste un nom.

Changer ce que le jeu a déjà

part of mod.json

"overrides": ["iron_sword"]

overrides est une promesse. Un enregistrement qui atterrit sur un identifiant que vous n'avez pas déclaré est rejeté, vous ne pouvez donc jamais modifier silencieusement quelque chose qu'un joueur ne connaissait pas. rien.

a goods record

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

Un patch nomme ses modifications une par une :

• set — Écrit value dans field, tout ce qui s'y trouvait auparavant. Il s'écrit avec field et value.
• unset — Supprime field de l'enregistrement afin que le lecteur voie la valeur par défaut de la famille. Il est écrit avec field.
• append_unique — Ajoute value à la liste dans field si ce n'est pas déjà fait. Il s'écrit avec field et value.
• remove_value — Supprime chaque occurrence de value de la liste dans field. Il s'écrit avec field et value.

• Nommez un champ par chemin, jamais par emplacement. tags.0 est rejeté. La troisième étiquette d'aujourd'hui est la deuxième après avoir chargé le mod de quelqu'un d'autre.
• Un chemin peut contenir jusqu'à quatre noms minuscules joints par des points. Tout ce qui contient un opérateur est rejeté.
• append_unique est celui que deux mods peuvent partager. S'ils ajoutent tous les deux la même étiquette, ce n'est pas un conflit et ce n'est pas le cas. doubles.

Seulement parfois, l'enregistrement

A peut indiquer quand cela vaut la peine. Ajoutez un when à côté du op, dans un package avec "manifest_version": 2:

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" } }
}

Il n'y a aucun opérateur et rien à calculer. Tout ce qu'une condition peut dire se trouve dans ces deux tableaux.

Maximum quatre sujets dans un when, deux essais par sujet. Deux tests sur le même sujet forment un intervalle : { "day": { "at_least": 10, "at_most": 30 } }.

Quelle famille prend quoi. Chaque famille prend les trois décidées à charger. Seuls presentation_bindings et effects prennent les quatre qui bougent en jouant, car seuls ces deux-là sont reconstruits lorsque le monde change. La nomination de season ailleurs est rejetée et le message indique les sujets que cette famille prend réellement.

La raison en est les sauvetages. Un enregistrement qui décide d'un objet, d'une personne ou d'une mission doit être le même enregistrement lors du prochain chargement, et une condition qui bouge est exactement ce qui l'empêche de le faire.

Un aspect saisonnier va sur le lien, pas sur l'image. Apportez l'image une seule fois, puis deux enregistrements presentation_bindings pour elle : un avec un when, un sans. images, audio et fonts rejettent un when sans discussion.

La retenue n'est pas rejetée. Une condition non satisfaite détient son record et le rapport de charge l'indique nommément :

what the game prints back

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

Un package avec cinquante enregistrements, les travailleurs saisonniers sont retenus pendant les trois quarts à tout moment. C'est le package qui fonctionne.

Si chaque association de présentation conditionnelle est refusée, le rapport montre toujours la famille telle que déclarée et imprime bound=0 avec chaque ligne WITHHELD ; ne signale pas à tort que l'emballage n'a pas de surface de présentation. Si aucune liaison inconditionnelle ne fournit le même emplacement, elle imprime également NO_APPLICABLE kind/subject/slot avec la condition sans réponse, ce qui signifie « rien ne s'applique dans cet état du monde », et non « l'enregistrement n'était pas valide ». Testez la condition dans la voie de l'hôte ou de l'exécution avec l'état mondial correspondant avant de supposer que l'association a été rejetée.

Deux versions de la même chose. Apporte deux enregistrements add avec le même identifiant et des conditions différentes. Celui dont l'état tient est celui qui charge. Si les deux sont valables, le second est rejeté en tant que doublon – c'est ainsi que les conditions qui se chevauchent sont signalées au lieu d'être résolues par l'ordre des fichiers.

Supprimer quelque chose

remove signifie discontinué, et non hors d'existence. Le record continue de se résoudre et de se marquer : rien de nouveau n'est plus proposé, conservé en stock, fabriqué ou généré par lui, et tout ce qu'un joueur possède déjà et qui le nomme continue de lire exactement ce qu'il a toujours lu.

a goods record

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

vendor_inventories est la seule famille qui supprime l'enregistrement, et uniquement parce que les règles de sauvegarde indiquent déjà que personne ne pointe vers cette ligne.

Un remove ne peut pas transporter un when. Un retrait qu'un sauvetage pourrait nommer doit être décidé, sinon une ça se résout un soir et pas le lendemain.

Une suppression est permanente pour une composition. Un patch, replace ou un deuxième remove ciblant l'ID retiré est rejeté, même si un rappel de marchandises permet de résoudre l'ancien enregistrement grâce à sa suppression permanente. Cela empêche le rapport de sauvegarde d'indiquer « retraité » alors qu'un package ultérieur fait en sorte que l'enregistrement se comporte à nouveau comme fourni. Ajoutez un nouvel ID d'espace de noms lorsque vous avez besoin d'un nouvel enregistrement ; Ne comptez pas sur la suppression suivie d'une résurrection silencieuse.

Quand deux mods veulent la même chose

Ils chargent tous les deux. Chaque changement est composé avant que quoi que ce soit ne soit construit, donc le jeu voit les deux.

Gagner et obtenir la permission sont deux questions différentes, et c'est ce qui est surprenant. Le jeu calcule toujours quel paquet il écrit en dernier – le laisser au hasard ferait même un tirage au sort un rejet – et signale toujours la paire comme une collision que personne n'a déclarée. Le validateur hors ligne rejette la même paire sans discussion, vous vous informez donc avant un joueur.

supersedes dans votre manifeste est votre façon de dire que vous l'avez fait exprès. Nommez l'identifiant de l'autre paquet et le conflit devient declared_replacement : enregistré, avec raison, et non plus une erreur.

Donnez à votre package un load_order qui lui est propre. Deux packages partageant un numéro ne sont pas rejetés, puis le gagnant ne sort plus de l'ordre alphabétique de l'identifiant du mod : un ordre qu'aucun des auteurs n'a choisi et qu'aucun joueur ne peut lire à l'écran.

Images, sons, écritures, couleurs

Apporter un fichier et l'utiliser sont deux étapes distinctes et vous avez besoin des deux. Un fichier vers lequel rien ne pointe est lu, vérifié, mesuré et jamais affiché.

Apportez le dossier

Chaque famille de ressources est un descripteur de fichier ainsi que les fichiers qu'il nomme. Le descripteur doit être nommé comme sa famille : 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"
  }
]

Trois règles qui mordent :

• L'en-tête est vérifié avant que quoi que ce soit ne le décode. format est ce que est le fichier, pas ce que prétend l'extension.
• Un nom de file qui contient .. ou ~, ou qui commence par /, \, res:// ou user://, est rejeté sur le nom.
• Un identifiant qui ne se résout pas reçoit un espace réservé et un avertissement, jamais de silence.

Pariez dessus

Sur un enregistrement que vous transportez, avec un champ qui reprend votre identifiant d'image :

Sur tout, y compris le contenu du jeu de base, avec un enregistrement presentation_bindings nommant le sujet, son type et son emplacement :

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 est obligatoire là où un slot porte une information : c'est la clé de langue qui dit la même chose à un joueur qui ne peut pas recevoir l'image.

Son

role est une limite, pas une étiquette : chacun a sa propre durée maximale, son propre plafond sur le nombre de joueurs jouant ensemble et le curseur qu'un joueur recherche.

Un WAV compressé est rejeté : son décodage nécessite un analyseur, et c'est précisément cet analyseur que vous évitez.

Écrits

covers nomme les langues pour lesquelles votre police contient des glyphes, et la version refuse de l'installer pour les autres. Un caractère manquant une langue n'échoue pas : dessinez des petits carrés, et l'écran se lit comme une traduction à moitié terminée, avec le bon texte et le défaut de la police.

fallback_font est obligatoire : nommez un autre identifiant de police de votre choix ou une famille de système (Segoe UI, Noto Sans). sizes est la base sur laquelle le cache de glyphes est calculé.

Un seul caractère, jamais une collection — un .ttc en contient plusieurs et celui qui arrive dépend d'un index que le descripteur ne peut pas porter. Polices gratuites avec une large couverture : Google Fonts, Font Squirrel. Vérifiez que la licence vous permet de redistribuer le fichier - votre package le contient.

Couleur

Des jetons, jamais une scène, un script ou un chemin de ressource. Les noms sont ceux du jeu : bg_deep, bg_mid, bg_button, bg_hover, border, border_hi, text, text_dim, accent, gold. Un nom que cette version ne connaît pas est mentionné dans le journal au lieu de rester là, semblant être appliqué.

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 sont vérifiés à un ratio de 4,5 et en dessous, le thème est rejeté. Le WebAIM Meter vous indique le ratio d'une paire avant de la porter.

Éteignez le package et l'interface reprend ses couleurs et ses écritures.

Un art qui fait du bien

Le build vérifie qu'une image est une image. Cela n'a rien à dire quant à savoir si cela semble correct, et dans un monde dessiné en gris, une épée brillante, joyeuse et haute résolution n'arrête pas de se tromper en passant tous les examens minutieux. C'est ce que l'on sait aujourd'hui.

Le guide de style complet n'est pas encore publié. Ce que cela apportera : la palette elle-même, les dimensions à dans lequel chaque type de chose est dessiné, et des exemples côte à côte de ce qui se trouve à l'intérieur du monde et de ce qui en sort. Cela vaut la peine d'attendre au lieu de deviner, car la panne qu'il évite n'est pas un fichier rejeté : c'est un package qui s'installe parfaitement et fait ressembler le jeu à deux jeux.

Tant qu'elle n'existe pas, la méthode fiable est celle qui ne nécessite aucun document : placez votre image à côté de celle du jeu et regardez-les ensemble.

Cartes your

Dessinez dans Tiled, exporte vers .tmj, et indexez-le vers 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"
  }
]

Un lien nommant le contenu d'un autre package - ou du jeu de base - entraîne le rejet de l'intégralité de la mise en page. modding_map_report nomme la disposition et la règle qui l'a rejetée.

Vosmissions

Une mission est un ensemble d'enregistrements qui n'ont de sens qu'ensemble, dans content/narrative/quest_plans.

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"]
  }
]

• Un plan, c'est tout ou rien. Un mauvais enregistrement et aucun n'est installé : l'alternative est un arc qui s'arrête à mi-chemin avec le joueur tenant l'épée et non le titre.
• Une récompense est un grant, jamais un kind. kind indique de quel enregistrement il s'agit. Une récompense écrite avec kind se lit très bien et est rejetée.

Vérifiez le vôtre avec modding_quest_plan_report.

Vos conversations

Une conversation, c'est trois types d'enregistrements dans content/narrative/dialogue : le dialogue_graph qui la nomme et dit sur quelle barre elle s'ouvre, les barres dialogue_node qui sont les lignes, et les choix dialogue_option qui se trouvent au-dessus.

Votre ligne est votre ligne, et rien ne la réécrit. Ce qu'un modèle local peut faire, c'est répondre à une question que le joueur écrit au personnage, en restant à l'intérieur de ce que dit votre ligne - et quand il ne peut pas rester à l'intérieur, il dit qu'il ne sait pas. C'est le joueur qui décide si cette surface existe ; avec le modèle éteint, le personnage prononce votre phrase et s'arrête. La traduction de votre blague provient des fichiers de langue, comme tout ce que vous écrivez.

Le graphique nomme un speaker et le déclencheur est là. Chaque personnage du jeu demande à cette famille quelles conversations se trouvent au-dessus d'eux lorsqu'on clique dessus, afin que vous puissiez donner quelque chose à dire au forgeron sans redéfinir le forgeron.

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"
  }
]

Vous écrivez la conversation, jamais les mots : chaque blague est une clé de langue, donc le même paquet peut être lu dans toutes les langues dont dispose le joueur. Un paquet contenant de la prose est rejeté dans le fichier au lieu d'être affiché à l'écran.

Une blague et un choix peuvent véhiculer chacune des conditions, et un choix peut véhiculer des commandes. Une condition décide si la chose est montrée au joueur ; un ordre, c'est ce qui arrive lorsqu'il le prend.

• Une conversation nommant quelque chose que cette version ne peut pas faire ne s'ouvre jamais. Pas le choix qui l'utilise : la conversation entière, avant sa première ligne. Une discussion qui s'arrête à la troisième option a déjà pris les pièces du joueur.
• Rien ne bouge plus qu'il n'y en a. Demandez d'abord avec has_coin ou has_item ; un paquet qui l'oublie ne peut pas mettre le joueur à moins quarante pièces, car personne n'a accepté de dette et aucun écran ne l'explique.
• Chaque blague a besoin d'une issue. Une blague à laquelle un joueur peut accéder et ne peut pas s'éloigner est rejetée lors du chargement du graphique.

Vérifiez le vôtre avec modding_dialogue_report.

Vos scènes

Une scène est le seul type de contenu qui enlève le contrôle au joueur, c'est donc aussi le seul avec une règle de fin. Les scènes vivent dans content/narrative/scenes et chacune nomme un where, l'endroit où elle est jouée. Entrez dans cet endroit et la scène commence.

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" }
    ]
  }
]

• Une scène qui supprime des contrôles doit les restituer. Une séquence qui se termine sans unlock_player est rejetée, car l'alternative est d'amener une pièce dont le joueur ne peut sortir qu'en fermant le jeu.
• Les lignes vont dans l'ordre et une ligne de blocage est attendue. C'est ce qui fait d'une scène une scène au lieu d'une liste de choses qui se produisent en même temps.

Vérifiez le vôtre avec modding_scene_report.

Vos captures d'écran

La disposition d'un écran vous indique quelles sections se trouvent dans quel panneau d'écran le jeu possède déjà et dans quel ordre. Il présente les pièces que cette construction dessine ; il ne peut pas en ajouter, car une section que personne n'a écrite n'a rien à dessiner.

Les dispositions résident dans content/ui/screens. Les familles, une à une comporte des champs et une fiche à copier.

Vérifiez le vôtre avec modding_screen_report.

Rien n'est apparu

Lisez d'abord l'état sur l'écran Mod. Presque tous les États évoquent ouvertement le problème, tout comme l’erreur la plus courante de toutes : celle qui figurait autrefois en tête de cette liste.

La famille absente de content_types. Vous écrivez goods.json, vous oubliez "goods" dans la liste des manifestes, et le dossier n'est jamais ouvert : rien n'est rejeté, car rien n'a été lu. Le paquet se charge vide. Maintenant, l'écran vous indique quel fichier il a parcouru et ce qu'il faut ajouter :

what the game prints back

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

Le validateur hors ligne imprime la même phrase, les deux ne peuvent donc pas être en désaccord. Seulement si la ligne indique chargé et ne nomme aucun fichier non lu, parcourez cette liste. Cela dépend de la fréquence à laquelle chacun est coupable.

Les rapports ne vous laissent jamais deviner. Un enregistrement rejeté est nommé, ce qui ne va pas et généralement avec un code — voir [Chaque code de diagnostic] (#every-diagnostic-code).

Il est apparu, et c'est faux

Le cas le plus difficile, car rien n’est signalé du tout. Deux choses passent tout examen minutieux et vous donnent quand même un disque que vous n'avez pas écrit.

Un champ que vous avez omis n'est pas une erreur : c'est une valeur par défaut. Le schéma de chaque famille vous indique les champs sans lesquels un enregistrement ne peut pas être installé, et pour presque toutes les familles, cette liste est courte. goods en nécessite exactement un : id. Omettez base_price et il vaut 1. Omettez weight et il vaut 1,0. Omettez category et le produit est une matière première. Rien ne vous alerte, car il n'y a rien de mal : vous avez demandé un bien et vous l'avez obtenu.

Même une valeur qui ne fait pas partie des choix est une valeur par défaut. Le lecteur met toutes les majuscules avant la recherche, donc manufactured et MANUFACTURED ont la même valeur et la majuscule n'est jamais le problème : ne commencez pas à réécrire les fichiers pour cela. Le problème est MANUFACTURED_GOODS : il n'est pas membre, il devient donc RAW_MATERIAL. SLOW pour un decay_tier devient ETERNAL. Le dossier s'installe, l'écran indique appliqué, et votre bougie a le prix et la périssabilité de quelque chose d'autre.

Rien dans le jeu ne dit cela, car il n'y a rien à dire : le champ est déclaré comme une chaîne, et une chaîne mal orthographiée reste une chaîne. Le validateur est le seul endroit où vous pouvez le prendre, et maintenant il le prend :

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

Un avertissement et non une erreur, car l'enregistrement se charge réellement et le rejeter maintenant endommagerait les packages qui fonctionnent déjà. --strict le transforme en erreur et c'est la seule raison pour laquelle vous exécutez --strict avant de publier.

Un champ que vous avez omis reste silencieux, et cela ne peut pas être pris : omettre category et écrire RAW_MATERIAL sont la même requête. Ainsi, les tables de champs dans Les familles, une par une marquent Obligatoire et donnent la colonne de valeurs comme la forme vérifiée par le chargeur. Lorsqu'un enregistrement se charge et se comporte comme autre chose, comparez d'abord vos champs à cette table : ce que vous recherchez est un champ que vous n'avez pas écrit ou un mot que le chargeur n'a pas reconnu.

Chaque famille

Un dossier et un rapport par famille. La colonne d'état est mesurée en fonction de la version, ce n'est donc jamais une promesse que le jeu ne tient pas. Ce que c'est n'est que la ligne d'ouverture, de sorte que le tableau reste quelque chose que vous pouvez parcourir avec votre œil ; la description complète de chaque famille, avec ses champs et une fiche à copier, est son entrée dans Les familles, une à une.

• Hors de la boîte — sous forme publiée, le jeu installe vos enregistrements, il y a un exemple, et vos identifiants survivent à une sauvegarde et un rechargement.
• Validé, rien ne le consomme encore — le chargeur lit et vérifie la famille, mais aucune surface de package destinée au joueur ne la consomme. Les packages audio et de police sont dans ce niveau : un rapport propre ne fait pas apparaître un signal silencieux ni une police inutilisée dans le jeu.
• Vérifié, pas encore installé — le jeu reconnaît la famille et vérifie votre fichier, et rien ne le met dans un jeu en cours. Un package qui le cible passe toutes les vérifications et ne charge rien. C'est volontairement sur la page : l'alternative est que quelqu'un y passe une soirée sans jamais découvrir qu'il n'a rien fait de mal.

Décidé au complet, sans aucune famille pour l'emmener, donc aucune affiche ne peut lui demander :

Ce ne sont pas des ordures. Ce qu'un mod ne peut jamais faire, c'est cette liste.

Les familles, une par une

Chaque famille que la build connaît, ce qu'elle accepte et un enregistrement que vous pouvez copier.

• Les champs obligatoires sont ceux sans lesquels un enregistrement ne peut pas être install.
• La colonne des valeurs est la forme que le chargeur vérifie, pas un indice.
• Lorsqu'une famille le dit, un champ que la table ne nomme pas est rejeté avec l'enregistrement dans lequel il se trouve. Une faute de frappe dans le nom d'un champ est un enregistrement qui ne se charge pas et le rapport familial l'indique par son nom.

Chaque entrée indique également ce qui arrive à une sauvegarde le jour où un joueur vous le dit. désinstaller :

Il n'y a rien d'écrit à la main ici. Les champs proviennent du schéma publié de chaque famille. Chaque exemple est l'un des packages que la matrice de test du framework lance contre le chargeur, remis sous l'espace de noms northern_reach et revérifié par rapport à son modèle lorsqu'il entre dans cette page : un exemple que le jeu rejetterait entraînerait l'échec de la construction.

Le monde et les lieux qu'il contient

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

buildings

Définitions des bâtiments et services de l'agglomération : label, couleur, rôle et intérieur réutilisé.

• Statut Prêt à l'emploi
• Voyagé en Le service d'un building
• Dossier content/world/buildings
• Enregistrements acheminés pour le champ id
• Rapport modding_building_report
• Si un joueur vous désinstalle substitute_placeholder. Une colonie avec un trou où il y avait un service est injouable ; un bâtiment visiblement manquant est lu et récupéré.

Champs. Un champ que cette table ne nomme pas est rejeté avec l'enregistrement.

Dans un fichier appelé buildings.json, ou quel que soit le nom .json que vous souhaitez dans ce dossier :

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

Routes commerciales parcourues par une caravane : d'où elle part, où elle va, ce qu'elle apporte, dans quelle mesure elle est escortée et à quelle vitesse elle va.

• Statut Prêt à l'emploi
• Dossier content/logistics/caravans
• Enregistrements acheminés pour le champ id
• Rapport modding_caravan_report
• Si un joueur vous désinstalle preserve_inert_reference. Une route dont le paquet a disparu conserve son nom et ne transporte rien. Remplacer une destination enverrait les biens d'un joueur vers un endroit qu'il n'a jamais accepté.

Champs. Un champ que cette table ne nomme pas est rejeté avec l'enregistrement.

Dans un fichier appelé caravans.json, ou quel que soit le nom .json que vous souhaitez dans ce dossier :

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

Arrangements qu'un package dessine dans Tiled, nommés par id : le fichier, où il se trouve dans le monde, et la clé de langue par laquelle il est connu. L'index est l'enregistrement ; l'arrangement à côté est lu comme des données et jamais comme une ressource, normalisé sous forme canonique, vérifié par rapport au kit publié et assemblé avant que quoi que ce soit ne soit placé. Une disposition rejetée ne place rien du tout, car la moitié de la carte est une région dans laquelle le joueur entre sans aucun moyen de savoir quelle moitié est arrivée.

• Statut Prêt à l'emploi
• Dossier content/world/maps
• Enregistrements acheminés pour le champ id
• Rapport modding_map_report
• Si un joueur vous désinstalle drop_optional_presentation. Aucun sauvetage ne nomme une disposition. Une sauvegarde nomme le point d'intérêt qu'une mise en page a déplacé, et cet enregistrement conserve ses coordonnées, de sorte qu'une carte retirée coûte la mise en page et non le contenu. L’abandonner est ce qui amène le monde à revenir à ce que disent ses archives, au lieu de maintenir une position que personne ne défend plus.

Champs. Un champ que cette table ne nomme pas est rejeté avec l'enregistrement.

Dans un fichier appelé maps.json, ou quel que soit le nom .json que vous souhaitez dans ce dossier :

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

Points d'intérêt placés par coordonnées sur la carte du monde manuscrite.

• Statut Prêt à l'emploi
• Chemin vers Un lieu sur la carte
• Dossier content/world/pois
• Enregistrements acheminés pour le champ id
• Rapport modding_poi_report
• Si un lecteur vous désinstalle preserve_inert_reference. Un lieu découvert reste découvert. Les missions et l'historique des voyages pointent vers l'id.

Champs. Un champ que cette table ne nomme pas est rejeté avec l'enregistrement.

Dans un fichier appelé pois.json, ou quel que soit le nom .json que vous souhaitez dans ce dossier :

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

Profils de génération constitués uniquement de données : choix pondérés de biome et de localisation, propriété de l'hôte.

• Statut Prêt à l'emploi
• Dossier content/world/generation
• Enregistrements acheminés pour le champ id
• Rapport aucun des siens ; modding_preflight_report s'en charge
• Si un joueur vous désinstalle preserve_inert_reference. Une sauvegarde enregistre l'identifiant du profil choisi. Si son paquet est manquant, conserver et signaler cet identifiant est plus sûr que de reconstruire silencieusement le jeu avec la carte du jeu de base.

Champs. Un champ que cette table ne nomme pas est rejeté avec l'enregistrement.

Dans un fichier appelé profiles.json, ou quel que soit le nom .json que vous souhaitez dans ce dossier :

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
        }
      ]
    }
  }
]

Les gens, les familles et ce qu'ils peuvent faire

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

enemy_archetypes

Types d'ennemis connus du niveau stratégique : rang, quelles variantes ils déploient, où ils campent, quelle est la taille du garnison et à quelle fréquence ils attaquent.

• Statut Prêt à l'emploi
• Dossier content/threat/enemy_archetypes
• Enregistrements acheminés pour le champ id
• Rapport modding_enemy_archetype_report
• Si un joueur vous désinstalle preserve_inert_reference. Un camp indique encore ce qui l'a établi. Remplacer modifierait silencieusement ce qui assiège une colonie ; nommer l'absence que nous lisons.

Champs. Un champ que cette table ne nomme pas est rejeté avec l'enregistrement.

Dans un fichier appelé enemy_archetypes.json, ou quel que soit le nom .json que vous souhaitez dans ce dossier :

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

Blocs de statistiques pour un type de corps ennemi sur le terrain : classe, rang, les cinq attributs et les identifiants de l'arme, du coup de main et du bouclier qu'elle porte.

• Statut Prêt à l'emploi
• Dossier content/combat/enemy_variants
• Enregistrements acheminés pour le champ id
• Rapport modding_enemy_variant_report
• Si un joueur vous désinstalle substitute_placeholder. Un corps déjà sur le terrain sans bloc de statistiques ne peut pas être combattu. Un remplacement stable possédé par le moteur permet de résoudre la bataille et l'identité d'origine est préservée.

Champs. Un champ que cette table ne nomme pas est rejeté avec l'enregistrement.

Dans un fichier appelé enemy_variants.json, ou quel que soit le nom .json que vous souhaitez dans ce dossier :

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

Paramètres de stratégie ajustables pour un groupe vivant sur la carte du monde : rayon d'alerte, préférence de cible, nombre de membres, seuils de ravitaillement et de retrait.

• Statut Prêt à l'emploi
• Dossier content/strategic/group_archetypes
• Enregistrements acheminés pour le champ id
• Rapport modding_group_archetype_report
• Si un joueur vous désinstalle substitute_placeholder. Le renseignement stratégique doit lire un seuil quelque part. Il répond à une valeur par défaut possédée par le moteur, qui est la même sur laquelle s'appuie déjà cette famille.

Champs. Un champ que cette table ne nomme pas est rejeté avec l'enregistrement.

Dans un fichier appelé group_archetypes.json, ou quel que soit le nom .json que vous souhaitez dans ce dossier :

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

Modèles de mercenaires à embaucher : nom, classe, origine, santé et les initiales du moral, le coût d'embauche et le jour de leur première apparition.

• Statut Prêt à l'emploi
• Dossier content/character/mercenaries
• Enregistrements acheminés pour le champ id
• Rapport modding_mercenary_report
• Si un joueur vous désinstalle preserve_inert_reference. Les mercenaires déjà engagés vivent dans le cadre du sauvetage en tant qu'unité ; seule la liste des tavernes perd son modèle. L'identifiant reste nommé, donc l'origine de l'organique peut toujours être lue.

Champs. Un champ que cette table ne nomme pas est rejeté avec l'enregistrement.

Dans un fichier appelé mercenaries.json, ou avec tout autre nom .json ti Placez-vous dans la carte :

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

Données initiales d'une maison noble : le seigneur, l'héritier, quelles colonies répondent à la maison et qui compte comme un rival ou un allié.

• Statut Prêt à l'emploi
• Carte content/politics/noble_houses
• Enregistrements acheminés pour le champ id
• Résumé modding_noble_house_report
• Vous avez un lecteur à désinstaller preserve_inert_reference. L'estime d'un joueur pour une maison est enregistrée sur son identifiant. Remplacez un écriture sans dire ni à l'époque du chi.

Champs. Un champ que cette table ne nomme pas est rejeté avec l'enregistrement.

Dans un fichier appelé noble_houses.json, ou quel que soit le nom .json que vous souhaitez dans ce dossier :

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

Définitions des PNJ avec un nom.

• Statut Prêt à l'emploi
• Chemin d'accès Un commerçant qui le conserve
• Dossier content/narrative/npcs
• Enregistrements acheminés pour le champ id
• Rapport modding_npc_report
• Si un lecteur vous désinstalle preserve_inert_reference. Une personne avec un nom dont le monde se souvient n'est pas la même chose qu'une personne qui n'a jamais existé, et les rapports pointent vers l'id.

Champs. Un champ que cette table ne nomme pas est rejeté avec l'enregistrement.

Dans un fichier appelé npcs.json, ou quel que soit le nom .json que vous souhaitez dans ce dossier :

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

Privilèges déclaratifs : déclencheurs et effets, sans aucun gestionnaire écrit en code.

• Statut Prêt à l'emploi
• Dossier content/character/perks
• Enregistrements acheminés pour le champ id
• Rapport modding_perk_report
• Si un joueur vous désinstalle preserve_inert_reference. Un personnage garde ce qu'il a gagné. La suppression d'une fonctionnalité réécrit silencieusement un bâtiment sur lequel le joueur a passé une partie.

Champs. Un champ que cette table ne nomme pas est rejeté avec l'enregistrement.

Dans un fichier appelé perks.json, ou quel que soit le nom .json que vous aimez dans ce dossier :

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

Modèles d'accompagnement, politiques relationnelles limitées, conditions de recrutement et liens declaratives.

• Statut Prêt à l'emploi
• Dossier content/companion/relationships
• Enregistrements acheminés pour le champ id
• Rapport aucun des siens ; modding_preflight_report s'en charge
• Si un lecteur vous désinstalle preserve_inert_reference. La graine de relation d'un compagnon reste attachée à son identifiant, donc la suppression d'un package ne peut pas effacer silencieusement la confiance, les rancunes ou l'historique d'abandon.

Champs. Cette famille contient plus d'un type d'enregistrement, et chaque type est vérifié par rapport à sa propre liste. Un champ que cette table ne nomme pas est rejeté avec l'enregistrement.

A enregistrement avec kind: bond:

Un enregistrement avec kind: companion_template :

Un enregistrement avec kind: recruit_terms :

Un enregistrement avec kind: relationship_policy :

Dans un fichier appelé relationships.json, ou quel que soit le nom .json que vous souhaitez dans ce dossier :

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
  }
]

Les choses, le commerce et les chiffres derrière un affrontement

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

combat_balance

Valeurs d'équilibre de combat limitées qui ajustent les paramètres du solveur existants sans ajouter de règles, d'opérations ou de mécanismes.

• Statut Prêt à l'emploi
• Dossier content/combat/balance
• Enregistrements acheminés pour le champ id
• Rapport modding_combat_balance_report
• Si un joueur vous désinstalle substitute_placeholder. Le solde est une donnée de définition détenue par l'hôte, et non l'inventaire du joueur. Lorsque son package est absent, l'équilibrage canonique et stable répond, et le chargement ultérieur n'apporte pas de deuxième façon de sauvegarder les ajustements.

Champs. Un champ que cette table ne nomme pas est rejeté avec l'enregistrement.

Dans un fichier appelé balance.json, ou quel que soit le nom .json que vous souhaitez dans ce dossier :

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

Biens commercialisables et leurs propriétés économiques.

• Statut Prêt à l'emploi
• A voyagé en Un bien à vendre
• Dossier content/economy/goods
• Enregistrements acheminés pour le champ id
• Rapport modding_goods_report
• Si un joueur vous désinstalle preserve_inert_reference. Une escorte qui nomme un produit que personne ne fournit est honnête. La remplacer changerait silencieusement ce qu’un joueur possède.

Champs. Un champ que cette table ne nomme pas est rejeté avec l'enregistrement.

Dans un fichier appelé goods.json, ou quel que soit le nom .json que vous souhaitez dans ce dossier :

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

Articles d'inventaire, y compris les armes et les armures.

• Statut Prêt à l'emploi
• Cheminé dans Un élément à transporter
• Dossier content/inventory/items
• Enregistrements acheminés pour le champ id
• Rapport modding_items_report
• Si un joueur vous désinstalle preserve_inert_reference. Le référentiel continue de nommer ce qu'il contient, et c'est la seule raison pour laquelle la réinstallation le leur rend.

Champs. Un champ que cette table ne nomme pas est rejeté avec l'enregistrement.

Dans un fichier appelé items.json, ou quel que soit le nom .json que vous souhaitez dans ce dossier :

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

Recettes artisanales : ce qui est consommé, ce qui en sort, où cela est fabriqué, combien cela coûte et quelle est la probabilité que cela se détériore.

• Statut Prêt à l'emploi
• Dossier content/economy/recipes
• Enregistrements acheminés pour le champ id
• Rapport aucun des siens ; modding_preflight_report s'en charge
• Si un joueur vous désinstalle preserve_inert_reference. Rien dans une sauvegarde ne nomme une recette : une sauvegarde nomme l'objet qu'un processus a produit, et la famille de cet objet en est responsable. Ce qu'une recette retirée laisse derrière elle, c'est une station qui n'offre plus quelque chose, qui est signalée plutôt que corrigée, car inventer une recette de remplacement mettrait dans la main du joueur un objet qu'aucun paquet ne fournit.

Champs. Un champ que cette table ne nomme pas est rejeté avec l'enregistrement.

Dans un fichier appelé recipes.json, ou quel que soit le nom .json que vous souhaitez dans ce dossier :

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

Tableaux d'approvisionnement des marchands.

• Statut Prêt à l'emploi
• Chemin d'accès Un commerçant qui le conserve
• Dossier content/world/vendor_inventories
• Enregistrements acheminés pour le champ id
• Rapport modding_vendor_inventory_report
• Si un joueur vous désinstalle drop_optional_presentation. Les stocks sont régénérés. Un commerçant avec une étagère vide est un état lisible et la ligne ne pointe vers rien d'autre.

Champs. Un champ que cette table ne nomme pas est rejeté avec l'enregistrement.

Dans un fichier appelé vendors.json, ou quel que soit le nom .json que vous souhaitez dans ce dossier :

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
      }
    ]
  }
]

Histoire, missions et mots qu'un joueur lit

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

dialogue

Les conversations comme enregistrements : le graphique, ses blagues et les choix qui s'y trouvent. Trois types partagent la famille et kind indique lequel. Un package écrit la conversation, jamais les mots – chaque frappe est une clé de langage – et chaque condition et chaque conséquence est une vérification ou une commande que cette construction exécute déjà.

• Statut Prêt à l'emploi
• Dossier content/narrative/dialogue
• Enregistrements acheminés pour le champ id
• Rapport modding_dialogue_report
• Si un joueur vous désinstalle preserve_inert_reference. Une sauvegarde enregistre ce qu'une conversation a fait – une mission qui a changé, un objet qui a changé de mains, une vérité apprise – jamais la conversation elle-même, qui se termine au moment où vous écrivez quelque chose. Lorsque le forfait disparaît, les conséquences subsistent car ils n'ont jamais fait partie de la conversation et la conversation n'est tout simplement plus proposée. Le remplacer reviendrait à mettre dans la bouche d'un personnage des mots que son auteur n'a jamais écrits.

Champs. Cette famille contient plus d'un type d'enregistrement, et chaque type est vérifié par rapport à sa propre liste. Un champ que cette table ne nomme pas est rejeté avec l'enregistrement.

Un enregistrement avec kind: dialogue_graph :

Un enregistrement avec kind: dialogue_node :

Un enregistrement avec kind: dialogue_node :

Un enregistrement avec kind: dialogue_node :

Un enregistrement avec kind: dialogue_option :

Dans un fichier appelé gate_toll.json, ou quel que soit le nom .json que vous aimez dans ce dossier :

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
      }
    ]
  }
]

Le luminaire contient 12 enregistrements ; 3 sont affichés.

locales

Les mots qu'un joueur lit, au format CSV avec une colonne par langue : les clés propres du package, et celles du jeu où le package déclare l'écrasement.

• Statut Prêt à l'emploi
• Dossier content/locale
• Rapport modding_locale_report
• Si un lecteur vous désinstalle preserve_inert_reference. Une sauvegarde nomme le disque, jamais les mots qui le disent, donc un paquet retiré entre deux sessions coûte une traduction et rien. La clé est conservée et apparaît, ce qui se lit comme une traduction manquante plutôt que comme un contenu manquant.

Colonnes. Une colonne que cette table ne nomme pas est rejetée avec l'enregistrement.

Dans un fichier appelé words.csv. Le nom du fichier correspond à la moitié de l'adresse et l'identifiant de la ligne à l'autre moitié, donc deux fichiers peuvent contenir le même identifiant de ligne sans entrer en collision :

a locales file

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

lore

Entrée du code : lieux, personnes, événements, coutumes et choses dont un monde raconte des histoires. Une entrée chargée n'est pas une entrée connue.

• Statut Prêt à l'emploi
• Dossier content/narrative/lore
• Enregistrements acheminés pour le champ id
• Rapport modding_lore_report
• Si un joueur vous désinstalle preserve_inert_reference. Une entrée du Codex qu'un joueur a lue est quelque chose qu'il a vu. Le retirer efface une partie de ce qu'il sait sur un monde dans lequel il a passé du temps, et les quêtes et autres entrées pointent vers l'identité.

Champs. Un champ que cette table ne nomme pas est rejeté avec l'enregistrement.

Dans un fichier appelé lore.json, ou quel que soit le nom .json que vous souhaitez dans ce dossier :

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

Lignes structurées de réalisme médiéval, acheminées par identifiant de fichier et de ligne au lieu d'un champ d'identifiant dans le JSON.

• Statut Prêt à l'emploi
• Dossier content/medieval_realism/structured
• Rapport modding_mr_lines_report
• Si un joueur vous désinstalle drop_optional_presentation. Une blague de couleurs à laquelle rien ne fait référence. Le supprimer ne coûte rien et le conserver afficherait une chaîne vide.

Colonnes. Une colonne que cette table ne nomme pas est autorisée et doit être une valeur simple au lieu d'une liste ou d'un objet.

Chaque enregistrement nécessite au moins un des éléments public_line, public_label et public_summary_line.

Ces noms sont rejetés sans conteste, quel que soit leur contenu : unsafe_example, unsafe_reason, audit_note, expected_block_reason, script, scene, resource_path. Certaines sont les colonnes de vérification avec lesquelles écrivent ceux qui jouent au jeu et les autres sont les noms en forme de code que What a mod can never do rejette partout. Un enregistrement en contenant un est rejeté au lieu d'être nettoyé en silence.

Dans un fichier appelé MR_L03_TAVERN_INN_LINES.csv. Le nom de fichier est la moitié de l'adresse et l'identifiant de ligne est l'autre moitié, donc deux fichiers peuvent contenir le même identifiant de ligne sans entrer en collision :

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

Dossiers de progression des joueurs : objectifs, profils de difficulté sécurisés et profils de match dans le cadre des règles de l'hôte.

• Statut Prêt à l'emploi
• Dossier content/player/progress
• Enregistrements acheminés pour le champ id
• Rapport aucun des siens ; modding_preflight_report s'en charge
• Si un lecteur vous désinstalle preserve_inert_reference. Les succès gagnés et les profils de match choisis restent nommés lorsque leur package est absent ; les retirer silencieusement réécrirait l'histoire du joueur ou le contrat du match.

Champs. Cette famille contient plus d'un type d'enregistrement, et chaque type est vérifié par rapport à sa propre liste. Un champ que cette table ne nomme pas est rejeté avec l'enregistrement.

Un enregistrement avec kind: achievement:

A enregistrement avec kind: difficulty_profile:

Un enregistrement avec kind: run_profile :

Dans un fichier appelé progress.json, ou quel que soit le nom .json que vous souhaitez dans ce dossier :

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

Enregistrements de métadonnées de quête, indexés par quest_id au lieu de id.

• Statut Prêt à l'emploi
• Dossier content/narrative/quest_metadata
• Enregistrements acheminés pour le champ quest_id
• Rapport modding_quest_metadata_report
• Si un joueur vous désinstalle preserve_inert_reference. Il décrit des missions qui pourraient elles-mêmes déjà être réduites à une pierre tombale ; le retirer les laisserait sans description plutôt qu'absents.

Champs. Un champ que cette table ne nomme pas est rejeté avec l'enregistrement.

Dans un fichier appelé quests.json, ou quel que soit le nom .json que vous souhaitez dans ce dossier :

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

Plans de mission en tant qu'enregistrements : les arcs, les missions, les objectifs et les fins qu'un package écrit et à partir desquels le jeu construit ses propres missions. La forme d'enregistrement d'une mission, à côté des ressources manuscrites plutôt qu'à leur place.

• Statut Prêt à l'emploi
• Dossier content/narrative/quest_plans
• Enregistrements acheminés pour le champ id
• Rapport modding_quest_plan_report
• Si un joueur vous désinstalle preserve_inert_reference. Un plan construit les mêmes missions que celles du jeu, donc un plan à la retraite laisse le même trou que laisserait l'écriture manuscrite. La progression est la seule chose qu'un joueur ne peut pas reconstruire : une mission non résolue est signalée et n'est jamais terminée ni silencieusement annulée.

Champs. Cette famille contient plus d'un type d'enregistrement, et chaque type est vérifié par rapport à sa propre liste. Un champ que cette table ne nomme pas est rejeté avec l'enregistrement.

Un enregistrement avec kind: arc :

Un enregistrement avec kind: ending :

Un enregistrement avec kind: objective :

Un enregistrement avec kind: quest :

Dans un fichier appelé the_long_winter.json, ou quel que soit le nom .json que vous souhaitez dans ce dossier :

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"
  }
]

Le luminaire contient 5 enregistrements ; 3 sont présentés.

quests

Actifs de mission manuscrits, chargés par itinéraire au lieu d'être interprétés comme des enregistrements. Un package qui veut sa propre mission écrit quest_plans.

• Statut Vérifié, pas encore installé
• Dossier content/narrative/quests
• Rapport aucun des siens ; modding_preflight_report s'en charge
• Si un joueur vous désinstalle preserve_inert_reference. Le progrès est la seule chose qu’un joueur ne peut pas reconstruire. Une mission non résolue est signalée et jamais terminée ou silencieusement annulée.

Cette famille est chargée par chemin plutôt que lue comme un enregistrement, et un package ne peut pas contenir le fichier qu'il souhaite ; voir Ce qu'un mod ne peut jamais faire. Écrivez plutôt quest_plans.

scenes

Des scènes mises en scène : la pièce, qui s'y trouve et les répliques qui se déroulent dans l'ordre. C'est le seul contenu qui enlève le contrôle au joueur, c'est pourquoi une séquence qui n'arrive jamais à end est rejetée plutôt que lue. Les blagues et les accessoires sont des noms tirés de listes publiées ; aucune scène Godot, aucun actif et aucun script ne sont chargés ici.

• Statut Prêt à l'emploi
• Dossier content/narrative/scenes
• Enregistrements acheminés pour le champ id
• Rapport modding_scene_report
• Si un joueur vous désinstalle preserve_inert_reference. Une sauvegarde enregistre ce qu'une scène a fait – un nom choisi, une mission déplacée, une porte ouverte – jamais le fait qu'elle a été regardée. Il se joue et se termine en une seule session, donc un forfait qui quitte coûte la scène et n'est jamais une conséquence de l'avoir vu. Le remplacer mettrait en scène quelque chose que l’auteur n’a jamais écrit sous le nom de quelque chose qu’il a écrit.

Champs. Un champ que cette table ne nomme pas est rejeté avec l'enregistrement.

Dans un fichier appelé scenes.json, ou quel que soit le nom .json que vous souhaitez dans ce dossier :

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"
      }
    ]
  }
]

Comment tu vois et entends tout

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

audio

Les sons qu'un package transporte, nommés par identifiant : musique, ambiance, effets et voix, chacun pointant vers un fichier dans son propre dossier et déclarant le rôle qui le délimite.

• Statut Validé, rien ne le consomme encore
• Dossier content/assets/audio
• Enregistrements acheminés pour le champ id
• Rapport modding_audio_report
• Si un joueur vous désinstalle preserve_inert_reference. Une sauvegarde nomme le sujet et jamais le son au-dessus, donc un forfait retiré entre deux séances coûte une ambiance et pas une chose. La référence est conservée et rapportée : le silence sans rien dire pourquoi est justement l’état que cette famille existe pour éviter.

Champs. Un champ que cette table ne nomme pas est rejeté avec l'enregistrement.

Dans le fichier audio.json, qui est le seul fichier à travers lequel ce dossier est lu :

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

Météo, poussière, étincelles et lumières, composés à partir des modèles que l'hébergeur met à disposition. Un package nomme un modèle et définit les paramètres dans les plages déclarées ; il n'y a aucun champ, nulle part, qui contient un shader, une scène ou un script - et c'est ce qui permet au package d'un étranger de demander du feu sans pouvoir demander un programme.

• Statut Prêt à l'emploi
• Dossier content/assets/effects
• Enregistrements acheminés pour le champ id
• Rapport modding_effect_report
• Si un joueur vous désinstalle preserve_inert_reference. Rien dans une sauvegarde ne nomme un effet. L'air revient à ce que le jeu de base dessine lorsque le pack part, ce qui coûte un aspect et rien ne possède un joueur.

Champs. Un champ que cette table ne nomme pas est rejeté avec l'enregistrement.

Dans un fichier appelé effects.json, ou quel que soit le nom .json que vous souhaitez dans ce dossier :

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

Les polices de caractères qu'un paquet contient, nommées par identifiant : le fichier, la taille dans laquelle ils sont dessinés et les langues dont ils portent les glyphes. La couverture prétend être exposée, car un caractère manquant des glyphes d'une langue n'échoue pas : il dessine de petits carrés et l'écran se lit comme une traduction laissée à moitié terminée.

• Statut Validé, rien ne le consomme encore
• Dossier content/assets/fonts
• Enregistrements acheminés pour le champ id
• Rapport modding_font_report
• Si un lecteur vous désinstalle preserve_inert_reference. Rien dans une sauvegarde ne nomme un personnage. L'interface revient à la police de la boîte à outils lorsque le package quitte, qui est la seule qu'aucun auteur n'a dû choisir.

Champs. Un champ que cette table ne nomme pas est rejeté avec l'enregistrement.

Dans le fichier fonts.json, qui est le seul fichier à travers lequel ce dossier est lu :

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

Images qu'apporte un package, nommées par identifiant : icônes, portraits et feuilles de sprites, chacun pointant vers un fichier dans son propre dossier.

• Statut Prêt à l'emploi
• Dossier content/assets/images
• Enregistrements acheminés pour le champ id
• Rapport modding_image_report
• Si un joueur vous désinstalle preserve_inert_reference. Une sauvegarde nomme des objets et des personnes, jamais une image de l'un d'eux, donc une image qui cesse de se résoudre coûte un dessin et non une chose. La référence est préservée et signalée : la remplacer par une illustration provenant d'un autre package montrerait au joueur quelque chose qu'aucun auteur n'a choisi, et supprimer l'identifiant silencieusement ferait ressembler l'icône manquante à un défaut de conception.

Champs. Un champ que cette table ne nomme pas est rejeté avec l'enregistrement.

Dans le fichier images.json, qui est le seul fichier à travers lequel ce dossier est lu :

a images record, under content/assets/images

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

presentation_bindings

Quelle ressource du package remplit quel emplacement sur quel sujet : l'icône sur un objet, le sprite sur une unité ou une tuile, la bannière sur une faction, aussi bien pour le contenu du package que pour celui du jeu de base.

• Statut Prêt à l'emploi
• Dossier content/presentation/bindings
• Enregistrements acheminés pour le champ id
• Rapport aucun des siens ; modding_preflight_report s'en charge
• Si un joueur vous désinstalle preserve_inert_reference. Une sauvegarde nomme le sujet – l’objet, la personne, la pièce – et jamais quelle image l’habille, donc un lien qui cesse de se résoudre coûte un dessin et non une chose. La référence est conservée et rapportée : le sujet renvoie à l'art que possédait déjà la construction, seule réponse qu'aucun auteur n'a eu à choisir.

Champs. Un champ que cette table ne nomme pas est rejeté avec l'enregistrement.

Dans un fichier appelé bindings.json, ou quel que soit le nom .json que vous souhaitez dans ce dossier :

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

Dispositions d'écran : quelles sections correspondent à quel panneau d'écran le jeu possède déjà et dans quel ordre. Il comporte des éléments que cette version dessine et ne peut pas en ajouter : un nouvel écran aurait besoin de widgets, de sources de données et de gestionnaires de clics, qui constituent ensemble un langage de programmation.

• Statut Prêt à l'emploi
• Dossier content/ui/screens
• Enregistrements acheminés pour le champ id
• Rapport modding_screen_report
• Si un joueur vous désinstalle preserve_inert_reference. Rien dans un sauvetage ne nomme une disposition. Il décide de la manière dont une page est dessinée pendant le chargement du pack, et la page revient à la mise en page que cette version prend avec elle lorsqu'elle part : cela coûte un skin et rien ne possède un joueur.

Champs. Un champ que cette table ne nomme pas est rejeté avec l'enregistrement.

Dans un fichier appelé screens.json, ou quel que soit le nom .json que vous souhaitez dans ce dossier :

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

Palettes d'interface sous forme de jetons : couleurs, tailles et espacements nommés, avec des paires dont le contraste doit être capable de lire. Jamais une scène, un script ou un chemin de ressource.

• Statut Prêt à l'emploi
• Dossier content/assets/themes
• Enregistrements acheminés pour le champ id
• Rapport modding_theme_report
• Si un joueur vous désinstalle preserve_inert_reference. Rien dans une sauvegarde ne nomme un thème. L'interface revient aux couleurs de la boîte à outils lorsque le package quitte, ce qui est la seule palette qu'un auteur a dû choisir.

Champs. Un champ que cette table ne nomme pas est rejeté avec l'enregistrement.

Dans un fichier appelé themes.json, ou quel que soit le nom .json que vous souhaitez dans ce dossier :

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"
      }
    ]
  }
]

Qu'est-ce que le joueur contrôle et qu'observe-t-il

3 familles : adaptive, input_bindings, settings.

adaptive

Des profils qui regardent le déroulement d’un match et suggèrent une approche différente. Le résultat est un conseil et jamais un changement : un profil qui pourrait agir serait la seule chose qu'apporte un package capable de modifier un jeu sans que le joueur ou l'invité ne le demande, et dans un diff il ressemblerait exactement à une table d'ajustements. Les entrées sont une liste publiée d'agrégats de jeu, chacun représentant un nombre ou une moyenne que le jeu détient déjà sur lui-même.

• Statut Prêt à l'emploi
• Dossier content/player/adaptive
• Enregistrements acheminés pour le champ id
• Rapport modding_adaptive_report
• Si un joueur vous désinstalle drop_optional_presentation. Aucune sauvegarde ne nomme un profil. Ce qu'un profil a touché, c'est un multiplicateur recalculé par les mutateurs actifs à chaque fois qu'ils changent, donc un paquet retiré cesse d'être consulté et le jeu revient exactement à ce que le joueur avait choisi. Rien n'est conservé, donc il n'y a rien à préserver.

Champs. Cette famille contient plus d'un type d'enregistrement, et chaque type est vérifié par rapport à sa propre liste. Un champ que cette table ne nomme pas est rejeté avec l'enregistrement.

A enregistrement avec kind: adaptive_profile :

A enregistrement avec kind: threshold_set :

Dans un fichier appelé adaptive.json, ou sous un autre nom .json que vous aimez dans ce dossier :

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

Actions spécifiques à un package, avec la clé qu'ils souhaitent. Le joueur décide : une suggestion qui aboutit sur une combinaison qu'il avait déjà assignée est perdante, et l'action se déroule sans bouton, car un bouton qui fait autre chose en silence est pire qu'un bouton qui ne fait rien.

• Statut Prêt à l'emploi
• Dossier content/input
• Enregistrements acheminés pour le champ action_id
• Rapport modding_input_report
• Si un joueur vous désinstalle preserve_inert_reference. La réaffectation d'un joueur reste stockée sous l'identifiant de l'action, donc la réinstallation du package trouve le bouton où vous l'avez placé. L'action elle-même est supprimée de la carte des commandes lorsque le package quitte, de sorte que l'écran d'affectation ne répertorie jamais quelque chose qui ne répond à rien.

Champs. Un champ que cette table ne nomme pas est rejeté avec l'enregistrement.

Dans un fichier appelé bindings.json, ou quel que soit le nom .json que vous souhaitez dans ce dossier :

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

Options qu'un joueur peut modifier, déclarées plutôt que tirées. Un package indique quelle est l'option, quelles valeurs elle peut avoir et où se trouve la valeur ; le contrôle est construit par l'invité. Rien de ce qui traverse cette frontière n'est un contrôle ou un script, et c'est la seule raison pour laquelle un menu de paramètres peut afficher les options d'un étranger sans exécuter son code.

• Statut Prêt à l'emploi
• Dossier content/settings
• Enregistrements acheminés pour le champ key
• Rapport modding_settings_report
• Si un joueur vous désinstalle preserve_inert_reference. Une valeur stockée reste sous sa clé, donc la réinstallation du paquet retrouve le choix du joueur là où il l'a laissé. Ce que laisse le paquet, c'est une ligne de profil que personne ne lit : cela ne coûte rien et préserve le choix que le joueur a fait.

Champs. Un champ que cette table ne nomme pas est rejeté avec l'enregistrement.

Dans un fichier appelé settings.json, ou quel que soit le nom .json que vous souhaitez dans ce dossier :

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"
  }
]

Raccourcis de la console

Il s'agit d'un raccourci, pas d'une étape. Tout ce qui suit a sa place sur l'écran Mods, où passe la route normale et où regardera toute personne ayant téléchargé votre package. La console est plus rapide lorsque vous itérez et elle est déjà ouverte, et elle n'existe que dans une version de débogage : une copie publiée du jeu n'a pas de console, donc rien dont un auteur de package a besoin ne peut vivre ici seul.

Commencez à modding_manifest_report : le jeu voit-il votre package et dans quel état ? — puis modding_preflight_report pour un verdict unique sur tout ce qui est installé. Puis le rapport de chaque famille.

modding_reload relit vos fichiers sans redémarrer. Modifiez, faites Alt-Tab, saisissez la commande et regardez. Il reconstruit ce que rien ne retient — bindings, effets et images — et nomme chaque famille laissée de côté, car une partie est debout sur les enregistrements qu'une sauvegarde peut nommer :

what the game prints back

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

modding_reload all lit à nouveau tout et concerne un écran de démarrage sans jeu en cours. modding_condition_report affiche ce que le jeu peut maintenant répondre pour un when, et ce qu'il ne peut pas répondre.

Outils hors ligne

Ces outils sont destinés aux auteurs et à l'automatisation des publications. Ils sont fournis dans le checkout public de Bonemark ; les joueurs qui installent un mod publié n'ont besoin ni de Python ni de Godot. Si vous écrivez un mod, clonez la version correspondante depuis github.com/tallowgames/Bonemark, gardez votre package de travail hors du dossier mods du joueur et exécutez les commandes ci-dessous depuis ce checkout. Le jeu reste l'autorité finale du runtime.

Python 3.10 ou version ultérieure ; Godot pour la voie d'exécution uniquement. Conservez votre package en dehors du dossier mods du lecteur et essayez-en une copie.

a command line

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

Il écrit un package qui passe la validation avant même que vous ayez écrit quoi que ce soit : un mod.json précompilé, un dossier de travail pour chaque famille que vous avez demandée et un README avec les deux commandes suivantes. Les enregistrements proviennent d'appareils que la construction vérifie déjà pour ces familles, donc un démarreur qui cesse de fonctionner provoque la même vérification qui provoque l'échec de l'appareil, plutôt que de pourrir à l'intérieur d'un modèle. Il refuse d'écrire dans un dossier appelé mods.

a command line

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

Vérifiez mod.json, les dossiers familiaux, les identifiants, les schémas, les références, les limites et les charges utiles bloquées. --strict transforme les avertissements en échecs.

Comparez la surface de modding avec la version

Lorsque le jeu change, comparez l'instantané de surface archivé avant de mettre à jour un package. Il contient un résumé ainsi que des champs et des opérations pour chaque famille publique, de sorte que le résultat indique quelle famille a changé et pourquoi :

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

La différence est unchanged, additive ou breaking. Les raisons de l'échec sont explicites : field_removed, required_added, type_changed, default_changed, constraint_changed, operation_removed et root_changed, format_changed, id_field_changed, catalogue_changed, family_removed et contract_major_changed_without_new_id. Nom de modification compatible field_added, required_removed, operation_added ou family_added. La commande sans --before vérifie également la ligne de base stockée. Si la surface actuelle a bougé, l'audit échoue jusqu'à ce qu'un responsable examine les résumés avant/après exacts dans tools/quality/modding_surface_contract_changes.json ; une modification radicale doit également enregistrer chaque raison, la décision, la note de migration et le réviseur. La promotion d'un instantané intentionnellement révisé est explicite :

a command line

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

Il s'agit d'une vérification du responsable/de la version ; les auteurs de mods n'ont besoin que de la comparaison --before, et les joueurs qui installent un package publié n'ont pas besoin de l'exécuter.

a command line

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

Lit le manifeste, les dépendances, la compatibilité et l'ordre de chargement sans lancer Godot et sans exécuter quoi que ce soit de votre package.

N'ouvre jamais un fichier de contenu. C'est la division du travail : l'hôte répond ces paquets seront chargés ensemble, le validateur répond cet enregistrement est correct - mais cela signifie qu'un paquet que le validateur rejette peut toujours être composé proprement ici. Mesurés sur quatorze paquets délibérément brisés, les deux sont en désaccord sur chaque rejet : l'hôte met en scène les quatorze paquets refused vides, dont un portant scripts/payload.sh que seul le validateur trouve. La numérotation n'est pas la même chose qu'une installation sécurisée. Faites les deux avant de publier. Répétez --root lorsque l'ensemble de test est divisé en dossiers ; l'hôte compose ensuite l'ensemble complet dans un plan déterministe.

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"

Il exécute le validateur, l'hôte de test, le montage de chaque famille prêt à l'emploi et la voie d'exécution Godot. Supprimez --require-runtime si vous n'avez pas Godot ; le rapport indiquera alors que le test d'exécution a été ignoré et non réussi.

Pour un ensemble composite, répétez l'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

Le rapport conserve un résultat par racine et ajoute composed_set pour l'ensemble complet. Ce bloc est l'endroit où les conflits de packages, les ID en double et les erreurs de dépendance sont démontrés. Un emballage propre ne constitue pas à lui seul une preuve que l’ensemble sera chargé ensemble. Le rapport inclut également surface_contract, la version actuelle du contrat familial et le résumé d'audit, de sorte qu'une matrice ne peut pas être verte tant que l'instantané de compatibilité du référentiel est obsolète. Avec --require-runtime, lisez runtime.reachability.loaded_families et runtime.reachability.reachable_families. Le premier indique que les enregistrements composés ont été chargés ; la seconde n’est peuplée que lorsqu’un véritable chemin destiné aux acteurs de l’enquête Godot les a consumés. runtime.reachability.observations conserve le package, la famille, l'ID d'enregistrement, le chemin et le statut pour chaque ligne, tandis que unreachable répertorie les lignes chargées qui n'ont pas encore de chemin. Une famille peut être validée et mise en scène tout en étant absente de reachable_families : "chargée" n'est pas la même chose que "un joueur peut l'atteindre".

Chaque commande ci-dessus est vérifiée par rapport aux outils eux-mêmes au fur et à mesure de la création de cette page : le script doit exister et chaque option doit être acceptée.

Chaque code de diagnostic

Ne lisez pas cette liste dans l'ordre. C'est ici pour qu'un code que vous rencontrez dans un rapport soit une question avec une réponse — un petit mot en minuscule comme asset_missing. Collez-en un dans le champ de recherche en haut de cette page.

Certains codes appartiennent à des mécanismes qu'un paquet ne peut pas encore atteindre. Je suis là pareil : un code qu'on ne peut pas déclencher coûte une ligne qu'on ne lira jamais, et un code manquant coûte une soirée.