• 简体中文

      • 古董注册

      Estimated reading time: 3 minutes

      用于向博物馆古董系统添加新的古董文本和收藏状态。

      使用入口

      maplebirch.tool.patch.addAntiques(key, config);
maplebirch.tool.patch.injectAntiques(_museumAntiqueText);

      addAntiques 用于注册数据；injectAntiques 需要注入到原版 museumAntiqueText widget 的 _museumAntiqueText 对象创建之后。

      推荐注入位置：

      <<widget "museumAntiqueText">>
  <<if _museumAntiqueText is undefined>>
    <<set _museumAntiqueText to {
      ...
    }>>
    <<run maplebirch.tool.patch.injectAntiques(_museumAntiqueText)>>
  <</if>>
<</widget>>

      一次注入会同时完成两件事：

      • 向 _museumAntiqueText 追加古董文本。
      • 如果 $museumAntiques.antiques 已存在，则补充默认状态 notFound 并刷新 maxCount。

      最小示例

      maplebirch.tool.patch.addAntiques("antiquemyitem", {
  hint: '"For a curious little relic," Winter says.',
  museum: "The curious relic rests on a pedestal.",
  name: "Curious Relic",
  cn_name: "奇妙遗物",
  journal: '"A curious little relic."',
  journalName: "Small relic",
  icon: "antiques/my-relic.png",
});

      配置字段

      字段说明
      hintWinter 提示文本
      museum古董放入博物馆后的展示文本
      name真实名称
      cn_name中文显示名称，可选
      journal日志描述
      journalName日志中使用的名称，可选
      icon图标路径
      key数组配置时使用的唯一标识

      状态流转

      古董状态仍由原版 <<museumAntiqueStatus key status>> 控制。常见状态：

      notFound -> found -> talk -> museum

      也存在 stolen、recovered。框架只负责注册文本和默认状态，不负责定义发现地点或奖励。

      发现古董的剧情仍需要在 passage 中自行写：

      <<set $antiquemoney += 4000>>
<<museumAntiqueStatus "antiquemyitem" "found">>

      boot.json

      对象映射写法，推荐用于一次注册多个条目：

      {
  "framework": {
    "antiques": {
      "antiquemyitem": {
        "hint": "\"For a curious little relic,\" Winter says.",
        "museum": "The curious relic rests on a pedestal.",
        "name": "Curious Relic",
        "cn_name": "奇妙遗物",
        "journal": "\"A curious little relic.\"",
        "journalName": "Small relic",
        "icon": "antiques/my-relic.png"
      },
      "antiquemycoin": {
        "hint": "\"For a small old coin,\" Winter says.",
        "museum": "The old coin rests in a small display case.",
        "name": "Old Coin",
        "cn_name": "旧硬币",
        "journal": "\"A small old coin.\"",
        "icon": "antiques/my-coin.png"
      }
    }
  }
}

      也可以引用 .json、.yaml 或 .yml 文件：

      {
  "framework": {
    "antiques": "data/antiques.yaml"
  }
}

      数组写法也支持，但每一项必须带 key：

      - key: antiquemyitem
  hint: '"For a curious little relic," Winter says.'
  museum: The curious relic rests on a pedestal.
  name: Curious Relic
  cn_name: 奇妙遗物
  journal: '"A curious little relic."'
  journalName: Small relic
  icon: antiques/my-relic.png
- key: antiquemycoin
  hint: '"For a small old coin," Winter says.'
  museum: The old coin rests in a small display case.
  name: Old Coin
  cn_name: 旧硬币
  journal: '"A small old coin."'
  icon: antiques/my-coin.png