curse（诅咒）
文件位置：data/<namespace>/mxt/curse/<path>.json
用途：可引用的诅咒定义。
| 字段 | 类型 | 默认 | 说明 |
|---|---|---|---|
type | CurseType | 必填 | mxt:timed、mxt:permanent、mxt:triggered 或 mxt:empty。 |
duration_ticks | NumberProvider | 0 | 定时诅咒持续时间；单位 tick。 |
tick_interval | NumberProvider | 20 | 周期行为间隔。 |
max_stacks | Integer | 1 | 最大层数，范围 1..256。 |
stacking_mode | Enum | ignore | ignore、refresh_duration、add_stacks_refresh_duration、add_stacks_keep_duration 或 replace。 |
application_condition | EntityCondition | mxt:always_true | 是否允许施加。 |
display_condition | EntityCondition | mxt:always_true | 是否在人物信息面板里列出这条诅咒；不满足时整行都不出现（要藏就用 mxt:never，要"两层以上才显形"就用 mxt:has_curse 查自己）。 |
on_apply | EntityAction | mxt:no_op | 施加行为；只在新建实例时执行，往已有的那条叠层或刷新不会重复触发。 |
on_tick | EntityAction | mxt:no_op | 周期行为。 |
on_expire | EntityAction | mxt:no_op | 自然到期行为。 |
on_cleanse | EntityAction | mxt:no_op | 被解毒行为。 |
四种 type 的区别：
| 类型 | 到期 | 周期行为的驱动 |
|---|---|---|
mxt:timed | duration_ticks 之后；必须为正（常量在加载期就校验，公式在求值那一刻判定，判定不了就拒绝这次施加而不是抛异常） | tick_interval |
mxt:permanent | 永不到期（duration_ticks 不参与） | tick_interval |
mxt:triggered | 写了 duration_ticks 就按时到期，不写就永不到期 | 触发器：triggers 里任一 Trigger 匹配到的信号到达时，对持有者执行一次 on_tick（tick_interval 不参与）。例如 "triggers": [{"type": "mxt:hurt"}] 就是"每次受击发作一次" |
mxt:empty | 永不到期 | 无：这个类型不产生任何行为（on_apply/on_tick/on_expire/on_cleanse 一律不执行），只作为占位/标记存在 |
加载期还会拒绝：mxt:timed 写了非正数常量时长、mxt:triggered 的 triggers 为空。
时长覆盖只能收紧：引用方（mxt:apply_curse 的 duration_ticks、/mxt curse apply <目标> <诅咒> <层数> <时长>、KubeJS MxtCurses.applyFor）给的时长可以缩短一条诅咒，但不会超过定义自己声明的时长；定义本身不到期的（permanent/empty/不带时长的 triggered）可以被覆盖成限时的，反之不行。要更长的诅咒就在定义里写更长的 duration_ticks。
执行顺序：同一 tick 内多条诅咒按附件里的顺序（也就是施加的先后）处理，这个顺序随附件一起存档，因此跨重登稳定；它不按定义 ID 重排——排 ID 要读 Holder 的 key，而重载后那份 key 未必还可靠。
查看与操作：/mxt curse list [目标] 列出持有者身上的诅咒（名字、层数、剩余或"永不到期"、以及全部来源）；/mxt curse apply <目标> <诅咒> [层数] [时长]、/mxt curse remove <目标> <诅咒>（explicit，整条）、/mxt curse cleanse <目标> <标签>（cleansed，与解毒剂同一条路）需要管理员权限。KubeJS 一侧 MxtCurses 有 apply、applyFor、remove、release（只撤一份来源）、has、stacks、remainingTicks、sources。带 mxt:curse_container 的物品还会在 tooltip 里列出它携带的诅咒。
禁用与定义消失 = 冻结。 定义被 #mxt:disabled 标签停用、或者整个定义从数据包里消失时，已持有的实例保留在原地：不再走周期/触发/到期，也不会被解毒（避免被"净化"成默认效果），人物信息面板照旧列出（除非 display_condition 说不）。唯一能把它取下来的路是显式移除（mxt:remove_curse、/mxt curse remove、KubeJS remove，原因 explicit）；定义回来之后实例会自动恢复（对账在 /reload 时重新调度一次）。
诅咒自己的生命周期只有两个时刻会执行行为：自然到期与被解毒，各占一个字段。其余移除原因（显式移除、管理员、被 replace 覆盖）都是外部决定，定义上不给行为，由调用方自己决定跑什么。两个时刻拿到的公式上下文，就是发起那次事务的调用者的上下文。
「谁能解我」不由诅咒决定。 定义里没有净化标签之类的字段：反过来，解毒剂声明它能解的 mxt:curse 标签，标签文件列出该标签下的诅咒。动作是 mxt:remove_curses_by_tag，只有 tags 一个字段——标签数组，写 "#命名空间:标签"（与 mxt:entity_tag 同一套写法）；列出的标签命中任意一个即被解掉：
{ "type": "mxt:remove_curses_by_tag", "tags": ["#example:cleanse/poison"] }// data/example/tags/mxt/curse/cleanse/poison.json
{ "values": ["example:dan_toxicity", "example:soul_scorch"] }它按 cleansed（解毒）这一原因走同一套移除事务，所以每个被解掉的诅咒都会执行自己的 on_cleanse、并发出原因为 cleansed 的 CurseRemoveEvent；按同一原因移除单个具名诅咒的是 mxt:remove_curse。把这个动作放进丹药的 on_consume、术法的 entity_action 或物品的 use_action，就是一颗解毒丹——诅咒侧不需要任何配合，新写的诅咒只要被列进那个标签就能被它解掉。
查询：mxt:has_curse
实体条件与战利品条件同名同形（战利品那份多一个 entity 目标字段），字段全部可选，且必须由同一条实例满足全部条件才算成立：
| 字段 | 类型 | 说明 |
|---|---|---|
curse | 诅咒 ID | 必须是这一条定义。 |
tags | #标签[] | 这一条实例必须同时带有列出的全部标签；想要「任意一个」就用 mxt:or 组合多个 mxt:has_curse。 |
stacks | {min?, max?} | 层数区间，闭区间。 |
remaining_ticks | {min?, max?} | 剩余时间区间，单位 tick；永不到期的实例视作无穷，因此能满足 min、永远不满足 max。 |
什么都不写就是「身上有任意一条诅咒」（配 mxt:not 即「身无诅咒」）。区间两端都可省略，所以一个字段同时表达「至少」「至多」和「精确区间」；区间里的公式用调用者自己的上下文求值。
{"type": "mxt:has_curse", "tags": ["#example:cleanse/poison"], "stacks": {"min": 2}, "remaining_ticks": {"min": 1}}来源（source）是一组，不是一条。 每条诅咒由来源账本记录"谁让它存在"——和技能授予用的是同一个 SourceLedger，规则也同一条：只要还有一份来源持有，这条诅咒就存在；某一份来源松手只撤销它自己那一份，最后一份走了实例才真的离开（此时才发移除事件）。内置来源都是标识符：mxt:ability（mxt:apply_curse）、mxt:loot（战利品函数）、mxt:command（/mxt curse apply）、mxt:equipment/<槽位>/<物品 ID>、mxt:curios_equipment，KubeJS 调用方自己给（必须写成 命名空间:路径）。/mxt curse remove、mxt:remove_curse 与解毒剂走的是整条移除，会把所有来源一并抹掉。
携带诅咒的物品：mxt:curse_container
任意物品都能带 mxt:curse_container 组件，声明它携带着哪些诅咒。条目与 mxt:apply_curse 同形（curse、stacks、duration_ticks），只是源是这件装备本身：
give @s minecraft:diamond_chestplate[mxt:curse_container={curses:[{"curse":"example:soul_scorch","stacks":2}]}]三个时刻都由 CurseEventBridge 负责，全部走普通诅咒事务，因此施加条件、叠层、时长照常判定：
- 装上即施加 / 加入：六个装备槽（主手、副手、头、胸、腿、脚）与 Curios 槽都算，源分别是
mxt:equipment/<槽位>/<物品 ID>与mxt:curios_equipment。若这条诅咒已经被别的来源持有，装备不重新施加、只把自己的来源加进账本（所以层数与剩余时间不会被它刷新）。 - 脱下只撤自己那一份：脱下一件装备只是释放它自己的来源，别的来源还在就仍存在；确实是最后一份时才移除实例，原因是
explicit（因此不执行定义上的行为）。 - 携带期间自愈：诅咒到期、被解毒、或被整条移除之后，只要装备还在身上，携带者会在最多 20 tick 内被重新施加——装备槽的变化会立刻触发一次对账，Curios 与自愈走 20 tick 的慢对账。所以"戴上就一直中咒"用
mxt:timed就够，不必写mxt:permanent。
人物信息面板的「诅咒」一行只列通过 display_condition 的实例，隐藏的连一行都不留；同一行会显示层数（×N），tooltip 给出全部来源与剩余时间。