触发节点
触发节点决定“检测什么物品、什么时候触发、触发后做什么”。一个节点可以只判断权限和变量,也可以绑定指定槽位中的指定物品。
槽位来源
yaml
plugin-slot:
- "Origin#MainHand"plugin-slot 留空时不判断物品,只判断权限、变量、事件等条件。
| 格式 | 说明 |
|---|---|
DragonCore#槽位名 | 读取龙核槽位 |
GermPlugin#槽位名 | 读取萌芽槽位 |
APInventory#分页id#槽位id | 读取梦星桐背包槽位 |
LyInventory#背包id#类型 | 读取离渊背包槽位 |
LyInventoryReload#背包id#类型 | 读取背包重置版槽位 |
YeeJewelry#背包id#槽位id | 读取清守饰品背包槽位 |
PXRPG#类型#背包ID#槽位 | 读取 PXRPG 槽位 |
Origin#MainHand | 原版主手 |
Origin#OffHand | 原版副手 |
Origin#Helmet | 原版头盔 |
Origin#ChestPlate | 原版胸甲 |
Origin#Legging | 原版护腿 |
Origin#Boots | 原版靴子 |
Minecraft#槽位id | 原版背包槽位,常用范围 0-36 |
名称和 Lore 匹配
yaml
name: "equals@名称"
lore:
- "contain@特殊说明"| 写法 | 说明 |
|---|---|
equals@文本 | 完全匹配 |
contain@文本 | 包含文本 |
文本 | 默认按包含文本处理 |
lore 中任意一条满足即可通过。没有名称或 lore 限制时,可以删除对应节点。
Lore 取值
yaml
lore-placeholder:
力量: "力量+<value>"匹配到的数值可以在指令、条件和冷却中使用。
| 写法 | 说明 |
|---|---|
{v.力量} | 默认取整输出 |
{v.力量~%.1f} | 按指定格式输出,例如保留 1 位小数 |
条件
yaml
permission:
- "lilc.use"
nopermission:
- "lilc.block"
condition:
- "%player_level% > 0"| 节点 | 说明 |
|---|---|
permission | 玩家必须拥有全部权限 |
nopermission | 玩家不能拥有列表内权限 |
condition | PlaceholderAPI 条件表达式 |
触发事件
yaml
event:
- "right"常用事件:
| 事件 | 说明 |
|---|---|
move | 移动 1 格 |
attack | 造成伤害 |
damaged | 受到伤害 |
tick | 每秒检测一次 |
sprint | 开始奔跑 |
sneak | 开始蹲下 |
death | 死亡 |
respawn | 重生 |
kill | 击杀 |
break | 破坏任意方块 |
place | 放置任意方块 |
consume | 吃完或喝完物品 |
left | 任意左键交互 |
right | 任意右键交互 |
shiftleft | 蹲下左键 |
shiftright | 蹲下右键 |
GermPlugin#按键 | 萌芽按键 |
DragonCore#按键 | 龙核按键 |
指定目标或类型的事件:
| 写法 | 说明 |
|---|---|
break:方块id | 破坏指定方块 |
place:方块id | 放置指定方块 |
attack:目标名称 | 攻击指定名称目标 |
damaged:目标名称 | 被指定名称目标攻击 |
kill:目标名称 | 击杀指定名称目标 |
right:目标名称 | 右键指定名称目标 |
shiftright:目标名称 | 蹲下右键指定名称目标 |
attack_type:类型 | 攻击指定实体类型 |
damaged_type:类型 | 被指定实体类型攻击 |
kill_type:类型 | 击杀指定实体类型 |
right_type:类型 | 右键指定实体类型 |
shiftright_type:类型 | 蹲下右键指定实体类型 |
指令
yaml
commands:
- "[console]tell %p 触发成功"
- "[op]say %player_name% 使用了道具"
- "[player]spawn"| 前缀 | 执行身份 |
|---|---|
[console] | 后台执行 |
[op] | 临时 OP 身份执行 |
[player] | 玩家身份执行 |
可用内容:
| 内容 | 说明 |
|---|---|
%p | 玩家名 |
%player_name% | PlaceholderAPI 玩家名变量 |
{amount} | 本次扣除数量,配合 take-all 使用 |
{v.变量名} | lore 取值 |
权重指令
yaml
weight-command:
权重组1:
- "30#[console]tell %player_name% 抽中了第一条"
- "70#[console]tell %player_name% 抽中了第二条"每个权重组会按权重随机选择一条执行。单条内可以继续使用 # 串联多条指令。
扣除和几率
| 节点 | 说明 |
|---|---|
chance | 触发几率,范围 0-1,默认 1 |
take | 触发时尝试扣除 1 个匹配物品 |
take-all | 扣除全部匹配物品,并可使用 {amount} |
fail-take | 几率失败时是否扣除,默认 true |
冷却和互斥
yaml
cd: "10"
cd-team: "冷却组"
mutual-exclusion-group: ""| 节点 | 说明 |
|---|---|
cd | 冷却秒数,支持 PAPI 和公式 |
cd-team | 冷却组名,同组共享倒计时 |
cd-message | 冷却中提示 |
mutual-exclusion-group | 互斥组,同组命中后取消后续触发尝试 |
冷却变量见 插件变量。