KubeJS 综合示例

StartupEvents.registry('item', event => {
  event.create('spirit_manual').displayName('无名功法书')
  event.create('spirit_stone').displayName('灵石')
})

ServerEvents.recipes(event => {
  event.shaped('example:spirit_manual', ['ABA', ' C ', 'ABA'], {
    A: 'minecraft:paper',
    B: 'minecraft:lapis_lazuli',
    C: 'minecraft:book'
  })
})

// kubejs/server_scripts/mxt_events.js
MxtEvents.abilityUse(event => {
  if (event.isPre() && event.getAbility() === 'example:forbidden') event.cancel()
})

MxtEvents.resourceConsume(event => {
  if (event.isPre()) event.setAmount('example:spirit_power', event.getAmounts()['example:spirit_power'] || 0)
})

MxtEvents.cultivationBreak(event => {
  if (event.getPhase() === 'Pre') {
    // event.getEvent() is the native CultivationBreakEvent.Pre.
    event.getEvent().setCost('example:spirit_power', 20)
  }
})

对应的数据包可以把 example:spirit_manual 绑定到功法，把 example:spirit_stone 接入 item_aura 或 currency。这样脚本只负责内容注册，规则仍由数据包驱动并同步到各客户端。

回调还可以接收第三个参数——本次派发的公式上下文，用来读取只有触发事件才知道的数值：

MxtActions.entity('example:knockback_on_hit', (entity, params, context) => {
  const damage = context.explicit('damage')
  if (Number.isNaN(damage)) return
  entity.push(0, params.strength * damage, 0)
})

自定义 Cost

Cost 先检查再支付，所以两半要一起注册；id 就是数据包 costs 数组里写的那个：

MxtCosts.register('example:quest_token',
  (player, params, context) => player.persistentData.getInt('tokens') >= (params.count || 1),
  (player, params, context) => {
    player.persistentData.putInt('tokens', player.persistentData.getInt('tokens') - (params.count || 1))
  }
)

json

{"type": "mxt:js", "id": "example:quest_token", "params": {"count": 3}}

脚本 Cost 需要玩家，而且它的上下文只由该玩家构建，所以读玩家自身状态（或该上下文的显式值），不要指望读到事件载荷。

脚本也可以自己发布并等待触发器信号。订阅只存在于运行时，因此要从运行时钩子挂载，并在重载后重新挂载：

// kubejs/server_scripts/mxt_triggers.js
const KEY = 'example:toxicity_watch'

function onPillTaken(signal) {
  const toxicity = signal.context().formula().explicit('toxicity')
  if (!Number.isNaN(toxicity)) console.info(`${signal.type()} with toxicity ${toxicity}`)
}

function watch(entity) {
  if (!MxtTriggers.has(entity, KEY)) {
    MxtTriggers.subscribe(entity, 'example:pill_taken', KEY, onPillTaken)
  }
}

EntityEvents.spawned(event => watch(event.entity))

// /reload 会重新执行本脚本并丢掉它的订阅，这里为仍在线的玩家重新挂上。
ServerEvents.tick(event => event.server.players.forEach(watch))

// 在你自己的逻辑里发布：命令处理、任务钩子或物品使用。
function publishPillTaken(player, toxicity) {
  MxtTriggers.publish(player, 'example:pill_taken', {
    pill: 'example:returning_pill',
    toxicity
  })
}

物品本体应由 KubeJS 在启动脚本阶段注册，MXT 数据包随后用真实物品 ID 绑定玩法规则。不要再创建 mxt:item、mxt:pill 或 mxt:weapon 文件。

// kubejs/startup_scripts/mxt_items.js
StartupEvents.registry('item', event => {
  event.create('fire_root_pellet')
    .displayName('Fire Root Pellet')
    .food(food => food.nutrition(2).saturation(0.2))

  event.create('returning_pill')
    .displayName('Returning Pill')
    .food(food => food.nutrition(1).saturation(0.1))

  event.create('firebound_sword', 'sword')
    .displayName('Firebound Sword')
    .modifyTier(tier => tier.setAttackDamageBonus(3))
})

food 回调里的方法是 nutrition(int) 和 saturation(float)（也可以直接用 .food(2, 0.2) 简写）；.tier(...) 只接受 MutableToolTier 对象，字符串（如 .tier('diamond')）没有可用重载，要改材质或数值请用 .modifyTier(tier => …)，可调 setUses、setSpeed、setAttackDamageBonus、setEnchantmentValue 等。

对应的数据包绑定：

json

// kubejs/data/example/mxt/item_binding/fire_root_pellet.json
{
  "items": "kubejs:fire_root_pellet",
  "quality_group": "#example:group/pellet",
  "actions": [
    {
      "type": "mxt:grant_spirit_root",
      "spirit_root": "example:fire_root"
    }
  ]
}

json

// kubejs/data/example/mxt/weapon_binding/firebound_sword.json
{
  "items": ["kubejs:firebound_sword", "#example:fire_weapons"],
  "attack_damage": 8,
  "attack_speed": -2.4,
  "quality_group": "#example:group/firebound_weapon"
}

json

// kubejs/data/example/mxt/pill_binding/returning_pill.json
{
  "items": "kubejs:returning_pill",
  "quality_group": "#example:group/pill",
  "toxicity_gain": 10,
  "toxicity_threshold": 100,
  "toxicity_after_overdose": 25
}

json

// kubejs/data/example/mxt/technique_binding/fire_manual.json
{
  "items": "kubejs:fire_manual",
  "technique": "example:fire_manual",
  "quality_group": "#example:group/manual"
}

四种绑定均只引用已经由 KubeJS、原版或其他模组注册的物品；quality_group 是可选的原版 item_quality 标签引用。当前各绑定的运行时接入状态和缺口以项目仓库内的「模块实现审计」为准。

KubeJS 注册物品表后需要重启游戏；MXT 的绑定数据表属于原版数据包注册表，读取发生在世界加载时，因此修改后需要重新加载世界（单机退回标题界面再进入，服务器重启），/reload 不会重新读取它们。绑定的物品 ID 不存在时，数据包加载会失败，避免产生无法解析的物品规则。

KubeJS 综合示例 ​

自定义 Cost ​

KubeJS 综合示例

自定义 Cost