ConditionalEvents - 事件条件与自定义动作

ConditionalEvents 是一款功能强大的 Minecraft 插件，它允许你为各种游戏事件设置自定义条件，并在条件满足时执行相应的动作。通过灵活的条件判断和丰富的动作类型，你可以实现近乎无限的服务器自定义功能。

💡插件功能亮点

• 你可以阻止特定命令，并踢出使用该命令的玩家或播放音效。
• 你可以取消玩家在特定世界中的破坏或放置方块事件。
• 你可以根据玩家死亡时所在的世界，将其传送到不同的地点。
• 你可以创建自定义命令，例如查看其他玩家等级或发布公告。
• 你可以为命令参数添加 Tab 自动补全。
• 你可以持续检测玩家是否进入某个区域，并为其执行特定动作。
• 你可以阻止特定物品的合成。
• 你可以制作“有毒”的水域。
• 你可以让玩家在受到跌落伤害时立即死亡。
• 你可以为使用剑或盔甲等物品设置等级要求。
• 当玩家赢得其他插件的小游戏时，你可以为其执行动作（需要插件 API 支持）。

🎮核心特性概览

事件支持

插件支持 30 多种事件类型，包括

• 玩家事件：加入、退出、重生、死亡、升级、聊天、执行命令、切换世界、攻击、造成伤害、传送等。
• 物品事件：交互、拾取、消耗、移动、合成、丢弃、选择、附魔、修复。
• 方块事件：交互、破坏、放置。
• 实体事件：交互、生成。
• 其他事件：控制台命令、重复性事件、来自其他插件的自定义事件（如 Citizens、WorldGuard 事件等）。

条件与动作系统

• 条件判断：支持多种条件类型、变量比较以及在条件中使用数学公式。
• 动作执行：提供丰富的动作类型，如发送消息、执行命令、传送、给予药水效果、踢出玩家、播放音效、更改游戏模式、发送至其他服务器、发送动作栏/标题消息、移除物品、等待时间等。
• 动作范围：可针对全服、特定世界或特定范围内的玩家执行动作。

其他实用功能

• 支持一次性事件和事件冷却时间。
• 完美兼容 PlaceholderAPI，可使用上千种变量。
• 支持 1.8 及以上版本的服务器。

🔧命令与权限

命令列表

插件主命令为 /conditionalevents，别名 /ce。

• /ce help : 显示插件命令帮助。
• /ce reload : 重载配置文件。
• /ce verify : 检查所有事件配置是否存在错误。
• /ce debug : 启用或禁用指定事件的调试信息（建议在控制台使用，以免刷屏）。
• /ce reset /all /all : 重置指定玩家（或所有玩家）的指定事件（或所有事件）数据。
• /ce enable/disable : 启用或禁用指定事件。
• /ce call (可选)%变量1%= ;%变量N%= : 手动触发一个“调用”事件，并可传递变量。例如：/ce call event1 %test_variable%=25。

权限节点

• conditionalevents.admin : 授予使用所有插件命令的权限。
• conditionalevents.bypasscooldown. : 允许玩家完全绕过指定事件的冷却时间。

❓支持与资源

官方支持

• 作者支持：如有问题或需要联系作者，请在 SpigotMC 的插件讨论区发帖、发送私信，或在 GitHub 上提交 Issue。
• Discord 社区支持：这是一个西班牙语社区 Discord，但也设有英语支持频道。你可以在 “Plugins Ajneb97” 分类下的 “conditionalevents” 频道寻求帮助。请注意，此频道由社区用户提供支持，作者不一定在线解答。如需作者直接帮助，请使用上述讨论区或私信方式。

文档与教程

• 完整 Wiki（英文）：https://ajneb97.gitbook.io/conditionalevents/
• 中文 Wiki（由 @CommandAndOrder 维护）：https://fireworkpolymer.gitbook.io/conditionalevents/

注意事项

请在给予差评前先尝试联系作者解决问题。如果你遇到任何 Bug 或对插件有新功能的建议，欢迎通过讨论区或私信联系作者。

💡关于 ConditionalEvents

ConditionalEvents 是一款强大的 Minecraft 插件，它允许你基于服务器中发生的各种事件来执行自定义命令。通过灵活的条件判断，你可以创建复杂的自动化流程、互动系统和游戏机制，而无需编写任何代码。所有配置均通过直观的 YAML 文件完成。

🎮核心功能

• 事件驱动：监听玩家交互、实体行为、方块变化等众多游戏事件。
• 条件判断：为每个事件设置多重条件（如权限、世界、手持物品、变量比较等），只有满足所有条件时才会触发动作。
• 自定义动作：触发时执行控制台命令、玩家命令或发送消息。
• 变量系统：使用和修改 PlaceholderAPI 变量，实现动态数据追踪与判断。
• 高度可配置：通过编辑 config.yml 和独立的事件文件，轻松创建和管理复杂规则。

🔧快速开始

安装

• 确保服务器已安装 Spigot、Paper 或其衍生服务端（1.13+）。
• 将 ConditionalEvents.jar 放入服务器的 plugins/ 文件夹。
• 重启服务器以生成配置文件和文件夹。

创建你的第一个事件

• 在 plugins/ConditionalEvents/events/ 文件夹内创建一个新的 .yml 文件（例如 my_event.yml）。
• 使用以下基础结构编写事件：

example_event:
event: player_interact
conditions:
- 'item_in_hand:DIAMOND_SWORD'
actions:
- 'console:say %player_name% 使用了钻石剑！'

• 保存文件，并在游戏内或控制台使用命令 /conditionalevents reload 重载配置。

✨命令与权限

命令

• /conditionalevents 或 /ce - 显示插件帮助。
• /conditionalevents reload - 重载所有配置文件和事件。
• /conditionalevents list - 列出所有已加载的事件。
• /conditionalevents info - 显示特定事件的详细信息。

权限

• conditionalevents.admin - 使用所有插件管理命令的权限。

❓常见问题

• 如何让事件在特定世界生效？

在事件的 conditions 部分添加条件 world: 。

• 动作中的 player: 和 console: 有什么区别？

player: 以触发事件的玩家身份执行命令，console: 以服务器控制台身份执行命令（拥有最高权限）。

• 插件支持 PlaceholderAPI 吗？

是的，你可以在条件、消息和命令中直接使用 %placeholder% 格式的变量。

• 如何调试事件为什么没有触发？

在 config.yml 中启用 debug: true，然后查看服务器日志以获取详细的检查步骤信息。

⭐更多帮助

完整的配置选项、支持的事件类型、条件运算符和示例，请查阅官方 Wiki 文档：

https://ajneb97.gitbook.io/conditionalevents/