战利品与进度条件

除数据包注册表之外，MiXianTu 还注册了一小批原版类型，让内容包可以在普通的战利品表、战利品修饰器和进度中读取并改变玩家的修炼状态。它们以 "type": "mxt:..." 的形式写在普通的原版 JSON 里，没有特殊的文件布局。

文件位置

种类	使用位置
进度准则	`data/<namespace>/advancement/<path>.json` 中的 `criteria` 段
战利品函数与战利品条件	`data/<namespace>/loot_table/<path>.json`，或任何接受原版战利品函数与条件的 JSON，例如方块或实体战利品表以及战利品修饰器

进度准则

四种准则形状相同：一个可选的 definition 过滤器，加上标准的原版玩家谓词。准则写在 criteria 段的 trigger 里，conditions 就是下面两个字段。

准则	触发时机	`definition` 的取值
`mxt:breakthrough`	一次突破成功	所达到的境界阶段
`saturn:ability`	一次施法提交完成	该技能
`mxt:alchemy`	一批炼丹完成	该配方
`mxt:tribulation`	一次天劫成功完成	该天劫

字段	类型	默认	说明
`player`	原版玩家谓词	无	作用于获得该进度的玩家
`definition`	Identifier	无	只对该定义触发；省略时任何定义都会触发该准则

saturn:ability 只认施法：开关类技能按下时的付款另有自己的路径，不触发；引导技能在起手那一下触发一次，之后的脉冲不算。

{
  "criteria": {
    "foundation": {
      "trigger": "mxt:breakthrough",
      "conditions": {
        "definition": "example:foundation"
      }
    }
  },
  "requirements": [["foundation"]]
}

战利品条件

战利品条件使用原版的 "condition" 分派键：{"condition": "mxt:has_ability", ...}。

条件	为真的情形	必填字段
`mxt:has_ability`	该实体已被授予此技能	`ability`
`mxt:has_curse`	该实体带有查询所接受的诅咒	—
`mxt:realm`	该实体达到过该境界，任意资源链均可	`realm`
`mxt:has_spirit_root`	该实体拥有该灵根	`spirit_root`
`mxt:has_element`	该实体启用的灵根命名的元素中有一个出现在 `elements` 里	`elements`
`mxt:has_physique`	该实体拥有该体质	`physique`
`mxt:technique`	该实体学过所列出的功法	—
`mxt:js`	一个服务端脚本回调返回 `true`	`id`

每个条件都有的那个字段：

字段	类型	默认	说明
`entity`	实体选择	`this`	检查战利品上下文中的哪个实体：`this`、`attacker`、`direct_attacker`、`attacking_player`、`target_entity` 或 `interacting_entity`

当所选实体不在战利品上下文中时，该条件为假。

mxt:has_curse 的四个过滤字段全部可选，写了的必须对同一个诅咒实例同时成立；一个也不写就只问「身上有没有诅咒」。tags 里的多个标签是「同时带这些标签」，要「任一」请用 mxt:or 包起来。stacks 与 remaining_ticks 是带 min / max 的区间对象（两端都可省略，闭区间），其中 remaining_ticks 对永不过期的诅咒视为无穷大——它答得出下界，永远答不出上界。

字段	类型	默认	说明
`curse`	诅咒条目	无	只认这一条诅咒
`tags`	标签数组	`[]`	诅咒必须带上的全部标签
`stacks`	区间	无	层数区间
`remaining_ticks`	区间	无	剩余时长区间，单位刻

mxt:has_spirit_root 的 spirit_root 字段接受条目、# 标签或它们的数组，所以「任意火属灵根」写一条标签即可。mxt:has_element 问的是更粗的那一层——「是不是火属修士」：elements 是一个元素引用列表，每一项可以是一个元素或一个 # 标签，之后新加的同类灵根无需改动战利品表，elements 至少写一项（空数组在加载期被拒绝）。

mxt:technique 的两个字段与同名实体条件同形：

字段	类型	默认	说明
`techniques`	条目或标签数组	`[]`	要问的功法；空表问的是「学过任意一门」
`match`	`any` / `all`	`any`	`all` 要求列表里每一项都学过；`all` 配空表在加载期被拒

