模组

mods文件夹在哪里

从主菜单打开 Mods。该路径写在屏幕顶部，旁边有一个按钮，可在文件管理器中打开该文件夹。

它位于您的保存旁边，无论您是安装其他人的模组还是编写自己的模组，它都是同一个文件夹。游戏运行时不会读取任何内容，因此移动文件时游戏是否打开并不重要。

安装一个

mod 是一个顶部带有 mod.json 的文件夹。大多数下载都是 zip 中的该文件夹。

你复制到的模组会保持关闭状态，直到你这么说。游戏毫无疑问地拒绝可执行文件，但数据包仍然可以以你没有要求的方式改变价格、物品和人员，而在已经运行的游戏中自行弹出的一个问题是没有人愿意诊断的。所以游戏会问。这是第一次额外的重新启动，并且对于该包再也不会。

没有启动器，没有要编辑的加载顺序文件，也没有任何可记录的内容。加载顺序是每个包内的一个数字，由其作者选择。

对于添加人物、地点或任务的 mod 包，请开始新的一局。已经进行中的存档会保留创建它时的世界。只改变数字、图像或颜色的 mod 包可以在已经开始的游戏中显示。音频和字体文件会被验证，但当前没有运行中的 mod 包界面消费它们。

加载了吗？

模组，在主菜单中。找到的每个包都占一行，具有单字状态：已加载、已禁用、无效、冲突、需要另一个 mod、被忽略。

模组也可以自行关闭，并且它说明了原因。 您放置的开关适用于您放置它的包，而不是其在文件夹中的名称。 mod id 由作者选择，没有任何东西可以协调它们，因此两个不相关的 mod 都称为 northern_reach 是一个普通的意外 - 如果没有这个，第二个将继承第一个的开关。如果某个 id 下的 mod 不是您打开的 mod，则该行会这样显示：*这不是您打开的 mod*。就地更新模组可以保留您的开关；删除它并复制另一个号码。

如果您是某个 mod 的作者，并且在您的包上看到该行，则说明您与其他人的 mod 发生了 id 冲突。选择一个不太明显的 ID。

其中两个词是关于您欠的重启，而不是软件包。 活动 — 重新启动加载意味着您已将其打开，但尚未有人阅读； 关闭-重新启动下载意味着相反，并且其内容仍然在游戏中，直到您重新启动。它们是故意分开的：当你按下开关时，屏幕上会显示“已加载”，这会让你在世界各地寻找尚不存在的东西。

当状态未“加载”时，下面的行会用您正在玩的语言告诉您原因，并且没有您未编写的标识符：游戏拒绝运行哪个文件，缺少哪个包，需要哪个版本。下面是包裹内容的作用：输入了多少条目，拒绝了多少条目。 显示详细信息 打开其余部分，即 ID 和每个被拒绝的记录所打破的确切规则。

两行故意共用一个词： 需要另一个模组 对于玩家来说，这都是同样的问题，无论他们需要的包丢失还是版本错误，下面的行都说了。当两个数据包声明相同的记录时，load_order 最高的数据包最后写入并获胜 - 但没有人声明的接管是错误，而不是注释。两条线都会被报告，失败者的线会命名获胜者，获胜者仍然会被计算出来，而不是听凭机会：拒绝也不一定是抛硬币。 当两个 mods 想要相同的东西时 解释了如何故意声明一个。

“已上传”并不意味着您可以在世界上看到它。为此，请阅读该行下方的计数，然后现在在游戏中找到它会告诉您每种类型的东西会在哪里弹出。

计数总是累加起来。 床位被申请，更多被拒绝，更多被另一个模式取代，更多等待他们自己的条件 - 最后两个被提名而不是留下一个洞。另一个包最后写入的记录不会被拒绝，因为它没有任何问题，甚至不会被强制执行，因为这不是游戏保留的内容。这就像阅读一行代码和花一个晚上在一个没有错误的文件中查找错误之间的区别。 显示详细信息 告诉哪个记录以及哪个包现在拥有该记录。

总和旁边有一个数字，而不是内部：没有人读取过的文件。 家族不在 content_types 中的文件从未被打开过，因此没有记录可计数，也无法知道其中有多少个。它是文件计数，而不是记录计数，这正是它不能是第六项的原因：总和从 read 开始，而这些从未被读取过。

在向某人寻求帮助之前

打开 Mod 并按 复制报告。将所有内容粘贴到您的消息中，然后说出您的期望。

简单的文本，可用于论坛、Discord 消息或错误报告：您所在的版本、mods 文件夹、每个包及其版本、加载顺序和状态、每次拒绝背后的原因、每种内容类型的计数以及哪个包赢得了每场战斗。

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

十有八九答案就在眼前，没有人必须先问你任何一个问题。它不会读取 mods 文件夹之外的任何内容，不会更改任何内容，也不包含任何个人信息。

即使您使用另一种语言玩游戏，它也是英语的。这是有意为之的：帮助你的人可能不会读到你的内容，而且它包含的每一个事实——id、版本、计数——在所有语言中仍然是相同的。

删除一个

删除其文件夹并重新启动。卸载都在这儿了。

您的任何内容都不会随之删除。 保存会保留它无法再解析的 id、标记它们，并在重新安装软件包时返回内容。无法理解保存的会话甚至不会覆盖它：原始文件保持原样，这就是失败的下午和失败的游戏之间的区别。 Saves 是完整的报告。

如果游戏在你安装某些东西后停止运行，那么出路就不需要游戏了。 打开mods文件夹并移出你最后添加的东西。只能从该文件夹中读取软件包，因此不存在的文件夹将无法加载软件包，并且下次启动与以前相同。您不需要工作菜单、控制台或启动来执行此操作。

即使游戏也会自行尝试 - 如果游戏没有开始，它只是有限次数的尝试，然后在没有加载任何包的情况下返回 - 但这是腰带，移动文件夹是吊带。

今天您可以构建什么

现在无需请求任何人：商品及其商人、物品、人物和所在位置、建筑及其服务、地图上的地点、对话、场景、任务计划、在 Tiled 中绘制的地图、图像和颜色，以及全部七种语言的文字。音频和字体文件会被检查并读取，但目前没有 mod 包界面消费它们；状态表会明确说明这一点，而不会把它们称为可用。全部系列 是测量得出的完整列表，状态来自构建结果，而不是承诺。

还不能做到，当前还不能做什么 会解释每一项：quests 系列、mod 包音频、mod 包字体、打包的全面转换，以及作为功能而非内容的 mod 包。

永远不会，由于项目选择：代码。没有脚本，没有场景，没有资源文件，没有任何可供游戏运行的东西。这就是下载陌生人的模组变得安全的原因，而且这不是该项目正在经历的阶段。 mod 永远无法做到的事情。

在游戏中看到第一件事的时间：大约十分钟，主要花在寻找文件夹上。 【十分钟一个mod】(#a-mod-in-ten-分钟)一路过关斩将，最后的剑才是真的。

您还不能做什么以及为什么

这里把它写在靠前的位置，而不是留到读者离开页面时才发现。这些内容会被构建验证，但目前不会放到面向玩家的 mod 包界面上；另外还包括根本不属于 mod 包内容的项目。

游戏中从未有过的一个机制是第四排戴着另一顶帽子。剑击得越重，它就是一个数字，它就是你的；发射光束的武器需要光束规则，而规则是某人编写和测试的代码。

什么是模组

文本文件的文件夹。你不写代码。你在游戏中写下你想要的东西的列表，游戏启动时会读取它们。

其他一切都遵循的一条规则：您可以添加和更改数据。你不能让游戏执行代码。这就是下载模组的安全性：陌生人的模组最糟糕的事情就是向你挥出一把愚蠢的剑。

今天有 34 个内容系列可直接使用，包括 items、buildings、pois、npc_definitions、vendor_inventories、quest_plans、caravans 和 perks。全部系列 是完整表格，说明每个系列的用途；逐个查看系列 会列出字段和可复制的记录。

选择你的道路

这是整个指南的目录 - 每个主题都写在其中，无论您今天是否正在构建它。第 3 部分的顶部是第二个较短的索引：这是六个教程，按照它们相互构建的顺序排列。如果你来这里是为了做某事而不是为了寻找什么，那就直接去那里吧。

或者你心里的事情。本指南按照工作发生的顺序排列——清单、验证、内容、报告——这是已经了解系统的人会选择的顺序。不认识他的人会想*我要添加一个商人*，然后寻找商人这个词：

你需要什么

当您仍在查看 JSON 时，为 JSON 着色的编辑器会向您显示缺少的逗号，而不是让游戏稍后告诉您该文件不可读。

Python 和控制台都是可选的。游戏本身就够用：放入 mod 包，重启并打开 Mods，那里会说明每条被拒绝的记录及原因。作者使用的 checkout 是公开的。想更快迭代或自动发布的作者可以克隆公开的 Bonemark checkout，并在离线工具中运行工具；安装已发布 mod 包的玩家不需要 Python 或 Godot。同一个公开 checkout 提供验证器和运行时声明，因此下面两个章节描述的是同一套工具链。工具使用与游戏相同的声明——记录架构和安全边界各自只有一个来源——所以它们只会更早告诉你结果，不会给出不同结果。调试控制台有助于检查已加载的 mod 包，但不是编写 mod 包的必要条件。

从你想做的事情开始

该行以下的所有内容均按工作发生的顺序排列：海报，然后文件，然后家庭，然后报告。寻找某事的顺序是正确的，而开始的顺序则是错误的，因为没有人从宣言开始。它以“我想要一个商人”开头。

然后：选择与您想要做的事情相似的短语。

这六个教程是一个单独的包，一次构建一个：蜂蜡蜡烛、玩家随身携带的包、出售蜂蜡的制造商、商店的门、制革厂后面的坑（牛油的来源），最后是对游戏已有蜡烛的修改。按顺序进行这些操作，最终得到一个可能有人下载的模组。在中间放一个，它就可以自行工作。

游戏号码在哪里

这里的每个教程都会通过将新东西与游戏中已经出售的东西进行比较来定价，因为旁边没有任何内容的数字是一个猜测，而在城市之间进行贸易的经济体中的猜测不会停留在你输入的位置。

您无法打开游戏文件。 它的记录是打包构建中的 Godot 资产 - 与您编写的 JSON 的格式不同，其中 category = 1 您的文件显示为 "MANUFACTURED"。没有可供复制的文件夹，解包也不是任何人都需要记录的工作流程。

你不需要它。 目录发布了游戏的内容，这些内容是根据每次构建的相同记录生成的：270个物品及其类别、重量、硬币价值和堆栈大小、49种武器、42件盔甲、37个位置。这是本指南所锚定的参考，它不能偏离游戏，并且字段的名称打印在每行旁边。

在给某样东西定价之前需要了解的十几个值：

如果你的新东西比板甲更贵，那就出问题了，游戏不会告诉你——它会默默地成为世界上最赚钱的货物，每个商队都会携带它。

出售的商品

你将拥有一种经济知道如何定价的商品，与游戏已经销售的蜡烛挂钩，准备好供商人持有。

屏幕截图： 尚未拍摄。这个空间一直是空的，直到出现一个真实的空间：一张它可能看起来像的图画将是页面上唯一不真实的东西。

先阅读： 什么是 mod · 十分钟的 mod · 名称和 ids

复制自：名为 chandlery 的文件夹，该文件夹已位于您的 mods 文件夹中。游戏第一次启动、关闭时就放在那里，这就是这六个教程的最终结果：下面的每条记录都在那里。它也是存储库的测试通道针对加载程序旋转的包，因此这里没有游戏会拒绝的记录。打开它看看它是否工作，或者复制文件夹，重命名它并使其成为您的。

文件去向：

where the files go

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

从游戏已有的蜡烛开始。 它的名字叫candle，成本3，重量0.5，分别是MANUFACTURED和PRESERVED，由药剂师制作。你的也是用更好的蜡制成的，所以保留所有这些答案并换两个。

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
}

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

