事件列表
事件归属
定时器
event: task xxx
用于循环定时检查自定义条件是否满足，应用情景比如有检查玩家是否在 某个区域内，或者检查玩家是否拥有权限等等
展开
配置
event: task xxx
# 多久检测一次，单位为 tick （20 tick为 1 秒）
period: 20
# 是否异步
async: true
condition: |
kether布尔值语句
什么是异步检查
异步检查是指，检查条件的过程不会阻塞主线程，而是在另一个线程中进行， 这样可以避免检查条件的过程阻塞主线程，导致游戏卡顿。
但是有些情境下不适用异步检查，比如检查玩家是否在某个区域内，如果异步检查， 那么在检查的过程中，玩家可能已经离开了区域，这样就会导致检查结果不准确。
异步检查最好用于不影响主线程的检查，比如检查玩家是否拥有权限、玩家的经济是否足够等等。
例子
event: task 定时器唯一编号
period: 20
async: true
condition: |
permission "hello.world"
错误示范
event: 编号
提示
使用定时器事件，必须在前缀中加上 task，否则插件不知道这是定时器事件
正确示范
event: task ababaui
破坏方块
event: break block
玩家破坏方块时触发目标条目事件
展开
放置方块
event: place block
玩家放置方块时触发目标条目事件
展开
玩家死亡
event: player death
玩家死亡时触发目标条目事件
展开
配置
pass:
# 死亡原因，支持多原因
cause:
- DROWNING
- SUFFOCATION
# 次数
amount: 3
死亡原因列表
| 原因 | 描述 |
|---|---|
| BLOCK_EXPLOSION | 在爆炸范围内受到的伤害 |
| CONTACT | 接触仙人掌、钟乳石（石笋）或浆果丛等方块时受到的伤害 |
| CRAMMING | 在一个方块内有过多实体时受到的伤害 |
| CUSTOM | 自定义伤害 |
| DRAGON_BREATH | 被末影龙的龙息攻击时受到的伤害 |
| DROWNING | 在水中呆太久或淹死时受到的伤害 |
| ENTITY_ATTACK | 被实体攻击时受到的伤害 |
| ENTITY_EXPLOSION | 在实体爆炸范围内受到的伤害，例如苦力怕的爆炸 |
| ENTITY_SWEEP_ATTACK | 一个实体在横扫范围中攻击到另一个实体时受到的伤害 |
| FALL | 从高处掉落受到的伤害 |
| FALLING_BLOCK | 被掉落方块砸到受到的伤害 |
| FIRE | 在火中受到的伤害 |
| FIRE_TICK | 由于烧伤造成的伤害 |
| FLY_INTO_WALL | 撞到墙壁受到的伤害 |
| FREEZE | 冻伤引起的伤害 |
| HOT_FLOOR | 在熔岩上受到的伤害 |
| LAVA | 在熔浆中受到的伤害 |
| LIGHTNING | 被闪电击中受到的伤害 |
| MAGIC | 伤害药水或魔法造成的伤害 |
| MELTING | 在冰上融化时受到的伤害 |
| POISON | 由于持续性毒药造成的伤害 |
| PROJECTILE | 被抛射物攻击时受到的伤害 |
| SONIC_BOOM | 被末影龙的冲击波攻击时受到的伤害 |
| STARVATION | 由于饥饿造成的伤害 |
| SUFFOCATION | 被窒息或淹死时受到的伤害 |
| SUICIDE | 由自杀命令造成的 |
| THORNS | 被荆棘反弹的攻击所造成的伤害 |
| VOID | 掉入虚空受到的伤害 |
| WITHER | 凋零效果造成的伤害 |
玩家聊天
event: player chat
玩家在聊天框发送聊天消息时触发的目标条目事件
展开
配置
pass:
# 次数
amount: 2
# 消息内容是否包含其中之一
content:
- "hello world"
玩家击杀实体
event: player kill entity
玩家击杀实体时触发的目标条目事件
展开
配置
pass:
# 次数
amount: 2
# 实体类型
entityTypes:
- PIG
- ZOMBIE
# 其中包含的实体名 称
name:
- "猪八戒"
# 掉落经验，不填或为0则返回true
exp: 0
玩家发送命令
event: player send command
玩家执行命令时触发的目标条目事件
展开
配置
pass:
# 次数
amount: 2
# 消息内容是否包含其中之一
content:
- "hello world"
附魔物品
event: enchant item
玩家附魔物品时触发的目标条目事件
展开
配置
pass:
# 次数
amount: 2
# 费用
cost: 0
# 物品匹配
item:
- "MINECRAFT -material 'STONE' -amount 1"
物品匹配
物品匹配格式
类型 -键1 值1 -键2 值2
原版物品
MINECRAFT -键 值
原版的键值对内容列表如下
| 键 | 值 | 默认值 |
|---|---|---|
| material | 物品材料 | |
| amount | 物品数量 | 1 |
| displayName | 物品显示名称 | |
| loreContains | 物品条目描述包含 | |
| customModelData | 物品自定义模型数据 |
例子
匹配物品材料为石头，数量为1的物品
MINECRAFT -material STONE -amount 1
MMOItems 物品
MMOITEMS -键 值
| 键 | 值 | 默认值 |
|---|---|---|
| id | MMOItems物品ID | |
| amount | 物品数量 | 1 |
例子
匹配物品ID为 hello，数量为1的物品
MMOITEMS -id hello
ItemsAdder 物品
ITEMSADDER -键 值
ItemsAdder的键值对内容列表如下
| 键 | 值 | 默认值 |
|---|---|---|
| id | ItemsAdder物品ID | |
| amount | 物品数量 | 1 |
例子
匹配物品ID为 world，数量为3的物品
ITEMSADDER -id world -amount 3
玩家钓鱼
event: player fish
玩家钓鱼时触发的目标条目事件
展开
配置
event: player fish
pass:
# 次数
amount: 2
# 实体类型
entityTypes:
- PIG
# 钓鱼钩住的实体，包含实体类型
hook:
- PIG
# 钓鱼状态
state:
- BITE
- CAUGHT_ENTITY
# 获取经验
exp: 0
合成物品
event: craft item
玩家合成物品时触发的目标条目事件
展开
配置
pass:
# 次数
amount: 2
# 合成的物品的物品匹配
item:
- "MINECRAFT -material STONE"
物品匹配
物品匹配格式
类型 -键1 值1 -键2 值2
原版物品
MINECRAFT -键 值
原版的键值对内容列表如下
| 键 | 值 | 默认值 |
|---|---|---|
| material | 物品材料 | |
| amount | 物品数量 | 1 |
| displayName | 物品显示名称 | |
| loreContains | 物品条目描述包含 | |
| customModelData | 物品自定义模型数据 |
例子
匹配物品材料为石头，数量为1的物品
MINECRAFT -material STONE -amount 1
MMOItems 物品
MMOITEMS -键 值
| 键 | 值 | 默认值 |
|---|---|---|
| id | MMOItems物品ID | |
| amount | 物品数量 | 1 |
例子
匹配物品ID为 hello，数量为1的物品
MMOITEMS -id hello
ItemsAdder 物品
ITEMSADDER -键 值
ItemsAdder的键值对内容列表如下
| 键 | 值 | 默认值 |
|---|---|---|
| id | ItemsAdder物品ID | |
| amount | 物品数量 | 1 |
例子
匹配物品ID为 world，数量为3的物品
ITEMSADDER -id world -amount 3
切换主副手 / 按 F 键
event: player swap hand items
玩家切换主副手 / 按 F 键时触发的目标条目事件
展开
配置
pass:
# 次数
amount: 2
# 不填或满足所有条件返回 true
need:
- |
all [ permission hello.world permission world.hi ]
玩家对话
event: player dialog
玩家通过本插件的对话系统进行对话时触发的目标条目事件
展开
配置
pass:
# 次数
amount: 3
# 对话编号
dialog:
- hello
- 阿八阿巴
玩家对话回复
event: player reply
玩家通过本插件的对话系统进行对话选择回复时触发的目标条目事件
展开
配置
pass:
# 次数
amount: 5
# 对话编号
dialog:
- hello
- 阿八阿巴
# 回复选项编号
reply:
- world
左键交互 Adyeshach NPC
event: left ady
玩家左键交互NPC触发的目标条目事件
展开
配置
pass:
# NPC的ID
id:
- "66"
- "8"
- hello
# 不填或满足所有条件返回 true
need:
- |
all [ player permission hello.world
tags has hehe ]
# 次数
amount: 2
右键交互 Adyeshach NPC
event: right ady
玩家右键交互NPC触发 的目标条目事件
展开
配置
pass:
# NPC的ID
id:
- "66"
- "8"
- hello
# 不填或满足所有条件返回 true
need:
- |
all [ player permission hello.world
tags has hehe ]
# 次数
amount: 2
左键交互 Citizens NPC
event: left npc
玩家左键交互NPC触发的目标条目事件
展开
配置
pass:
# NPC的ID
id:
- "66"
- "8"
- hello
# 不填或满足所有条件返回 true
need:
- |
all [ player permission hello.world
tags has hehe ]
# 次数
amount: 2
右键交互 Citizens NPC
event: right npc
玩家右键交互NPC触发的目标条目事件
展开
配置
pass:
# NPC的ID
id:
- "66"
- "8"
- hello
# 不填或满足所有条件返回 true
need:
- |
all [ player permission hello.world
tags has hehe ]
# 次数
amount: 2
玩家击杀 MythicMobs
event: player kill mythicmobs
玩家击杀 MythicMobs 实体时触发的目标条目事件 (监听事件: MobDeathEvent)
展开
配置
pass:
# 次数
amount: 2
# MythicMobs的 ID
id:
- test
- "2"
进入 CustomGo 房间
event: join csg
玩家进入 CustomGo 房间时触发的目标条目事件 (监听事件: PlayerJoinLobbyEvent)
展开
配置
pass:
# 次数
amount: 2
# MythicMobs的 ID
id:
- test
- "2"
离开 CustomGo 房间
event: quit csg
玩家离开 CustomGo 房间时触发的目标条目事件 (监听事件: PlayerLeaveLobbyEvent)
展开
配置
pass:
# 次数
amount: 2
# MythicMobs的 ID
id:
- test
- "2"
登录密码错误
event: authme failed login
登陆时输入错误密码
展开
配置
pass:
# 次数
amount: 2
# MythicMobs的 ID
id:
- test
- "2"
注册参数错误
event: authme failed register
注册密码不一样，注册密码过于简单
展开
配置
pass:
# 次数
amount: 2
# MythicMobs的 ID
id:
- test
- "2"