# :-: 触发器参数详解 ***** </br> 例如: `count_down` 倒计时触发器后面会传入 `time` 剩余时间 参数 在 `event` 中 `[带!支持参数/变量]` 带感叹号的地方, 都可以用格式 `{var.参数名}` 获取到这个参数 例如: `type=msg;msg=当前剩余时间: {var.time};to=join` ***** </br> # :-: 多级参数 ***** </br> 这个对于开发者来说比较熟悉,但是我们不需要了解太深刻,只需知道怎么用就行 如: `block_interact` 触发器 会传入 `block = 方块` 和 `hand = 主/副手(true/false)`参数 参数处理器会识别 `block的类型为方块时(org.bukkit.block.Block)`会把`location`也做为多级参数传进来 变量在event的调用方法为: `{arg.block.location}` 如: `type=msg;msg=交互的方块坐标为: {arg.block.location.x},{arg.block.location.y},{arg.block.location.z};to=join` <br> ***** 还可以用于[条件(condition)](%E6%9D%A1%E4%BB%B6.md)判断的 `arg_box` 检测 如: `type=arg_box;name =block.location;loc1=0,0,0;loc2=100,100,100` (这里注意name = block.location) 不需要带上`花括号`和 `var` </br></br></br> # :-: 所有参数处理器的格式 ***** >[danger] 其中 `@` 为参数名,如 `block` -> `block.x` ### :-: 方块 |`org.bukkit.block.Block` | 方块| 对象类型| 变量示例| |---|---|---|---| | @.location |坐标对象|`org.bukkit.Location`|`{var.block.location}` = `x,y,z`| | @.x|坐标x|整数 `int`|`{var.block.x}`| | @.y|坐标y|整数 `int`|`{var.block.y}`| | @.z|坐标z|整数 `int`|`{var.block.z}`| | @.type|方块类型枚举|`org.bukkit.Material`|`{var.block.type}` = 方块类型,如: STONE(石头)| | @.data|方块子ID/方块耐久值|整数 `byte`|`{var.block.data}`| >[info] 注意这里 `@.location` 入参后还会继续处理 `org.bukkit.Location` 的子级参数 <br><br><br> ### :-: 玩家/实体 |`org.bukkit.entity.Entity` | 玩家/活体/实体| 对象类型| 变量示例| |---|---|---|---| | @.name |名字|文本 `String`|`{var.trigger.name}`| | @.custom-name | 自定义名字(一般用于获取怪物的自定义名字) |文本 `String`|`{var.trigger.custom-name}`| | @.x|坐标x|小数 `double`|`{var.trigger.x}`| | @.y|坐标y|小数 `double`|`{var.trigger.y}`| | @.z|坐标z|小数 `double`|`{var.trigger.z}`| | @.location |坐标对象|`org.bukkit.Location`|不推荐| <br><br><br> ### :-: 坐标 |`org.bukkit.Location` | 坐标对象| 对象类型|变量示例| |---|---|---|---| | @.x|坐标x|小数 `double`|`{var.trigger.location.x}`| | @.y|坐标y|小数 `double`|`{var.trigger.location.y}`| | @.z|坐标z|小数 `double`|`{var.trigger.location.z}`| | @.blockx|方块坐标x|整数 `int`|`{var.trigger.location.blockx}`| | @.blocky|方块坐标y|整数 `int`|`{var.trigger.location.blocky}`| | @.blockz|方块坐标z|整数 `int`|`{var.trigger.location.blockz}`| | @.world|所属世界|`org.bukkit.World`|`{var.trigger.location.world}` = 世界名字| <br><br><br> ### :-: 世界 |`org.bukkit.World` | 世界对象 | 对象类型|变量示例| |---|---|---|---| | @.name|世界名字|文本 `String`|`{var.trigger.location.world.name}`| <br><br><br> ### :-: 活体 |`org.bukkit.entity.LivingEntity` | 玩家/活体(怪物) | 对象类型|变量示例| |---|---|---|---| | @.health|当前血量|小数 `double`|`{var.trigger.health}`| | @.maxhealth|最大血量|小数 `double`|`{var.trigger.maxhealth}`|