完成 - 现在在游戏中找到它。重新启动，打开Mod，下面的行显示 1 entry added。这是商品本身所做的一切：它有价格，有销路，而且它不会出现在任何人的柜台上，因为还没有人拥有它。这不是失败，而是曾经让所有人感到困惑的事情。继续库存的商人。

如果未显示： 没有显示 按顺序有六个原因。到目前为止最常见的是 content_types — 该行中缺少一个系列意味着该文件夹永远不会打开，无论它包含什么。然后在你向任何人寻求帮助之前，这是一个按钮。

需要携带的物体

你将拥有玩家捡起的东西，堆放在他们的背包中，然后转售，与你刚刚编写的商品配对。

屏幕截图： 尚未拍摄。

先阅读： 卖得好 · 名称和 ids

复制自： chandlery/content/inventory/items/items.json 到您的 mods 文件夹。

文件去向：

where the files go

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

商品和物体是同一个东西的两半。商品是经济学的观点：一个城市生产什么，一个商队运输什么，值多少钱。对象是玩家的视角：背包里装的是什么，堆放的是什么，商店里展示的是什么。小麦是一种商品，但没有物体，因为没有人随身携带一袋小麦。蜡烛两者都有。

将"items"添加到mod.json中的content_types，然后写入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"]
  }
]

完成 - 现在在游戏中找到它。 无人交付的物品已加载并且可以从无到有。在调试版本中，item chandlery:beeswax_candle_bundle 会立即将一个命令放入您的背包中，这是它已加载的最快证明 - 但该命令在人们下载的游戏中不存在，因此它对您来说是一个快捷方式，而不是玩家的答案。真正的答案是下一个教程。

如果未显示： 没有显示任何内容，然后在向任何人寻求帮助之前。

持有它的商人

你将会有一个有名字的女人站在旧座位上，那里有一个柜台，每两天补充一次的用品，柜台上还有你的蜡烛。

屏幕截图： 尚未拍摄。

先阅读： 要携带的物品 · 现在在游戏中找到它

复制自： chandlery/content/narrative/npcs/npcs.json 和 chandlery/content/world/vendor_inventories/vendors.json。

文件去向：

where the files go

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

这是两个家庭必须同意的。 人携带着银行的id，银行携带着人的id，银行的每一行都携带着一个物体的id。三个 id，每个 id 的书写方式都必须与您在其他文件中的书写方式完全相同。这个错误花费了一个晚上的时间，Mods 屏幕将其命名为：一条指向无人提供的 id 的行被列为“需要另一个未安装的 mod”。

将 "npc_definitions" 和 "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
      }
    ]
  }
]

完成 - 现在在游戏中找到他。 重新启动，前往旧座位，找到赫斯塔，打开交易屏幕。如果银行是空的，则尚未补充：这是 restock_days，不是错误。这个链条可以通过三种方式打破，所有三种方式都在 Mod 屏幕上：无人持有的物品、指向不存在的物品 ID 的计数器、指向不存在的计数器 ID 的人。

她也能说话。 当玩家点击她时，一个 speaker 为她的 id 的 dialogue_graph 会提供她的台词；你的模组无需重新定义游戏已经拥有的任何内容即可获得这些台词——参见自定义对话。一个 locales 文件会以七种语言提供全部内容。

如果没有显示任何内容： 首先检查这三个 ID，然后没有显示，然后在向任何人寻求帮助之前。

建筑物的服务

你将在定居点有一扇门，上面有你的标签和颜色，打开后可进入游戏已有的内部空间。

屏幕截图： 尚未拍摄。

先阅读： 保留它的商人 · mod 永远做不到的事情

复制自： chandlery/content/world/buildings/buildings.json。

文件去向：

where the files go

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

您正在重新组合，而不是构建。 buildings 记录添加了带有标签、端口颜色和例程角色的新服务，并且可以通过命名来重用游戏已有的扩展。不能带延期。扩展是场景，场景是代码，命名路径 res:// 或 .tscn 的数据包在读取该记录之前就会被拒绝。这不是一个等待填补的洞：它是一条可以安全安装陌生人模组的线路。

a buildings record

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

完成 - 现在在游戏中找到它。重新启动并输入有您的服务的定居点。没有 settlement 的记录会被加载并放置在任何地方，这与失败的记录相同：Mod 屏幕会显示 1 entry added，但您将找不到任何内容。在寻找门之前先阅读线路。

如果没有显示： 什么都没有显示 · 在向任何人寻求帮助之前。

地图上的一个地方

您将在世界地图上找到一个玩家可以偶然发现的地点，并附有该地点的描述及其对队伍情绪的影响。

屏幕截图： 尚未拍摄。

先阅读： 建筑服务 · 现在在游戏中找到它

复制自： chandlery/content/world/pois/pois.json。

文件去向：

where the files go

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

坐标是绝对的，世界会围绕作者预先制作的地点生成。地图大小为 61 440 × 34 560 世界像素，Old Seat 在每局中都正好位于中心 (30720, 17280)。作者制作的城市和村庄会保留自己的名称与位置。种子会改变它们周围的地形和生物群系、当年的短缺、政治格局以及值得行走的道路。因此一个点仍是真实且稳定的地点，但它 旁边 的内容每局都会变化。诚实的用法有两种：把兴趣点放在作者制作的聚落附近，让玩家一定会经过；或者选择空旷之处，因为多年无人走过的渲染坑本来就不该位于某个特定地点。

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

完成 - 现在在游戏中找到它。 去做吧。无论是在调试版本中还是在外部，都没有传送命令，因此请选择您愿意在尝试时行走的坐标。

如果它没有出现： 你可能已经超出了 discovery_radius，或者位置是比赛种子放置海洋的某个地方。 什么也没出现。

改变已有的东西

您将更改游戏带来的记录 - 并且您将声明它，因此玩家和所有其他模组都可以看到更改。

屏幕截图： 尚未拍摄。

先阅读： 更改游戏已有的内容 · 当两个 mods 想要相同的东西时

复制自： chandlery/content/economy/goods/goods.json，在同一文件中添加一条记录并纠正游戏中的一条记录。

文件去向： 没有新的地方。对游戏中已存在的内容的更改与您的记录所在的同一个家庭文件夹中 - 该文件说明了它想要哪个记录以及它正在对它做什么。

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

文件之前有两条规则。 对他人记录的更改必须在 mod.json 内的 overrides 中命名 - 落在您未声明的 id 上的记录将被拒​​绝，因此没有任何东西可以秘密重写玩家不同意的内容。而 patch 则更改一个字段并保留其余字段，需要 "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" }
    ]
  }
]

完成 - 现在在游戏中找到它。 Mod 屏幕为您获得的记录命名。另一位作者的屏幕也这样做，如果有的话：当两个数据包写入相同的 id 时，失败者的行现在显示*替换：蜡烛 - 'chandlery'最后写入*，而不是默默地显示比他写的少一个条目。谁的 load_order 最高，谁就最后写入并获胜。

