绑定与解绑道具

该模块允许玩家用一个带特殊 NBT 的物品去绑定或解绑另一个物品。启用后，玩家把绑定/解绑道具放在鼠标指针上，点击目标物品触发。

触发条件

需要 modules/bind-item.yml 中 enable: true，并重启服务端后才会注册监听器。

配置文件

modules/bind-item.yml

# 绑定物品，使用一个物品来绑定/解绑物品
# 将绑定物品放在指针上,点击需要绑定的物品完成绑定
# 你需要给物品设置特殊的NBT才能将物品标记为绑定物品, 键是下面配置的 bind.nbt ,值是绑定配置, 无匹配将自动识别

# 给物品下面的配置 unbind.nbt 的nbt 标记物品为解绑物品

# 你可以可以使用命令 '/sakurabind autoBind 键 值' 的方式来快速给物品加上nbt
# 如果是默认配置就是 '/sakurabind autoBind sakura_bind_bind-item' 标记物品为绑定物品, 绑定配置自动识别
readme: ''

# 功能总开关，重启生效
enable: false

# 绑定物品
bind:
  # 识别配置的NBT路径, 值是指定 settings.yml的匹配器键，不存在将自动识别
  nbt: sakura_bind_bind-item
  # 成功率, 每次绑定都会消耗一个物品
  chance: 100.0
  # 成功率，储存在nbt中，不读配置
  chance-nbt: sakura_bind_bind-item-chance

# 解绑物品
unbind:
  # 识别配置的NBT路径
  nbt: sakura_bind_unbind-item
  # 成功率, 每次解绑定都会消耗一个物品
  chance: 100.0
  # 成功率，储存在nbt中，不读配置
  chance-nbt: sakura_bind_unbind-item-chance

# 如果绑定/解绑的是可堆叠的物品，那么需要消耗相同数量的物品，否则每次只消耗一个
syncAmount: true

NBT 规则

绑定道具的 bind.nbt 值是 settings.yml 中的匹配器键。值为空或键不存在时，目标物品会按普通匹配器自动识别。

解绑道具的 unbind.nbt 值是正则表达式，会与目标物品当前匹配器键比较。值为空时可以解绑任意绑定物品；例如 ^test.* 可以解绑所有匹配器键以 test 开头的物品。

chance 和 chance-nbt 使用 0-100 的百分数。75% 应写 75 或 75.0。

示例

将手持物品标记为绑定道具，绑定配置自动识别：

/sakurabind autoBind sakura_bind_bind-item

将手持物品标记为绑定道具，成功率 75%：

/sakurabind autoBind sakura_bind_bind-item
/sakurabind autoBind sakura_bind_bind-item-chance 75.0

将手持物品标记为绑定道具，固定把目标物品绑定为 settings.yml 中的 test 匹配器：

/sakurabind autoBind sakura_bind_bind-item test

将手持物品标记为解绑道具，可以解绑任意绑定物品：

/sakurabind autoBind sakura_bind_unbind-item

将手持物品标记为解绑道具，只能解绑 test 匹配器：

/sakurabind autoBind sakura_bind_unbind-item test

将手持物品标记为解绑道具，只能解绑所有以 test 开头的匹配器：

/sakurabind autoBind sakura_bind_unbind-item ^test.*