它读的是身体持有的授予账本，不是当前包里的定义；功法没有「启用/停用」开关，学过就是学过。

{
  "conditions": [
    {"condition": "mxt:has_spirit_root", "spirit_root": "example:fire_root"},
    {"condition": "mxt:realm", "realm": "example:foundation"}
  ]
}

mxt:js 接受一个用 MxtLoot.condition(...) 注册的 id，以及一个可选的 params 对象。与内置条件不同，它没有 entity 字段：回调收到完整的原版战利品上下文，由它自己决定读取哪个实体。回调缺失时条件为假，回调抛异常时也为假，两者都会记一条日志。

{"condition": "saturn:js", "id": "example:first_clear", "params": {"dungeon": "example:fire_temple"}}

战利品函数

战利品函数使用原版的 "function" 分派键：{"function": "mxt:grant_ability", ...}。每个函数也都接受原版的 conditions 字段。

函数	效果
`mxt:grant_ability`	授予实体一个持久技能来源，并刷新它的事件规则订阅
`mxt:set_artifact_owner`	把掉落出的法器归属给某个实体，然后运行该法器的 `claim_action`
`mxt:apply_curse`	对某个实体施加一个诅咒，以 `mxt:loot` 作为施加来源
`mxt:js`	用服务端脚本返回的内容替换生成的物品栈

`mxt:grant_ability`

字段	类型	默认	说明
`ability`	Identifier	必填	要授予的技能
`entity`	实体选择	`this`	接受该技能的实体
`source`	Identifier	`mxt:loot`	随授予一起记录的来源 id，以便按来源撤销该技能

{
  "function": "mxt:grant_ability",
  "ability": "example:fire_manual",
  "source": "example:fire_temple"
}

`mxt:set_artifact_owner`

字段	类型	默认	说明
`entity`	实体选择	`this`	成为该法器拥有者的实体

如果该物品栈已经属于另一个拥有者，则什么也不会发生：掉落物保持原样，claim_action 也不会运行。

归属写成功时，claim_action 会跑一遍——和长按认主付的是同一份代价、跑的是同一套效果（认主的代价就是这条行为的默认值），因为两条路走同一段认主结算。但这条路上不判 claim_condition：那道条件是长按手势自己的门槛，战利品表已经用自己的判断指名了主人。

{
  "function": "mxt:set_artifact_owner"
}

`mxt:apply_curse`

字段	类型	默认	说明
`curse`	Identifier	必填	要施加的诅咒
`stacks`	Integer `1..256`	`1`	施加多少层该诅咒
`entity`	实体选择	`this`	接受该诅咒的实体

{
  "function": "mxt:apply_curse",
  "curse": "example:blood_oath",
  "stacks": 2
}

`mxt:js`

字段	类型	默认	说明
`id`	String	必填	用 `MxtLoot.function(...)` 注册的回调 ID
`params`	Object	`{}`	传给回调的任意 JSON

{
  "function": "saturn:js",
  "id": "example:bless",
  "params": {"multiplier": 3}
}

回调收到生成的物品栈和战利品上下文，并返回要保留的物品栈：原样返回入参表示不动掉落物，返回新的物品栈表示替换它，返回 null 表示保留原物品。回调缺失或执行失败时，物品栈保持不变，并记录一条日志。

综合示例

一个只对已经拥有对应灵根的玩家掉落一本手册的箱子：

{
  "type": "minecraft:chest",
  "pools": [
    {
      "rolls": 1,
      "entries": [
        {"type": "minecraft:item", "name": "minecraft:book"}
      ],
      "conditions": [
        {"condition": "mxt:has_spirit_root", "spirit_root": "example:fire_root"}
      ],
      "functions": [
        {"function": "mxt:grant_ability", "ability": "example:fire_manual"}
      ]
    }
  ]
}

文件位置​

进度准则​

战利品条件​

战利品函数​

mxt:grant_ability​

mxt:set_artifact_owner​

mxt:apply_curse​

mxt:js​

综合示例​