获胜与获得许可不同。 两个数据包在 supersedes 中没有命名另一个记录的情况下被报告为 undeclared_collision 并且组合不好：离线验证器说了同样的事情并拒绝：

typed into the debug console

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

获胜者仍然是计算出来的，因为拒绝并不一定是抛硬币，但两个都想要的作者必须这么说。 当两个模组想要同样的东西时 就是这样的对话。

如果没有出现： 通常的原因是 overrides — id 必须在该列表中，并且准确写入，否则记录将被拒​​绝而不是应用。 当两个模组想要相同的东西时 · 什么都没有出现。

十分钟搞定模组

1.在你的mods文件夹中创建一个文件夹，名称小写加下划线：northern_reach。一切都发生在那里。

2.在顶部写入mod.json：

mod.json

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

id 必须与文件夹名称匹配。 content_types 列出了您带来的系列 - 该行中缺少的系列永远不会被读取，无论文件夹中有什么。

3.创建文件夹 content/inventory/items 并将 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
  }
]

方括号是一个列表：添加任意数量的剑，用逗号分隔。 Family 文件夹中的每个 .json 文件都会被读取，因此可以根据需要拆分它们。

240并不是一个为了给人留下深刻印象而选择的数字。在这个游戏中，单手武器的范围从50到300，所以240的霜刃是一把昂贵的剑，而不是传奇剑，玩家大约在他能买得起铁匠已经出售的好剑的时候就可以买得起它。 游戏号码在哪里 是在选择任何号码之前要查看的表格；旁边没有任何内容的价格是一个假设，而在城市之间进行贸易的经济中，假设不会停留在你设定的地方。

4.启动游戏并从主菜单打开模组。您的包裹仅获得一种状态，而 加载了吗？ 具有全部六种状态。

5.阅读下面的行，了解已阅读、应用和拒绝的内容，以及每次拒绝的原因。 显示详细信息 有 ID。

6。你的剑就在游戏中。 接下来的一切都差不多。

现在在游戏中找到它

报告称applied。这意味着记录已加载，这与能够走在记录前面不同。这是每个指南停止的地方，也是每个作者开始猜测的地方。

settlement_id 指向作者预先制作的地点。聚落 ID 是作者预先制作且稳定的：Durnwall、Thorngate、Valdmere、Grentham 和十二个村庄都可以命名。种子改变它们周围的地形和生物群系、当年的短缺以及政治格局，但不会改变 ID。如果你希望某个人物一定会被玩家遇到，就使用任意作者制作的聚落 ID，并把名称保存在 mod 包的语言数据中。

坐标是绝对的，世界会围绕作者预先制作的地点生成。地图大小为 61 440 × 34 560 世界像素，Old Seat 在每局中都正好位于中心 (30720, 17280)。作者制作的城市和村庄会保留自己的名称与位置。种子会改变它们周围的地形和生物群系、当年的短缺、政治格局以及值得行走的道路。因此 (6000, 2200) 的 world_position 在地图最西北仍是一个真实且稳定的点，但它 附近 的内容每局都会变化：可能是道路、森林，也可能是荒地。诚实的用法有两种：

• 仍在中心。 在每场游戏中，距 (30720, 17280) 几千像素的兴趣点都位于旧座位附近，因此这是玩家会找到的地方。
• 你的意思是空虚。一百年来无人经过的废墟，一定在任何地方。绝对坐标对此完全正确，种子将决定它的邻居。

最节省时间的控制台命令。 day [n] 和 hour [n] 提前时间，这就是您在不体验电源的情况下看到电源的方式。 item <id> [count]和gold <amount>把东西交到你手里。 flag、quest_start 和 faction_rep 移动条件可能正在等待的状态。没有传送命令：要到达一个地方，就前往那里。

mod.json，逐个字段

依赖项可以是对象而不是名称：{"id": "some_mod", "version": "", "optional": true}。

命名另一个包的值是​​跨模块引用，并且该引用必须是已声明的依赖项。如果该依赖项是可选的，请为该字段指定 fallback，否则当依赖项不存在时，该记录将被跳过：

a goods record

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

每个文件的去向

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

姓名和 ID

id 是小写字母、数字和下划线，仅此而已。 frost_blade，不是 Frost Blade，不是 frost-blade，也不是 frost.blade。它甚至不带有自己的分隔符，因为 id 内的分隔符是泄漏到名称中的文件夹：移动文件并且 id 不再与磁盘一致。上面的 : 是唯一的例外，两半都遵循规则。

冒号之前的部分是您的包 ID。这就是两个模组可以同时添加冰霜之刃而不发生冲突的方式。

玩家读到的单词

记录中写入的文本是单一语言的文本。相反，指向一个键：

a locale CSV

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

键是小写的，由点连接，命名空间作为 id。将单词带入 locales 系列 - content/locale 下的 .csv 以及 key 列和语言列。 家庭，一一 具有精确的形状。

还要在密钥旁边写上简单的 display_name。一张只有一句话的记录，翻译的那天就得用手重写，到那时就会有四百条。

犯错的两种方法会以非常不同的方式失败，只有其中一种告诉你这一点。 不响应任何操作的按键本身会显示为按键本身 - northern_reach.item.frost_blade.name，在屏幕上，故意丑陋以便有人修复，并算作一个洞。仅包含文本而没有键的记录永远不会出现：它以您的语言适用于每种语言的每个玩家。没有任何内容被拒绝，没有任何内容丢失，因此没有任何报告，并且用葡萄牙语阅读的玩家默默地阅读您的意大利语。你发现第一个错误。第二个找到你的读者。

翻译模组并被翻译

该游戏有七种语言版本，因此对于七分之六的安装者来说，记录中包含英语的软件包读起来就是英语。这就是避免它的成本，如果你在第一天这样做，这几乎没有什么，如果你在第四天这样做，则需要重写。

那里的语言

七，这个表是从构建中读取的，而不是在这里手写的，因此到达或离开的语言会在同一天移动它：

其中两个代码有第二个拼写在流通中 - pt-BR 是数字店面使用的拼写，本页 pt_BR 是引擎符合的拼写 - 并且 在列标题中两者都被接受。 写下您复制的那个。

携带不止一种语言的单词

content/locale 下的 CSV，其中 key 第一个，每种语言一列：

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

当按键没有以玩家的语言进行响应时，游戏会沿着固定的阶梯下降：玩家的语言，然后是您的软件包声称编写的语言，然后是游戏目录，然后是按键本身。最后一步是故意丑陋的：未解决的密钥必须看起来是错误的，才能有人修复它。完全转换会跳过游戏目录，因为 Old Seat 出现在另一个大陆的世界中并不是一个小的翻译疏忽，而是闪耀的基础游戏。

编写可翻译的文本

• 没有分段构建的句子。 词序在所有语言中都不相同，因此在运行时从一列形容词和一列名词组合而成的名称会在意大利语中生成 Oro Cervo。为每种语言编写一个完整的条目。
• 人名永远不会被翻译或变形。 Aldric 在所有语言中都是 Aldric。这也意味着按键不得将名称放在倾斜位置 - "of {name}"、"{name}'s" - 因为许多语言拒绝使用专有名称，而游戏则不会。
• 没有字符限制，这与没有限制不同。 没有字段计算字符数；最终成为屏幕空间。德语比英语长约三分之一，是一种令人兴奋的语言。中国人要短得多，而且几乎从不这么做。如果您只尝试一种翻译，请尝试德语，并为标签提供仍然正确的最短措辞。

翻译您的包裹的人

添加一列并将文件发送回给您。工作流程都在这里，这就是为什么格式是 CSV，而不是对程序员更友好的格式：翻译人员可以在电子表格中打开它，并且他们的工具已经读取它。

翻译的软件包和未翻译的软件包之间有两点区别。 保持密钥稳定 - 重命名的密钥是丢失的翻译，翻译器会在玩家发现时发现。 说出一行的用途：名为 NR_MSG_01 的键得到猜测，而 northern_reach:VENDOR_HERB_GREETING 得到草药卖家的问候。

如果你是翻译别人的包的人，同样的规则也会约束你：列是游戏携带的语言，键是它的键而不是你的，名称仍然是名称。

改变游戏已有的内容

part of mod.json

"overrides": ["iron_sword"]

overrides 是一个承诺。 落在您未声明的 ID 上的记录将被拒​​绝，因此您永远无法悄悄更改玩家一无所知的内容。

a goods record

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

补丁一次命名其更改：

• 设置 — 将 value 写入 field，无论之前是什么。它是用field和value编写的。
• unset — 从记录中删除 field，以便读者看到该系列的默认值。它是用field编写的。
• append_unique — 将 value 添加到 field 中的列表（如果尚不存在）。它是用field和value编写的。
• remove_value — 从 field 的列表中删除每个出现的 value。它是用field和value编写的。

• 按路径命名字段，而不是按位置。 tags.0 被拒绝。今天的第三个标签是你上传别人的mod后的第二个标签。
• 路径最多由四个由句点连接的小写名称组成。 任何包含运算符的内容都会被拒绝。
• append_unique 是两个 mod 可以共享的标签。 如果它们都排队相同的标签，则不是冲突，也不会加倍。

只是有时

记录可以告诉你什么时候值得。在 op 旁边添加 when，与 "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" } }
}

