|
| 介绍 | 1.此插件可以让你向特定的事件中添加不同的条件 如果满足这些条件 则将会执行自定义操作
2.此插件有很多变量 如果添加了 PlaceholderAPI 会有更多的变量（占位符）
3.同时这个插件可以用在rpg任务上 完成了事件中的一个条件 可以进行下一关或者给予奖励
4.本插件不支持CraftBukkit系的服务端
此插件允许您向特定事件添加不同的条件。如果完成了这些条件，则将执行你自己做的自定义操作。你用这个插件做出来的可能性是无穷的。为了更简单地理解这个插件，这里有一些例子:
这是一个栗子：
如果一个玩家在特定的坐标下按下一个按钮（或任何一个方块）
你可以为玩家执行一些操作，比如执行你插件里的命令，给他发送消息，给予一些药剂效果，以及其他许多操作。
例2：
如果一个玩家用某个物品伤害了另一个玩家，那么很有可能给被击杀者一个中毒效果。
更多的例子！
-有了ConditionalEvents，你可以阻止让他们使用危险命令，踢出那些使用危险命令的玩家或播放命令的声音。
-你可以取消一些事件，比如在特定的世界里打破或放置方块
-在他们死后 你可以把玩家传送到一个不同的方位，取决于他们是在哪个世界。
-你可以经常检查一个玩家是否进入到一个区域，并为他执行一些动作。
-如果玩家赢得了一个插件小游戏，你可以为他执行一些动作。（需要此插件的API)
该插件支持PlaceholderAPI，因此您可以使用多达1000个的变量添加条件。你也可以从其他插件去检查别的事件
|
|
| 特性 | 20种自定义事件
Block Interact方块交互
Player Respawn玩家重生
Item Interact
Player Damage 玩家打出的攻击
Block Break 方块破坏
Block Place 放置方块
Player Command 玩家所输入的指令
Console Command
Player Chat 玩家聊天栏
Item Interact 物品使用
Player Attack 玩家攻击
Block Break 方块破坏
Block Place 方块放置
Item Consume 物品消耗
Player Join 玩家进入
Player Leave 玩家离开
Player Kill 伤害
Player Level Up 玩家等级提升
Player Armor 玩家护甲
Item Move 物品移动
Item Drop 物品掉落
Item Pickup
Item Craft
Item Select
EntitySpawn
EntityInteract
Repetitive 重复事件
RepetitiveServer
Custom Events 自定义事件（来源自其他的插件）
- √ 多种条件（在使用变量的时候）
-√14种条件
-√变量和比较条件
-√条件计算方程
- √ 可执行的多种操作
Send Chat Message
Send JSON Chat Message
Console Command
Player Command
Teleport
Give Potion Effect
Cancel Event
Kick Player
Play Sound
Change Gamemode
Send to Server
Send Actionbar Message
Send Title Message
Wait Time
Actions for the whole server
Actions for players in a specific world
Actions for players in specific range
- √ 具有可自定义的操作
- √ 可以设置冷却时间
- √ 支持PlaceholderAPI
- √ 只能在1.8+以上版本才可使用
要求：
1）Spigot 或者 Paper (不兼容 craftbukkit)
2）PlaceholderAPI（可选）
要在服务器上装载此插件，只需将你想设置的条件和事件文件放在此插件的文件夹中，再重新启动服务器时将在配置中载入你的所写的条件和事件，您就可以使用你自己的条件和事件。
若要创建新事件，只需在事件路径中的配置中添加新的部分。请记住要对每个事件使用不同的名称。现在，您可以按照下面的教程去使用这个插件。
#每个事件都有特定的格式，你可以使用;来添加更多的事件
type: player_respawn
type: block_break;block_place
#重复事件的冷却事件
repetitive_time: 10
#事件后续动作触发条件，你可以在后面找到更多相关信息
conditions:
- '%player_world% equals pvp1 or %player_world% equals pvp2'
#玩家触发这个动作说需要的权限
permission: conditionalevents.event.event2
#当玩家没有这个权限触发事件所提示的内容.
permission_error_message: '&cYou need to have a rank to use this button.'
#这里你可以自定义玩家再次触发这个事件所需要的时间 （20=1秒）
cooldown: 3600
#事件未完全冷却玩家受到的提示.
cooldown_error_message: '&cYou need to wait &e%time% &cbefore claiming your reward again.'
#你可以给玩家下面这个权限，那么后台不会对这个玩家有任何操作
ignore_with_permission: conditionalevents.ignore.event4
|
|
| 自定义事件 |
ConditionalEvents允许您检查您想要的任何玩家事件，甚至从其他插件。下面您将找到一个解释性的示例文件，以向您展示这些事件是如何工作的。
这是示例文件
事件类型
有不同类型的事件，在这里你可以找到所有的事件以及你可以在每个事件的条件下使用的变量。
方块交互
1.block_interact/方块交互变量：
-％block％（方块的种类，更多方块相关链接 https://hub.spigotmc.org/javadocs/spigot/org/bukkit/Material.html）
-％block_x％（方块所处的x轴）
-％block_y％（方块所处的y轴）
-％block_z％（方块所处的z轴）
-％block_world％（方块所处的世界）
-％action_type％（左键或者右键)
玩家重生
2.player_respawn/玩家重生
变量：
- 无（你可以使用ConditionalEvents变量或PlaceholderAPI变量）
物品使用
3.item_interact/物品使用
变量:
- %item% (物品类型,更多物品相关链接: https://hub.spigotmc.org/javadocs/spigot/org/bukkit/Material.html)
- %item_name% (物品名字)
- %action_type% (使用动作：左键/右键)
玩家攻击
4.player_attack/玩家攻击
变量：
- %item% (玩家攻击的物品. 物品相关链接: https://hub.spigotmc.org/javadocs/spigot/org/bukkit/Material.html)
- %item_name% (玩家攻击的物品名字)
- %victim% (受到伤害的实体类型.更多实体相关链接: https://hub.spigotmc.org/javadoc ... ity/EntityType.html)
方块破坏
5.block_break/方块破坏
变量：
-％block％（方块的种类，更多方块相关链接 https://hub.spigotmc.org/javadocs/spigot/org/bukkit/Material.html）
-％block_x％（方块所处的x轴）
-％block_y％（方块所处的y轴）
-％block_z％（方块所处的z轴）
-％block_world％（方块所处的世界）
- %item% (手上的物品类型. 更多的物品类型链接: https://hub.spigotmc.org/javadocs/spigot/org/bukkit/Material.html)
- %item_name% (手上的物品名称)
方块放置
6.block_place/方块放置
变量：
-％block％（方块的种类，更多方块相关链接 https://hub.spigotmc.org/javadocs/spigot/org/bukkit/Material.html）
-％block_x％（方块所处的x轴）
-％block_y％（方块所处的y轴）
-％block_z％（方块所处的z轴）
-％block_world％（方块所处的世界）
玩家命令（玩家输入的命令）
7.player_command/玩家命令（玩家输入的命令）
- %command% (命令)
玩家聊天
8.player_chat/玩家聊天
变量：
- %message% (内容)
物品消耗
9.item_consume/物品消耗
变量：
- %item% (玩家消耗的物品. 物品相关链接: https://hub.spigotmc.org/javadocs/spigot/org/bukkit/Material.html)
- %item_name% (玩家消耗的物品名字)
重复事件(通过定期检查条件来起作用,重复时间在repetitive_time选项中设定)
10.repetitive/重复事件
变量：
- 无（你可以使用ConditionalEvents变量或PlaceholderAPI变量）
玩家进入事件(当玩家加入服务器时调用的事件。)
11.player_join/玩家加入
变量:
- 无（你可以使用ConditionalEvents变量或PlaceholderAPI变量）
玩家伤害（当玩家杀死实体时调用的事件）
12.player_kill/玩家伤害
变量:
- %item%(手上物品的类型 在此链接上的所有类型：https://hub.spigotmc.org/javadocs/spigot/org/bukkit/Material.html)
- %item_name%(你手上自定义文字的物品)
- %victim%(被杀实体的类型 https://hub.spigotmc.org/javadoc ... kit/EntityType.html )
玩家经验值上升(当玩家改变等级时调用的事件)
13.player_levelup
变量:
- %old_level%(没升等级之前的玩家)
- %new_level%(升级之后的玩家)
玩家护甲（当玩家装备或取消装甲时所发生的事件）
14.player_armor
变量:
- %armor_type%(装甲的类型 可能是：头盔、胸甲、裤子或靴子)
- %equip_type%(可能是：装备盔甲或是不装备盔甲)
- %item%(护甲物品的类型 在此链接上的所有类型：https://hub.spigotmc.org/javadocs/spigot/org/bukkit/Material.html)
物品移动（当玩家试图从物品栏中移动物品时调用的事件。）
15.item_move
变量:
- %item%(物品的类型 在此链接上的所有类型：https://hub.spigotmc.org/javadocs/spigot/org/bukkit/Material.html)
- %item_name%（物品的自定义名称）
- %inventory_type%（物品栏打开时的类型 在此链接上的所有类(https://hub.spigotmc.org/javadocs/spigot/org/bukkit/event/inventory/InventoryType.html）
自定义（你想要的自定义事件。您可以使用其他插件中的事件，更多信息请参阅配置教程部分。）
16.custom
变量：
- 无（你可以使用ConditionalEvents变量或PlaceholderAPI变量）
条件类型条件列表的每一行都引用一个必须为true的条件。您可以使用所有类型的变量，甚至是PlaceholderAPI或ConditionalEvents变量。使用先前在事件类型教程中显示的变量。
例如，在这种情况下，玩家攻击事件有3个条件。被攻击者必须是另一个玩家，使用的物品必须是钻石剑，物品名称应为“SuperSword”
举例1
conditions:
- '%victim% equals PLAYER'
- '%item% equals DIAMOND_SWORD'
- ' %item_name%'
举例2
conditions:
- '%command% startsWith //calc or %command% startsWith //solve or %command% startsWith //eval'
在这个条件中，满足条件的玩家必须输入以// calc开头或以// solve开头或以// eval开头的命令
其他相关的条件符号
==
!=
>=
<=
>
<
举例3
equals
!equals
equalsIgnoreCase
!equalsIgnoreCase
startsWith
!startsWith
event3: type: player_attack
conditions:
- '%victim% equals PLAYER'
- '%item% equals DIAMOND_SWORD'
- '%item_name% equals Super Sword'
- '%random_1-10% >= 8'
actions:
default:
- 'message: &aYour diamond sword poison effect was activated!'
- 'give_potion_effect: %victim%;POISON;120;1'
在其他情况下，如果完成某些条件时，您需要执行不同的操作列表。例如：
举例2
event6:
type: block_interact
conditions:
- '%block_x% == 40'
- '%block_y% == 60'
- '%block_z% == 40'
- '%block_world% equals lobby'
- '%block% equals STONE_BUTTON'
- '%action_type% equals RIGHT_CLICK'
- '%statistic_jump% < 1000 execute actions2'
actions:
default:
- 'message: &aYou''ve received $5000!'
- 'console_command: eco give %player% 5000'
actions2:
- 'message: &cYou need at least 1000 jumps to use this button.'
在这个例子中，如果玩家在一个叫lobby的世界右击一个在坐标是40,60,40的石质按钮，并且跳跃的次数小于1000次
那么后台就会执行action2的动作而不是action的默认动作
动作列表
动作列表
1.message/发送信息
- 'message: &a你好， %player%! !'
2.console_command/控制台命令
- 'console_command: eco give %player% 5000'
3.player_command/玩家命令
- 'player_command: warp survival'
4.teleport/传送
- 'teleport: lobby;0;60;0;90;0'
5.give_potion_effect/药水效果
- 'give_potion_effect: %victim%;POISON;120;1'
6.cancel_event/取消事件
- 'cancel_event: true'
7.kick/踢出
- 'kick: &cWhat are you trying to do?'
8.playsound/播放声音
- 'playsound: %player%;BLOCK_NOTE_BLOCK_PLING;10;0.1'
9.gamemode/游戏模式
- 'gamemode: CREATIVE'
10.send_to_server
描述: Sends the player to a bungee server.（这个不是很懂，如果有知道的，请告诉我）
- 'send_to_server: lobby'
11.actionbar
例子:
- 'actionbar:&6Welcome to server;120'
12.title
fadeIn、stay和fadeOut必须在ticks中,20ticks=1second
如果你仅是想使用标题不使用副标题 只要在 subtitle上写上none就好了
例子：
- 'title: 20;40;20;&6This is Title;none'
13.broadcast
例子:
- 'broadcast: &a%player% just leveled up!'
14.wait
例子：
- 'message: &a3'
- 'wait: 1'
- 'message: &a2'
- 'wait: 1'
- 'message: &a2'
- 'wait: 1'
- 'wait: 1'
- 'message:&aGo!'
15.restore_block
例子:
- 'wait: 10'
- 'restore_block'
这些变量可以在任何情况下使用
%player% (玩家姓名)
%player_x% (玩家坐标)
%player_y% (玩家坐标)
%player_z% (玩家坐标)
%player_world%
%player_gamemode%
%random_min-max% (将在"min"和"max"之间选择一个随机数。例如：%random_1-10% 将选择一个介于1和10之间的随机数)
%armor_<type>% (装甲的<type>材料。用头盔、胸甲、护腿或靴子代替<type>)
%armor_name_<type>% (名字 <type> 盔甲)
你还可以使用 PlaceholderAPI 变量去管理所有事件的情况和动作
配置文件我就发文件了
|
|
| 指令&权限 | 指令：/conditionalevents
-/ce help 显示插件指令
-/ce reload 重新加载插件配置文件
-/ce reset <player><event>重置玩家的所有事件数据
这些只需要一个指令就ok
- +conditionalevents.admin
|
|
|
| 更新记录 | 1.1.1
-添加了 版本检测
-添加了 /ce reset <player> <event> 可以重置玩家的脚本冷却时间
-添加了新的插件指令: /conditionalevents
1.2.1
-添加了 send_to_server动作以将玩家自动连接到一个bungeecord server
-添加了 不考虑大小写时 等于/不等于 的条件类型
1.2.2
-修复了 诸多动作问题
-修复了 冷却问题
1.3.1
-添加了 player_join 事件
-修复了 控制台不断刷最新版本错误消息
1.4.1
-添加了 one_time 这个事件选项. 如果设置为true, 那么玩家就会在某一时间就会启动这个事件.
-添加了 one_time_error_message 这个事件选项.
-修复了 关服时一些关于冷却的错误
1.5.1
-添加了 title 动作标签
-添加了 actionbar 动作标签
1.5.2
-添加了 %armor_<type>% 和 %armor_name_<type>% 变量.
-修复了 有问题的 item_interact 事件.
-修复了 导入错误和 one_time 这个选项.
1.6.1
-添加了 player_kill 事件类型
1.6.2
-修复了 一些 重新加载的时候出现的错误配置问题。
2.0.1
-添加了 自定义事件.
现在，这个插件允许你检查任何你想要的玩家事件，甚至是从其他插件。在这里你可以找到我的插件防御炮塔的例子。当玩家放置炮塔时，条件与事件将被检查，如果玩家在某个世界上，则取消该事件。完整的插件页面教程在下面
event8:
type: custom
custom_event_data:
event: dt.ajneb97.api.TurretPlaceEvent...
2.1.1
- 添加了 player_levelup event type
- 添加了 玩家命令事件类型的新变量：%arg_x%%args_length%
2.2.1
- 添加了 wait 动作类型
- 添加了 broadcast 动作类型
2.3.1
- 添加了 player_armor 动作类型
- 添加了 冷却新玩家保存数据
- 修复了 从配置中删除注释
- 修复了 send_to_server 这个bug
2.4.1
- 添加了 item_move 动作类型
- 添加了 在每个事件上启用选项 将其设置为false以禁用事件而不从配置中删除它。
- 修复了 Equalibug和Equalcase的等号条件句。
2.4.2
- 添加了 restore_block和block_break 这两个事件类型
2.4.3
- 修复了 控制台把调试消息给删除。
2.5.1- 添加了 broadcast_title 动作
- 添加了 broadcast_actionbar 动作
- 修复了 控制台老是因为player_armor这个事件而出现错误
2.6.1
- 添加了 broadcast_playsound 动作
- 修复了 小型 issue/bug 在 item_move 这个事件里
2.6.2
重要更新!
playsound 和 give_potion_effect 这两个动作 已经更新
-添加了 to_target 动作 这是一个特殊动作 为 player_attack这个事件 他将执行玩家目标(被攻击的实体)的操作 此页上的操作部分教程中的信息
-改进了
2.7.1
- 添加了 contains 类型的条件
- 添加了 entity_spawn 类型的事件
2.8.1- 添加了 player_attack 和 player_kill 事件中目标玩家的变量。您可以这样使用它们：%target:<normal\u variable>%
- 举个例子 获取玩家的等级变量是 %vault_rank% 如果你想获得目标等级的话请使用这个%target:vault_rank%
别忘了去我的wiki看完整版使用案例
https://ajneb97.gitbook.io/conditionalevents/
2.9.1
- 添加了 json_message 和broadcast_json_message 这两个动作
- 添加了 player_leave 这个类型的事件
2.9.2
- 添加了 两个关于所有项目与相关事件的新变量
%item_lore%(物品必须在手上)
%item_lore_line_X(手里物品的lore其中的某一行)
2.10.1
- 添加了 to_world 和 to_range 这两个特别的标签
to_world 这个特别的标签需要添加在动作之前 这个标签会为这个游戏地图内的玩家执行很多动作（可以用在恐怖地图里）
to_range 这个特别的标签需要添加在动作之前这个标签会为一定半径范围内的所有玩家执行很多动作（可以用在rpg地图里）
2.11.1
- 添加了 一些物品标签给block_place这个类型的事件
- 添加了 item_drop这个类型的事件
2.12.1
重要更新!
- 添加了 to_all这个特别的标签这个特别的标签需要添加在动作之前 这个标签会为所有玩家执行任何操作
- 移除了 Broadcast这个动作 现在你可以使用to_all这个标签来替代Broadcast
别忘了请查看这个wiki
https://ajneb97.gitbook.io/conditionalevents/
2.12.2
- 添加了 1.16版本的颜色消息
- 添加了 PHYSICAL 这个动作类型 从block_interact这个条件 使用压力板时会起作用
- 修复了 一些自定义事件的控制台错误
2.13.1
- 添加了 这个动作 player_command_sa_op(会从玩家那里执行一条管理员指令）
- 添加了 这个类型的事件 player_damage(当玩家受到伤害时所去调用的事件)
- 添加了 %item_durability% 可以调用所有跟物品相关的变量
2.13.2- 添加了 %block_at_<x>_<y>_<z>_<world>% 这个全局变量
- 修复了 获取了player_kill在to_target时的目标出现错误
2.14.1
- 添加了 remove_potion_effect 这个动作类型
- 添加了 %random_player% 这个全局变量]- 修复了 block_ineract这个事件执行两遍的bug
别忘了请查看这个wiki
https://ajneb97.gitbook.io/conditionalevents/
2.15.1
- 添加了 player_world_change 这个动作类型
- 修复了 关于上次更新的错误
2.15.2
- 添加了 %is_nearby_<x>_<y>_<z>_<world>_<radius>% 这个变量
- 添加了 %random_player_<world>%变量
- 修复了 重置配置时和删除配置时出现的小概率重复使用你所设置的事件
别忘了请查看这个wiki
https://ajneb97.gitbook.io/conditionalevents/
2.16.1
- 添加了remove_item 动作类型- 应用了 这个变量%random_player%在使用的过程时如果玩家不在的话会返回none值
2.17.1
- 添加了console_command事件类型
2.17.2
- 为 block_interact 添加了item in hand变量
- 给1.13以上的版本修复了block_restore的错误
2.18.1
- 添加了 entity_interact 这个事件类型
2.18.2
- 修复了1.9以上的block_interact事件交互问题
2.19.1
- 添加了centered_message这个动作类型
2.20.1
- 添加了 /ce verify 这条指令，通过这条指令确认你所写的事件有什么问题
抱歉，活太多，要搞的东西很多，所以插件更新，先放这一段时间，等有时间了我再过来写，谢谢了
|
|
|
