小镇资源订单 - 向米斯特里亚请求材料

AI、兼容性及存档警告
本模组在ChatGPT/OpenAI Codex的大量AI辅助下制作完成。其代码、游戏数据研究、文档、测试工具及故障排查均在创作者指导下，通过AI辅助开发流程生成或修订。
与其他请求板、NPC、礼物偏好、库存、经济、本地化或新一天行为模组的兼容性尚未测试。目前不提供兼容性补丁或保证。
没有任何模组能保证存档始终安全。在安装、更新或移除本模组之前，请备份完整的《米斯特里亚田野》存档文件夹，并先在新存档或可弃置的存档上进行测试。使用风险自负。

城镇资源订单为原版城镇请求板添加了玩家自创的资源订单系统。
打开面板，选择 资源订单，选择一个供应商和资源，然后使用Tesserae或可用的资源交易进行支付。你的订单需要几个游戏内天数才能到达，之后你可以回到面板领取。
该 小镇仓库 总是提供基础建筑和农耕物资。随着你与镇民建立友谊，会有更多供应商解锁。每个角色的商品目录是根据其原版礼物偏好中的资源类物品生成的，因此他们的背景和性格会决定能为你提供什么。
资源选择器刻意只显示供应商和资源名称。它不会标明所提供物品是来自该角色的喜欢列表还是喜爱列表，从而保留了通过尝试和传闻来正常发现礼物的方式。

功能

• 添加 资源订单 到原版委托板。
• 从城镇仓库请求木材、石头、纤维、干草、草皮、泥炭和黏土。
• 通过友情解锁角色主题资源目录。
• 通过城镇等级提升解锁越来越珍贵的资源。
• 使用碎片或可负担的资源交易进行支付。
• 等待订单在游戏内的多天内完成。
• 订单准备好时接收通知。
• 从请求板收集已完成的订单。
• 取消待处理订单以获得全额退款。
• 同时管理多个进行中或已完成的订单。
• 使用精华购买每个存档的永久容量升级。
• 为大型目录使用自适应双列或三列资源选择器。
• 仅使用原版资源，不添加任何自定义物品ID或放置对象。
  

友情进度
默认情况下：
两个速度加成可以叠加，但配送时间永远不会少于一天。
界面不会显示哪些可用资源属于NPC喜欢或喜爱的礼物列表。

供应商
初始角色提供方如下：

• 艾德琳
• 巴洛尔
• 席琳
• 岛屿
• 海登
• 杜松
• 兰登
• 三月
• 奥尔里克
• 蕾娜
• 里伊斯
• 泰里西亚
• 瓦伦
  

他们在《米斯特里亚田园》1.0.2中的实际偏好数据决定了他们可获得的资源。准备好的餐食、工具、家具及其他不合适的礼物会被过滤掉。
因此，供应商自然而然地根据各自的兴趣和背景进行专精——例如，马奇偏向矿石和金属，特瑞西亚偏向鱼类，而塞琳偏向花卉。

付款与配送
镶嵌价格基于资源的原版商店价值并加上可配置的加价。默认加价为 140%.
启用以物易物后，支付界面还会提供使用库存中符合条件的资源进行可负担交易的选项。可用交易取决于所选供应商。
配送时间受以下因素影响：

• 资源稀有度
• 城镇等级要求
• 请求数量
• 与供应商的友谊
• 可配置的8心和10心速度加成
  

更大或更稀有的订单可能需要额外时间。
订单容量与精华升级
默认容量为 五个已激活或就绪的订单.
可从资源订单菜单购买三项永久容量升级：
在默认配置和所有升级的情况下，最大容量为八个订单。容量升级会按每个存档分别存储。

配置
首次启动后，MMAPI会创建：

%LOCALAPPDATA%\FieldsOfMistria\mod_data\town_resource_orders\town_resource_orders.json

默认配置为：

{
  “__config_version”: 2,
  “gold_markup_percent”：140，
  “barter_enabled”: true,
  "max_active_orders": 5,
  “liked_unlock_hearts”: 4,
  “loved_unlock_hearts”：6，
  "first_speed_bonus_hearts": 8,
  "second_speed_bonus_hearts": 10
}

手动编辑此文件前，请先关闭游戏。
有效范围：

• 金币加成百分比

  : 100–300

• 最大活跃订单数

  : 1–10
• 友谊阈值：0–10颗心

• 以物易物已启用

  :
  

  真

  或
  

  假

  
  

已购买的精华升级会添加到配置的基础订单容量中。

要求与测试环境

• 米斯蒂亚的田野 1.0.2
• MOMI/MMAPI 0.15.2
• Windows x64
• 当前模组版本： 0.1.4
  

其他游戏版本、操作系统、加载器和模组组合尚未经过测试。

安装

• 关闭《米斯特里亚田野》。
• 备份完整存档目录至
  

  %LOCALAPPDATA%\FieldsOfMistria\saves

  .
• 按照其说明安装 MOMI/MMAPI 0.15.2。
• 提取
  

  城镇资源订单0.1.4.zip

  进入游戏的
  

  模组

  文件夹。
• 确认此确切布局存在：
  

米斯特里亚的原野\mods\town_resource_orders\manifest.json

• 请从《Fields of Mistria》游戏目录中重新运行 MOMI 安装程序。
• 启动游戏并前往城镇的委托板。
  

不要将下载的ZIP文件留在

模组

文件夹。提取出的

城镇资源订单

目录应该放在那里。

更新中

• 关闭游戏并重新备份存档。
• 替换旧的
  

  模组\城镇资源订单

  包含新版本的文件夹。
• 启动游戏前请重新运行MOMI。
  

配置、未完成订单和容量升级存储在模组文件夹之外，应当保持可用。

移除
移除模组前：

• 收集所有已完成的订单。
• 取消所有待处理订单，退还其对应的碎片或以物易物支付。
• 保存并退出游戏。
• 再制作一份完整的存档备份。
• 移除
  

  模组\城镇资源订单

  .
• 重新运行MOMI以在不使用模组的情况下重建游戏存档。
  

该模组使用原版资源，不会添加自定义物品ID。但是，未完成的订单信息会存储在每个存档的MMAPI附属文件中，并且下订单时就会扣款。如果在未收货或未取消订单的情况下移除该模组，可能会导致这些付款无法找回。
游戏关闭后，如果你不打算重新安装该模组，配置文件和附属文件可以单独删除。

已知限制

• 界面文本目前仅支持英文。
• 订单必须从请求板上领取，不会通过邮件送达。
• 目前只有列出的NPC会作为具名供应商。
• 角色图鉴基于《米斯特里亚田野》1.0.2 版本的礼物偏好数据。
• 预制餐食及其他非资源类礼物已被有意排除。
• 与更改请求板、NPC偏好、物品价值、库存、本地化或新一天处理的模组的兼容性未知。
• 自动化验证和有限的手动测试无法保证兼容性或存档安全。
  

开发状态
版本0.1.4已通过源不变性检查、精确的《米斯特里亚田园》1.0.2接缝验证、严格的MOMI代码检查、必需的GML编译、包体检查，以及全新一次性安装测试。
这些检查并不能证明与其他模组的兼容性，也无法保证所有玩法组合都不会出现问题。