没有运算符，也没有什么可计算的。条件可以说的所有内容都在这两个表中。

when 中最多有四个受试者，每个受试者进行两次试验。对同一主题的两次试验是一个区间：{ "day": { "at_least": 10, "at_most": 30 } }。

哪个家庭拿什么。 每个家庭拿三个在装载时决定的。只有 presentation_bindings 和 effects 会采用在游戏时移动的四个，因为当世界发生变化时只有这两个会被重建。在其他地方提名 season 会被拒绝，并且该消息会说明该家庭真正选择的科目。

原因就在于救助。决定一个项目、一个人或一个任务的记录在下次加载时必须是相同的记录，而移动条件正是阻止它这样做的原因。

季节性皮肤出现在链接上，而不是图像上。 仅将图像带一次，然后为她提供两条 presentation_bindings 记录：一条带有 when，一条没有。 images、audio 和 fonts 拒绝 when 而不进行讨论。

保留并不被拒绝。 不满足的条件保留其记录，负载报告按名称说明：

what the game prints back

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

包含五十个赛季记录的包在任何时候都有四分之三保持。这是有效的包。

如果任何条件表示关联被拒绝，报告仍显示声明的系列并打印 bound=0 以及每个 WITHHELD 行；不会错误地将包裹报告为没有展示面。如果没有无条件绑定提供相同的槽，它还会打印 NO_APPLICABLE kind/subject/slot 以及未答复的条件，这意味着“在此世界状态中没有任何内容适用”，而不是“记录无效”。在假设关联已被拒绝之前，使用相应的世界状态测试主机或运行时通道中的条件。

同一事物的两个版本。 带来两个具有相同 id 和不同条件的 add 记录。条件成立的人就是发起指控的人。如果两者都成立，则第二个将被视为重复而被拒绝 - 这就是报告重叠条件而不是通过文件顺序解决的方式。

删除一些东西

remove 表示*停止*，而不是*不存在*。该记录继续自行解决并被标记：不再提供、库存、制造或生成任何新东西，并且玩家已经拥有的一切以及命名他的人继续准确地阅读他一直阅读的内容。

a goods record

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

vendor_inventories 是唯一一个删除记录的系列，而且只是因为保存规则已经表明没有人指向该行。

remove 不能携带 when。必须决定救援可能命名的撤回，否则 id 会在一天晚上解决，而不是第二天晚上。

对于组合而言，删除是永久性的。 针对已停用 ID 的后续 patch、replace 或第二个 remove 都会被拒绝，即使商品召回通过永久删除使旧记录保持可解析。这可以防止保存报告指示“已停用”，而后续包会导致记录再次按提供的方式运行。当需要新记录时添加新的命名空间ID；不要依赖移除然后默默复活。

当两个模组想要同样的东西时

他们都加载。每个更改都是在构建之前完成的，因此游戏可以看到两者。

赢得和获得许可是两个不同的问题，这就是令人惊讶的部分。游戏总是计算它最后写入的数据包——如果让它碰巧的话，即使是抛硬币也会被拒绝——并且仍然将这对数据标记为没有人声明的冲突。离线验证器会在没有讨论的情况下拒绝同一对，因此您可以在玩家之前发现。

宣言中的 supersedes 是你表达自己故意这样做的方式。命名另一个数据包的 id，冲突变为 declared_replacement：已注册，有原因，不再是错误。

给你的包一个自己的load_order。 两个共享一个号码的包不会被拒绝，然后获胜者就会脱离mod id的字母顺序：一个作者没有选择的顺序，并且没有玩家可以在屏幕上读取。

图像、声音、文字、色彩

引入文件和“使用”它是两个单独的步骤，并且您都需要。没有任何指向的文件被读取、检查、测量并且从不显示。

带上文件

每个资源族都是一个文件描述符加上它命名的文件。描述符的命名必须与其系列相似：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"
  }
]

三个咬人的规则：

• 在对其进行解码之前会检查标头。 format 是文件的内容，而不是扩展声明的内容。
• 包含 .. 或 ~ 或以 /、\、res:// 或 user:// 开头的 file 名称将被拒绝。
• 无法解析的 id 会收到占位符和警告，永远不会沉默。

赌上它

在您携带的记录上，其中包含一个包含您的图像 ID 的字段：

任何内容，包括基本游戏内容，并使用 presentation_bindings 记录命名主题、其类型和槽位：

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 是强制性的：它是语言密钥，对无法接收图像的玩家说同样的事情。

声音

role 是一个限制，而不是一个标签：每个都有自己的最大持续时间、一起玩的上限以及玩家寻找的光标。

压缩的 WAV 会被拒绝：对其进行解码需要解析器，而解析器正是您要避免的东西。

著作

covers 命名您的字体携带字形的语言，并且构建拒绝为任何其他语言安装它。缺少语言的角色不会失败：画一些小方块，屏幕上读起来就像半成品的翻译，有正确的文本和字体的错误。

fallback_font 是必需的：命名您自己或系统系列的另一个字体 ID（Segoe UI、Noto Sans）。 sizes 是字形缓存的计算依据。

只有一个字符，而不是一个集合 - .ttc 包含多个字符，并且哪个到达取决于描述符无法携带的索引。覆盖范围广泛的免费字体：Google Fonts, Font Squirrel.) 检查许可证是否允许您重新分发该文件 - 您的软件包中包含该文件。

颜色

令牌，绝不是场景、脚本或资源路径。这些名称是游戏的名称：bg_deep、bg_mid、bg_button、bg_hover、border、border_hi、text、text_dim、accent、 gold。日志中提到了此构建不知道的名称，而不是坐在那里似乎已应用。

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 以 4.5 及以下的比率进行检查，主题将被拒绝。 WebAIM 测量仪 在您佩戴前告诉您一双的比例。

关闭包装，界面恢复其颜色和文字。

感觉良好的艺术

构建检查图像是否是图像。它对于它看起来是否正确没有什么可说的，在一个用灰色绘制的世界中，一把明亮、欢快、高分辨率的剑并不会因为通过了所有的审查而不再是错误的。这就是今天所知道的。

完整的风格指南尚未发布。 它将带来什么：调色板本身、绘制每种类型事物的尺寸，以及并排说明世界中的事物和事物的结果的示例。等待它而不是猜测是值得的，因为它防止的失败不是一个被拒绝的文件：它是一个可以完美安装并使游戏感觉像两个游戏的包。

只要它不存在，可靠的方法就是不需要任何文档的方法：将您的图像放在游戏图像旁边，然后将它们放在一起查看。

你的地图

在[Tiled]中绘制（https://www.mapeditor.org/),导出到.tmj，索引到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"
  }
]

命名另一个包（或基础游戏）内容的链接会导致整个布局被拒绝。 modding_map_report 命名该规定以及拒绝它的规则。

你的使命

任务是一组仅在 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"]
  }
]

• 计划要么全有，要么全无。 一个错误的记录并且没有安装：另一种选择是一条弧线，在玩家拿着剑而不是标题的情况下停止。
• 奖励是 grant，而不是 kind。 kind 表示这是四个记录中的哪一个。用kind写的奖励读起来很好，被拒绝了。

使用 modding_quest_plan_report 检查您的。

你的谈话

对话是 content/narrative/dialogue 中的三种类型的记录：dialogue_graph 对其进行命名并说明其在哪个柱上打开，dialogue_node 柱是线，以及其上方的 dialogue_option 选择。

你的台词就是你的台词，没有什么可以重写它。 本地模型可以做的就是回答玩家写给角色的问题，并留在你的台词内——当它不能留在里面时，它会说它不知道。由玩家决定该表面是否存在；模型关闭后，角色说出你的句子并停止。你的笑话的翻译来自语言文件，就像你写的其他内容一样。

该图命名为 speaker，触发器就在那里。游戏中的每个角色都会在点击时询问这个家庭他们上方有哪些对话，因此您可以给铁匠一些话要说而无需重新定义铁匠。

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

你写的是对话，而不是文字：每个笑话都是一个语言密钥，因此同一个包可以用玩家拥有的所有语言阅读。携带散文的数据包会被文件而不是屏幕拒绝。

笑话和选择可以包含每个条件，选择可以包含命令。条件决定了是否向玩家显示该事物；命令就是他接受命令时发生的事情。

• 命名此构建无法执行的操作的对话永远不会打开。不是使用它的选择：整个对话，在其第一行之前。停在第三个选项的讨论已经拿走了玩家的金币。
• 没有什么比有的更移动了。 首先用 has_coin 或 has_item 询问；一个忘记它的包裹不能让玩家减掉四十个硬币，因为没有人接受过债务，也没有屏幕解释这一点。
• 每个笑话都需要一条出路。 当图表加载时，玩家可以到达但无法离开的笑话会被拒绝。

使用 modding_dialogue_report 检查您的。

你的场景

场景是唯一一种脱离玩家控制的内容类型，因此它也是唯一具有结束规则的内容。这些场景位于 content/narrative/scenes 中，每个场景都命名为 where，即播放的位置。进入那个地方，场景就开始了。

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

• 删除控件的场景必须返回它们。 没有 unlock_player 结束的序列将被拒绝，因为替代方案是带来一个玩家只能通过关闭游戏退出的房间。
• 线路按顺序排列，并且预计会出现阻塞线。这就是使场景成为场景而不是同时发生的一系列事情的原因。

使用 modding_scene_report 检查您的。

你的截图

屏幕布局告诉您哪些部分位于游戏已有屏幕的哪个面板中，以及按什么顺序。它列出了该构建绘制的各个部分；他无法添加一个，因为没有人写的部分没有什么可画的。

这些规定位于 content/ui/screens 中。 家庭，一一 有字段和记录可供复制。

使用 modding_screen_report 检查您的。

什么也没有出现

首先阅读 Mod 屏幕上的状态。几乎每个州都公开地在线指出了这个问题，最常见的错误也是如此：曾经位于该列表顶部的错误。

content_types 中缺少的系列。 您写入 goods.json，但在清单列表中忘记了 "goods"，并且该文件夹从未打开：没有任何内容被拒绝，因为没有读取任何内容。包裹装载为空。现在屏幕会告诉您它浏览了哪个文件以及要添加的内容：

what the game prints back

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

离线验证器打印相同的句子，因此两者不能不一致。仅当该行显示已加载且未命名任何未读文件时，才查看此列表。这是按照每个人成为罪魁祸首的频率排列的。

报告永远不会让你猜测。被拒绝的记录会被命名，它出了什么问题，并且通常带有代码 - 请参阅每个诊断代码。

出现了，而且是错误的

最困难的情况，因为根本没有任何报道。有两件事通过了所有的审查，但仍然给你一份不是你写的记录。

您省略的字段不是错误：它是默认值。 每个系列的架构都会告诉您记录不能没有哪些字段，并且对于几乎所有系列来说，该列表都很短。 goods 只需要一个：id。省略base_price，则为1。省略weight，则为1.0。省略category，商品为原材料。没有什么会提醒你，因为没有什么错：你要求一件好事，你就得到了一件。

即使不在选项中的值也是默认值。 读者在搜索之前将所有大写字母放在一起，因此 manufactured 和 MANUFACTURED 是相同的值，大写从来都不是问题：不要为此重写文件。问题是MANUFACTURED_GOODS：它不是成员，所以变成了RAW_MATERIAL。 decay_tier 的 SLOW 变为 ETERNAL。记录安装完毕，屏幕显示已应用，您的蜡烛具有其他东西的价格和易腐烂性。

游戏中没有任何内容说明这一点，因为没有什么可说的：该字段被声明为字符串，拼写错误的字符串仍然是字符串。验证器是唯一可以使用它的地方，现在它使用它：

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

这是警告而不是错误，因为记录实际上加载并且现在拒绝它会破坏已经工作的包。 --strict 将其变成错误，这就是您在发布之前运行 --strict 的全部原因。

您省略的字段保持沉默，并且不能被采用：省略 category 和写入 RAW_MATERIAL 是相同的请求。因此，家庭，一一 中的字段表标记为必填，并将值列指定为*加载程序检查的形状*。当一条记录加载并表现得像其他记录时，首先将您的字段与该表进行比较：您要查找的是您没有编写的字段，或者加载程序无法识别的单词。

每个家庭

每个家庭一个文件夹和一份报告。状态栏是在构建时测量的，因此它绝不是游戏不兑现的承诺。 它是什么只是开头行，因此表格仍然是您可以用眼睛滚动的内容；每个家庭的完整描述及其字段和要复制的记录位于家庭，一一 中的条目。

• 开箱即用 - 发布形式，游戏安装您的记录，有一个示例，并且您的 ID 在保存和重新加载后仍然存在。
• 已验证，但目前没有任何内容消费它——加载器会读取并检查该系列，但没有面向玩家的 mod 包界面消费它。音频和字体 mod 包属于这一档：干净的报告不会让静音信号或未使用的字体出现在游戏中。
• 已检查，尚未安装 - 游戏会识别该系列并检查您的文件，并且不会将其放入正在进行的游戏中。以它为目标的包通过了所有检查并且不加载任何内容。它是故意出现在页面上的：另一种选择是有人在那里度过一个晚上而从未发现他们没有做错任何事。

完全决定，没有任何家人携带，所以没有海报可以问她：

这不是浪费。 mod 永远不能做的事情 就是这个列表。

一家人，一一

构建的每个系列都知道，它接受什么，以及您可以复制的记录。

• 强制字段是指没有这些字段就无法安装记录的字段。
• 值列是加载器检查的形状，而不是提示。
• 如果一个家庭这么说，表中未命名的字段将与其所在的记录一起被拒绝。字段名称中的拼写错误是一条无法加载的记录，家庭报告按名称也是如此。

每个条目还说明了玩家卸载你的那天保存会发生什么：

这里没有任何手写内容。这些字段来自每个系列的已发布架构。每个示例都是框架的测试数组针对加载器旋转的包之一，放回到 northern_reach 命名空间下，并在进入此页面时根据其模式重新检查：游戏将拒绝的示例会导致构建失败。

世界及其包含的地方

5个系列：buildings、caravans、maps、pois、world_generation。

buildings

定居点的建筑物和服务的定义：标签、颜色、角色和重复使用的内饰。

• 状态 可供使用
• 旅行过 建筑物的服务
• 文件夹 content/world/buildings
• 为 id 字段路由的记录
• 报告 modding_building_report
• 如果玩家卸载了你 substitute_placeholder。曾经有服务的地方如果有漏洞，则无法进行；读取并恢复了明显缺失的建筑物。

字段。 此表未命名的字段将随记录一起被拒绝。

在名为 buildings.json 的文件中，或者在该文件夹中您喜欢的任何名称 .json 中：

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

商队行进的贸易路线：从哪里出发、要去哪里、带来什么、护送的情况以及行进的速度。

• 状态 可供使用
• 文件夹 content/logistics/caravans
• 为 id 字段路由的记录
• 报告 modding_caravan_report
• 如果玩家卸载了你 preserve_inert_reference。数据包消失的路由保留其名称并且不携带任何内容。更换目的地会将玩家的货物发送到他们从未接受过的地方。

字段。 此表未命名的字段将随记录一起被拒绝。

在名为 caravans.json 的文件中，或者在该文件夹中您喜欢的任何名称 .json 中：

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

包在 Tiled 中绘制的排列，由 id 命名：文件、它在世界上的位置以及已知它的语言键。索引就是记录；它旁边的排列被读取为数据而不是资源，标准化为规范形式，对照已发布的套件进行检查并在放置任何东西之前进行组装。被拒绝的布局根本不会放置任何东西，因为一半的地图是玩家进入的区域，而无法知道哪一半已经到达。

• 状态 可供使用
• 文件夹 content/world/maps
• 为 id 字段路由的记录
• 报告 modding_map_report
• 如果玩家卸载了你 drop_optional_presentation。没有任何救援能够命名处置。保存会命名布局已移动的兴趣点，并且该记录保留其坐标，因此退役地图会花费布局而不是内容。放弃它才能让世界回到它的记录所说的那样，而不是坚持一个没有人再提供的立场。

字段。 此表未命名的字段将随记录一起被拒绝。

在名为 maps.json 的文件中，或者在该文件夹中您喜欢的任何名称 .json 中：

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

手写世界地图上按坐标放置的兴趣点。

• 状态 可供使用
• 前往 地图上的地点 的路线
• 文件夹 content/world/pois
• 为 id 字段路由的记录
• 报告 modding_poi_report
• 如果玩家卸载了你 preserve_inert_reference。一个被发现的地方仍然被发现。任务和旅行历史都指向 ID。

字段。 此表未命名的字段将随记录一起被拒绝。

在名为 pois.json 的文件中，或者在该文件夹中您喜欢的任何名称 .json 中：

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

仅由数据组成的生成配置文件：生物群落和位置的加权选择，由主机拥有。

• 状态 可供使用
• 文件夹 content/world/generation
• 为 id 字段路由的记录
• 报告不是他的； modding_preflight_report 负责处理它
• 如果玩家卸载了你 preserve_inert_reference。保存会记录所选配置文件的 ID。如果它的包丢失，保留并报告该 ID 比使用基础游戏地图默默地重建游戏更安全。

字段。 此表未命名的字段将随记录一起被拒绝。

在名为 profiles.json 的文件中，或者在该文件夹中您喜欢的任何名称 .json 中：

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

人、家庭以及他们能做什么

8 个系列：enemy_archetypes、enemy_variants、group_archetypes、mercenary_templates、noble_houses、npc_definitions、perks、relationships。

enemy_archetypes

战略级别知道的敌人类型：等级、他们部署的变种、他们扎营的地方、驻军有多大以及他们袭击的频率。

• 状态 可供使用
• 文件夹 content/threat/enemy_archetypes
• 为 id 字段路由的记录
• 报告 modding_enemy_archetype_report
• 如果玩家卸载了你 preserve_inert_reference。一个阵营仍然指向它的建立者。替换会悄然改变围困定居点的事物；命名我们读到的缺席。

字段。 此表未命名的字段将随记录一起被拒绝。

在名为 enemy_archetypes.json 的文件中，或者在该文件夹中您喜欢的任何名称 .json 中：

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

场上敌人身体类型的统计数据块：类别、等级、五种属性以及武器、副手和其携带的盾牌的 ID。

• 状态 可供使用
• 文件夹 content/combat/enemy_variants
• 为 id 字段路由的记录
• 报告 modding_enemy_variant_report
• 如果玩家卸载了你 substitute_placeholder。已经在场上但没有属性块的身体无法进行战斗。引擎所拥有的稳定替代品使战斗可以解决，并且原始ID也被保留下来。

字段。 此表未命名的字段将随记录一起被拒绝。

在名为 enemy_variants.json 的文件中，或者在该文件夹中您喜欢的任何名称 .json 中：

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

生活在世界地图上的群体的可调整策略参数：警告半径、目标偏好、成员数量、补给和撤退阈值。

• 状态 可供使用
• 文件夹 content/strategic/group_archetypes
• 为 id 字段路由的记录
• 报告 modding_group_archetype_report
• 如果玩家卸载了你 substitute_placeholder。战略情报必须读取某个地方的阈值。它响应引擎拥有的默认值，这与该系列已经依赖的相同。

字段。 此表未命名的字段将随记录一起被拒绝。

在名为 group_archetypes.json 的文件中，或者在该文件夹中您喜欢的任何名称 .json 中：

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

可雇用的雇佣兵模型：姓名、阶级、出身、初始健康状况和士气、雇用成本以及首次出现的日期。

• 状态 可供使用
• 文件夹 content/character/mercenaries
• 为 id 字段路由的记录
• 报告 modding_mercenary_report
• 如果玩家卸载了你 preserve_inert_reference。已经雇佣的雇佣兵作为一个单位生活在救援中；只有酒馆列表失去了模板。 id 仍然被命名，因此有机物的来源仍然可以读取。

字段。 此表未命名的字段将随记录一起被拒绝。

在名为 mercenaries.json 的文件中，或者在该文件夹中您喜欢的任何名称 .json 中：

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

贵族家族的初始数据：领主、继承人、家族所属的定居点以及谁算作竞争对手或盟友。

• 状态 可供使用
• 文件夹 content/politics/noble_houses
• 为 id 字段路由的记录
• 报告 modding_noble_house_report
• 如果玩家卸载了你 preserve_inert_reference。玩家对房子的重视程度会记录在他的id上。更换一个就重写，而无需对那些忠诚的人说任何话。

字段。 此表未命名的字段将随记录一起被拒绝。

在名为 noble_houses.json 的文件中，或者在该文件夹中您喜欢的任何名称 .json 中：

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

指定 NPC 的定义。

• 状态 可供使用
• 进入 持有它的商人
• 文件夹 content/narrative/npcs
• 为 id 字段路由的记录
• 报告 modding_npc_report
• 如果玩家卸载了你 preserve_inert_reference。一个拥有被全世界记住的名字的人与一个从未存在过的人是不一样的，报告指向了这个身份。

字段。 此表未命名的字段将随记录一起被拒绝。

在名为 npcs.json 的文件中，或者在该文件夹中您喜欢的任何名称 .json 中：

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

声明性权限：触发器和效果，无需用代码编写任何处理程序。

• 状态 可供使用
• 文件夹 content/character/perks
• 为 id 字段路由的记录
• 报告 modding_perk_report
• 如果玩家卸载了你 preserve_inert_reference。角色会保留他所赢得的东西。删除某个功能会默默地重写玩家在游戏中所花费的建筑物。

字段。 此表未命名的字段将随记录一起被拒绝。

在名为 perks.json 的文件中，或者在该文件夹中您喜欢的任何名称 .json 中：

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

交配模式、有界关系政策、招募条件和声明性纽带。

• 状态 可供使用
• 文件夹 content/companion/relationships
• 为 id 字段路由的记录
• 报告不是他的； modding_preflight_report 负责处理它
• 如果玩家卸载了你 preserve_inert_reference。伴侣关系的种子仍然附着在他的身份上，因此删除包裹并不能默默地消除信任、怨恨或遗弃历史。

字段。 该系列包含多个记录类型，并且每种类型都会根据自己的列表进行检查。该表未命名的字段将与记录一起被拒绝。

一条带有kind: bond的记录：

一条带有kind: companion_template的记录：

一条带有kind: recruit_terms的记录：

一条带有kind: relationship_policy的记录：

在名为 relationships.json 的文件中，或者在该文件夹中您喜欢的任何名称 .json 中：

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

事物、贸易和冲突背后的数字

5个系列：combat_balance、goods、items、recipes、vendor_inventories。

combat_balance

有界战斗平衡值，无需添加规则、操作或机制即可调整现有解算器参数。

• 状态 可供使用
• 文件夹 content/combat/balance
• 为 id 字段路由的记录
• 报告 modding_combat_balance_report
• 如果玩家卸载了你 substitute_placeholder。余额是主机持有的定义数据，而不是玩家的库存。当其包不存在时，规范且稳定的平衡会做出响应，并且随后的加载不会带来保存调整的第二种方式。

字段。 此表未命名的字段将随记录一起被拒绝。

在名为 balance.json 的文件中，或者在该文件夹中您喜欢的任何名称 .json 中：

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

适销对路的商品及其经济特性。

• 状态 可供使用
• 旅行过 A good-to-sell
• 文件夹 content/economy/goods
• 为 id 字段路由的记录
• 报告 modding_goods_report
• 如果玩家卸载了你 preserve_inert_reference。一个侍从说出无人提供的商品的名字，这就是诚实的。取代她会默默地改变一名球员的能力。

字段。 此表未命名的字段将随记录一起被拒绝。

在名为 goods.json 的文件中，或者在该文件夹中您喜欢的任何名称 .json 中：

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

库存物品，包括武器和盔甲。

• 状态 可供使用
• 路径为 要携带的物品
• 文件夹 content/inventory/items
• 为 id 字段路由的记录
• 报告 modding_items_report
• 如果玩家卸载了你 preserve_inert_reference。存储库不断命名其中的内容，这是重新安装将其返还给他们的唯一原因。

字段。 此表未命名的字段将随记录一起被拒绝。

在名为 items.json 的文件中，或者在该文件夹中您喜欢的任何名称 .json 中：

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

工艺配方：消耗什么、产生什么、在哪里制造、成本多少以及变质的可能性有多大。

• 状态 可供使用
• 文件夹 content/economy/recipes
• 为 id 字段路由的记录
• 报告不是他的； modding_preflight_report 负责处理它
• 如果玩家卸载了你 preserve_inert_reference。保存中没有任何内容命名配方：保存命名进程生成的对象，并且该对象的族对其负责。退役的食谱留下的是一个不再提供某些东西的站，这是报告的而不是固定的，因为发明一个替代食谱会将一个没有包提供的物品放在玩家手中。

字段。 此表未命名的字段将随记录一起被拒绝。

在名为 recipes.json 的文件中，或者在该文件夹中您喜欢的任何名称 .json 中：

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

商家供应表。

• 状态 可供使用
• 进入 持有它的商人
• 文件夹 content/world/vendor_inventories
• 为 id 字段路由的记录
• 报告 modding_vendor_inventory_report
• 如果玩家卸载了你 drop_optional_presentation。库存得到再生。货架为空的商家是可读状态，并且该行不指向任何其他内容。

字段。 此表未命名的字段将随记录一起被拒绝。

在名为 vendors.json 的文件中，或者在该文件夹中您喜欢的任何名称 .json 中：

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

故事、任务和玩家读到的文字

9个系列：dialogue、locales、lore、mr_lines、progress、quest_metadata、quest_plans、quests、scenes。

dialogue

作为记录的对话：图表、其中的笑话以及上面的选择。三种类型共享该系列，kind 表示是哪一种。包编写对话，而不是单词 - 每个击键都是一个语言键 - 每个条件和每个结果都是此构建已经执行的检查或命令。

• 状态 可供使用
• 文件夹 content/narrative/dialogue
• 为 id 字段路由的记录
• 报告 modding_dialogue_report
• 如果玩家卸载了你 preserve_inert_reference。保存记录了对话所做的事情——一个已经转移的任务、一个易手的物品、一个学到的真相——而不是对话本身，它在你写东西的那一刻就结束了。当包裹消失时，后果仍然存在，因为它们从来都不是对话的一部分，而且对话也不再被提供。替换它会将单词放入其作者从未写过的角色的嘴中。

字段。 该系列包含多个记录类型，并且每种类型都会根据自己的列表进行检查。该表未命名的字段将与记录一起被拒绝。

一条带有kind: dialogue_graph的记录：

一条带有kind: dialogue_node的记录：

一条带有kind: dialogue_node的记录：

一条带有kind: dialogue_node的记录：

一条带有kind: dialogue_option的记录：

在名为 gate_toll.json 的文件中，或者在该文件夹中您喜欢的任何名称 .json 中：

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

赛程包含12条记录；示出了3个。

locales

玩家读取的单词，采用 CSV 格式，每种语言一列：包自己的密钥，以及包声明覆盖的游戏的密钥。

• 状态 可供使用
• 文件夹 content/locale
• 报告 modding_locale_report
• 如果玩家卸载了你 preserve_inert_reference。保存会命名记录，而不是说出它的单词，因此在两个会话之间撤回的包需要翻译而不是任何东西。密钥被保留并显示，读起来像是缺失的翻译而不是缺失的内容。

列。 该表未命名的列将随记录一起被拒绝。

在名为 words.csv 的文件中。文件名是地址的一半，行 id 是另一半，因此两个文件可以包含相同的行 id 而不会发生冲突：

a locales file

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

lore

法典条目：地点、人物、事件、习俗以及世界讲述的故事。上传的条目不是已知条目。

• 状态 可供使用
• 文件夹 content/narrative/lore
• 为 id 字段路由的记录
• 报告 modding_lore_report
• 如果玩家卸载了你 preserve_inert_reference。玩家阅读过的法典条目就是他们所看到的内容。拿走它会抹掉他对他所度过的世界的一些了解，并且任务和其他条目都指向该身份。

字段。 此表未命名的字段将随记录一起被拒绝。

在名为 lore.json 的文件中，或者在该文件夹中您喜欢的任何名称 .json 中：

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

中世纪现实主义结构化线路，通过文件和线路 ID 而不是 JSON 中的 id 字段进行路由。

• 状态 可供使用
• 文件夹 content/medieval_realism/structured
• 报告 modding_mr_lines_report
• 如果玩家卸载了你 drop_optional_presentation。一个没有任何意义的色彩笑话。删除它不需要任何成本，保留它会显示一个空字符串。

列。 允许使用此表未命名的列，并且必须是简单值而不是列表或对象。

每条记录至少需要public_line、public_label、public_summary_line之一。

这些名称无论包含什么内容，都会毫无疑问地被拒绝：unsafe_example、unsafe_reason、audit_note、expected_block_reason、script、scene、resource_path。有些是玩游戏的人写的验证栏，另一些是mod永远不能做的事情到处拒绝的代码形状的名称。一张有记录的记录会被拒绝，而不是被悄悄地删除。

在名为 MR_L03_TAVERN_INN_LINES.csv 的文件中。文件名是地址的一半，行 id 是另一半，因此两个文件可以包含相同的行 id 而不会发生冲突：

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

玩家进度记录：目标、安全难度概况以及主机规则内的比赛概况。

• 状态 可供使用
• 文件夹 content/player/progress
• 为 id 字段路由的记录
• 报告不是他的； modding_preflight_report 负责处理它
• 如果玩家卸载了你 preserve_inert_reference。当其包不存在时，获得的成就和选择的比赛资料仍会被命名；默默地带走他们会改写球员的历史或比赛合同。

字段。 该系列包含多个记录类型，并且每种类型都会根据自己的列表进行检查。该表未命名的字段将与记录一起被拒绝。

一条带有kind: achievement的记录：

一条带有kind: difficulty_profile的记录：

一条带有kind: run_profile的记录：

在名为 progress.json 的文件中，或者在该文件夹中您喜欢的任何名称 .json 中：

a progress record, under content/player/progress

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

quest_metadata

任务元数据记录，通过 quest_id 而不是 id 进行索引。

• 状态 可供使用
• 文件夹 content/narrative/quest_metadata
• 为 quest_id 字段路由的记录
• 报告 modding_quest_metadata_report
• 如果玩家卸载了你 preserve_inert_reference。他描述的任务本身可能已经被简化为墓碑；把它拿走会让他们失去描述而不是消失。

字段。 此表未命名的字段将随记录一起被拒绝。

在名为 quests.json 的文件中，或者在该文件夹中您喜欢的任何名称 .json 中：

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

作为记录的任务计划：包中写入的弧线、任务、目标和结局，游戏从中构建自己的任务。任务的记录形式，位于手写资源旁边，而不是在其位置。

• 状态 可供使用
• 文件夹 content/narrative/quest_plans
• 为 id 字段路由的记录
• 报告 modding_quest_plan_report
• 如果玩家卸载了你 preserve_inert_reference。一项计划构建了与游戏运行相同的任务，因此退役的计划会留下与手写留下的相同的漏洞。进度是玩家无法重建的一件事：未解决的任务被报告并且从未完成或默默取消。

字段。 该系列包含多个记录类型，并且每种类型都会根据自己的列表进行检查。该表未命名的字段将与记录一起被拒绝。

一条带有kind: arc的记录：

一条带有kind: ending的记录：

一条带有kind: objective的记录：

一条带有kind: quest的记录：

在名为 the_long_winter.json 的文件中，或者在该文件夹中您喜欢的任何名称 .json 中：

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

赛程包含5条记录；示出了3个。

quests

手写的任务资产，按路线加载，而不是解释为记录。想要自己的使命的包会写 quest_plans。

• 状态 已检查，尚未安装
• 文件夹 content/narrative/quests
• 报告不是他的； modding_preflight_report 负责处理它
• 如果玩家卸载了你 preserve_inert_reference。进步是玩家无法重建的一件事。未解决的任务会被报告并且从未完成或默默取消。

该族是通过路径加载的，而不是作为记录读取，并且包无法携带它想要的文件；请参阅mod 永远无法做到的事情。相反，应写入 quest_plans。

scenes

舞台场景：房间、房间里的人以及按顺序展开的台词。这是唯一脱离玩家控制的内容，这就是为什么永远不会到达 end 的序列会被拒绝而不是播放。笑话和道具的名称取自已发布的列表；这里没有加载戈多场景、资源和脚本。

• 状态 可供使用
• 文件夹 content/narrative/scenes
• 为 id 字段路由的记录
• 报告 modding_scene_report
• 如果玩家卸载了你 preserve_inert_reference。保存记录了一个场景所做的事情——选择了一个名字、移动了一个任务、打开了一扇门——而不是记录了它被观看的事实。它在一个会话中播放并结束，因此离开的包会花费场景，而不是观看它的后果。替换它会上演一些作者从未以他所写的名义写过的东西。

字段。 此表未命名的字段将随记录一起被拒绝。

在名为 scenes.json 的文件中，或者在该文件夹中您喜欢的任何名称 .json 中：

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

你如何看到和听到一切

7个系列：audio、effects、fonts、images、presentation_bindings、screens、themes。

audio

包携带的声音，由 id 命名：音乐、氛围、效果和声音，每个都指向其自己文件夹中的一个文件，并声明分隔它的角色。

• 状态 已验证，但目前没有任何内容消费它
• 文件夹 content/assets/audio
• 为 id 字段路由的记录
• 报告 modding_audio_report
• 如果玩家卸载了你 preserve_inert_reference。保存会命名主题，而不是其上方的声音，因此在两次会话之间撤回的包会消耗气氛而不是东西。参考文献被保留并报告：无话可说的沉默正是这个家庭所要避免的状态。

字段。 此表未命名的字段将随记录一起被拒绝。

在文件 audio.json 中，这是读取此文件夹的唯一文件：

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

天气、灰尘、火花和灯光，由主机提供的模型组成。包命名模型并在声明的范围内设置参数；任何地方都没有任何字段带有着色器、场景或脚本 - 这就是允许陌生人的包在无法请求程序的情况下请求启动的原因。

• 状态 可供使用
• 文件夹 content/assets/effects
• 为 id 字段路由的记录
• 报告 modding_effect_report
• 如果玩家卸载了你 preserve_inert_reference。保存中没有任何内容命名效果。当群体离开时，空气会恢复到基础游戏所绘制的状态，这会花费一方面的费用，而玩家则不会拥有任何东西。

字段。 此表未命名的字段将随记录一起被拒绝。

在名为 effects.json 的文件中，或者在该文件夹中您喜欢的任何名称 .json 中：

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

包携带的字体，由 id 命名：文件、绘制它们的大小以及它们携带的字形的语言。相反，封面声称是暴露的，因为缺少某种语言字形的字符不会失败：它会画出小方块，屏幕上读起来就像有人留下了一半的翻译。

• 状态 已验证，但目前没有任何内容消费它
• 文件夹 content/assets/fonts
• 为 id 字段路由的记录
• 报告 modding_font_report
• 如果玩家卸载了你 preserve_inert_reference。保存中没有任何内容命名角色。当包离开时，界面将恢复为工具包字体，这是作者必须选择的唯一字体。

字段。 此表未命名的字段将随记录一起被拒绝。

在文件 fonts.json 中，这是读取此文件夹的唯一文件：

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

包带来的图像，由 id 命名：图标、肖像和精灵表，每个都指向其自己文件夹内的一个文件。

• 状态 可供使用
• 文件夹 content/assets/images
• 为 id 字段路由的记录
• 报告 modding_image_report
• 如果玩家卸载了你 preserve_inert_reference。保存时会命名物体和人物，而不是其中一个的图像，因此停止解析的图像会花费一张绘图而不是任何东西。引用被保留并报告：用另一个包中的艺术替换它会向玩家展示作者没有选择的东西，而默默地删除 ID 会让丢失的图标看起来像一个设计缺陷。

字段。 此表未命名的字段将随记录一起被拒绝。

在文件 images.json 中，这是读取此文件夹的唯一文件：

a images record, under content/assets/images

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

presentation_bindings

哪个包资源填充哪个主题的哪个插槽：对象上的图标、单位或图块上的精灵、派系上的横幅，无论是包的内容还是基础游戏的内容。

• 状态 可供使用
• 文件夹 content/presentation/bindings
• 为 id 字段路由的记录
• 报告不是他的； modding_preflight_report 负责处理它
• 如果玩家卸载了你 preserve_inert_reference。保存时会命名主题——物体、人物、作品——而不是用什么图像来装饰它，因此停止解析的链接会花费一幅画而不是一件事。参考文献被保留并报告：主题返回到构建已有的艺术，这是没有作者必须选择的唯一答案。

字段。 此表未命名的字段将随记录一起被拒绝。

在名为 bindings.json 的文件中，或者在该文件夹中您喜欢的任何名称 .json 中：

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

屏幕布局：哪些部分适合游戏已有屏幕的哪个面板，以及按什么顺序。它有一些此构建绘制的部分，无法添加：一个新屏幕需要小部件、数据源和单击处理程序，它们一起构成一种编程语言。

• 状态 可供使用
• 文件夹 content/ui/screens
• 为 id 字段路由的记录
• 报告 modding_screen_report
• 如果玩家卸载了你 preserve_inert_reference。救援中没有任何事情能够命名为处置。它决定在加载包时如何绘制页面，并且页面在离开时恢复到此构建所采用的布局：它会花费一个皮肤，而玩家不会拥有任何东西。

字段。 此表未命名的字段将随记录一起被拒绝。

在名为 screens.json 的文件中，或者在该文件夹中您喜欢的任何名称 .json 中：

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

界面调色板作为标记：命名的颜色、大小和间距，以及玩家必须能够读取其对比度的对。绝不是场景、脚本或资源路径。

• 状态 可供使用
• 文件夹 content/assets/themes
• 为 id 字段路由的记录
• 报告 modding_theme_report
• 如果玩家卸载了你 preserve_inert_reference。保存中没有任何内容命名主题。当包离开时，界面将恢复为工具包颜色，这是任何作者必须选择的唯一调色板。

字段。 此表未命名的字段将随记录一起被拒绝。

在名为 themes.json 的文件中，或者在该文件夹中您喜欢的任何名称 .json 中：

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

玩家控制什么，他观察什么

3 个系列：adaptive、input_bindings、settings。

adaptive

个人资料可查看比赛的进展情况并提出不同的方法。结果是建议，而不是改变：可以起作用的配置文件将是软件包带来的唯一能够在玩家或客人没有要求的情况下改变游戏的东西，并且在差异中它看起来就像一个调整表。输入是已发布的游戏聚合列表，每个聚合都是游戏已经拥有的关于自身的计数或平均值。

• 状态 可供使用
• 文件夹 content/player/adaptive
• 为 id 字段路由的记录
• 报告 modding_adaptive_report
• 如果玩家卸载了你 drop_optional_presentation。不保存配置文件名称。配置文件所触及的是一个乘数，每次改变时，活跃的变异器都会重新计算乘数，因此不再查询撤回的包，并且游戏将返回到玩家所选择的内容。没有什么可以保留，所以没有什么可以保留。

字段。 该系列包含多个记录类型，并且每种类型都会根据自己的列表进行检查。该表未命名的字段将与记录一起被拒绝。

一条带有kind: adaptive_profile的记录：

一条带有kind: threshold_set的记录：

在名为 adaptive.json 的文件中，或者在该文件夹中您喜欢的任何名称 .json 中：

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

自己的一个动作包，用key自己想要。玩家决定：以他已经分配的组合结束的建议失败，并且该动作没有按钮，因为默默地做其他事情的按钮比什么也不做的按钮更糟糕。

• 状态 可供使用
• 文件夹 content/input
• 为 action_id 字段路由的记录
• 报告 modding_input_report
• 如果玩家卸载了你 preserve_inert_reference。重新分配玩家仍然存储在操作 ID 下，因此重新安装包会找到您放置它的按钮。当包离开时，操作本身将从命令映射中删除，因此分配屏幕永远不会列出不响应任何内容的内容。

字段。 此表未命名的字段将随记录一起被拒绝。

在名为 bindings.json 的文件中，或者在该文件夹中您喜欢的任何名称 .json 中：

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

玩家可以改变的选项，是宣布的而不是绘制的。一个包说明了选项是什么，它可以有什么值，以及值存在于哪里；该控件由访客构建。任何跨越此边界的东西都不是控件或脚本，这是设置菜单可以在不执行陌生人代码的情况下显示陌生人选项的唯一原因。

• 状态 可供使用
• 文件夹 content/settings
• 为 key 字段路由的记录
• 报告 modding_settings_report
• 如果玩家卸载了你 preserve_inert_reference。存储的值保留在其密钥下，因此重新安装包会在玩家留下的位置找到玩家的选择。该软件包留下的是个人资料中的一行无人阅读的内容：它不需要任何费用，并且保留玩家所做的选择。

字段。 此表未命名的字段将随记录一起被拒绝。

在名为 settings.json 的文件中，或者在该文件夹中您喜欢的任何名称 .json 中：

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

控制台快捷键

这些是快捷方式，而不是步骤。 下面的所有内容都在 Mods 屏幕上占有一席之地，这是正常路线的所在，也是下载您的软件包的任何人都会看到的地方。当您进行迭代并且它已经打开时，控制台会更快，并且它仅存在于调试版本中：游戏的已发布副本没有控制台，因此包作者需要的任何内容都不能单独存在于此处。

从 modding_manifest_report 开始 — 游戏是否看到您的包裹，处于什么状态？ — 然后 modding_preflight_report 对安装的所有内容进行单一判断。然后是个别家庭的报告。

modding_reload 会在不重启的情况下重新读取文件。编辑文件，按 Alt-Tab，输入命令，然后查看结果。它会重建没有被占用的内容——绑定、效果和图像——并列出被保留的系列，因为运行中的存档可能仍在使用这些记录：

what the game prints back

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

modding_reload all 再次读取所有内容，用于没有正在进行的游戏的启动屏幕。 modding_condition_report 打印游戏现在可以回答 when 的内容以及不能回答的内容。

离线工具

这些工具面向作者和发布自动化。它们随公开的 Bonemark checkout 提供；安装已发布 mod 的玩家不需要 Python 或 Godot。如果你正在编写 mod，请从 github.com/tallowgames/Bonemark 克隆匹配的版本，把工作中的 mod 包放在玩家 mods 文件夹之外，然后从该 checkout 运行下面的命令。游戏仍然是运行时的最终权威。

Python 3.10 或更高版本； Godot 仅适用于运行时通道。将您的包保存在播放器 mods 文件夹的外部并尝试复制。

a command line

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

它会编写一个在您编写任何内容之前就通过验证的包：预编译的 mod.json、您要求的每个系列的工作记录以及包含接下来两个命令的自述文件。这些记录来自构建已检查这些系列的固定装置，因此停止工作的启动器会导致导致固定装置失败的相同检查，而不是在模型内腐烂。它拒绝写入名为 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>"

检查 mod.json、系列文件夹、ID、架构、引用、限制和阻止的有效负载。 --strict 将警告转变为失败。

将改装表面与版本进行比较

当游戏发生变化时，请在更新包之前比较存档的表面快照。它包含一个摘要以及每个公共系列的字段和操作，因此结果表明哪个系列发生了变化以及原因：

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

区别是 unchanged、additive 或 breaking。失败原因明确：field_removed、required_added、type_changed、default_changed、constraint_changed、operation_removed 和 root_changed、format_changed、id_field_changed、 catalogue_changed、family_removed 和 contract_major_changed_without_new_id。兼容修改名称 field_added、required_removed、operation_added 或 family_added。不带 --before 的命令还会检查存储的基线。如果当前表面已移动，则审核将失败，直到维护人员检查 tools/quality/modding_surface_contract_changes.json 中准确的之前/之后摘要；重大变更还必须记录每个原因、决定、迁移说明和审核者。有意修改的快照的推广是明确的：

a command line

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

这是维护者/发布检查； mod作者只需要--before比较，安装已发布包的玩家不需要运行它。

a command line

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

无需启动 Godot 且无需运行任何包，即可读取清单、依赖项、兼容性和加载顺序。

从不打开内容文件。这就是分工：主机回复*这些数据包将被一起加载*，验证器回复*这条记录是正确的* - 但这意味着验证器拒绝的数据包仍然可以在这里干净地组合。对 14 个故意损坏的数据包进行测量，两者在每次拒绝上都不一致：主机暂存所有 14 个空 refused，其中一个携带只有验证器才能找到的 scripts/payload.sh。 拨号与安全安装不同。 在发布之前执行这两项操作。当测试集分文件夹时重复--root；然后，主机在确定性计划中组成完整的集合。

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"

它运行验证器、测试主机、每个系列开箱即用的固定装置以及 Godot 运行时通道。如果没有Godot，请删除--require-runtime；然后报告会说运行时测试被跳过，没有通过。

对于复合集，重复该选项：

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

该报告为每个根保留一个结果，并为整个集合添加 composed_set。此块是演示包冲突、重复 ID 和依赖性错误的地方。仅干净的包装并不能证明该套件将被一起装载。该报告还包括 surface_contract、系列合约的当前版本和审计摘要，因此当存储库兼容性快照过时时，矩阵不能为绿色。使用--require-runtime，读取runtime.reachability.loaded_families和runtime.reachability.reachable_families。第一个表示组成的记录已加载；第二个只有当戈多探测器中针对玩家的真实路径消耗了他们时才会填充。 runtime.reachability.observations 维护每行的包、族、记录 ID、路径和状态，而 unreachable 列出尚未有任何路径的已加载行。一个家族可以被验证和上演，但仍然不存在于 reachable_families 中：“已加载”与“玩家可以到达它”不同。

在构建此页面时，上面的每个命令都会根据工具本身进行检查：脚本必须存在，并且每个选项都必须是可接受的选项。

每个诊断代码

不要按顺序阅读此列表。在这里，您在报告中遇到的代码是一个有答案的问题 - 一个小写的单词，如 asset_missing。将其粘贴到本页顶部的搜索框中。

某些代码属于数据包尚无法到达的机制。我在这里也是一样的：一个你无法触发的代码会花费你永远不会阅读的一行，而一个丢失的代码会花费一个晚上的时间。