Custom Events Plugin - ExecutableEvents - ：自定义服务器事件工具

ExecutableEvents 是一款功能强大的插件，它能为你的服务器增添独特的互动事件与触发器，开启无限可能。通过它，你可以轻松打造梦想中的自定义事件，为服务器注入浓厚的 MMO/RPG 氛围，一切尽在你的掌控之中。

💡核心特性

ExecutableEvents 允许你为方块添加超过 110 种 不同类型的激活器，并且每个方块可以设置无限个触发器。这些激活器可以附带自定义要求，例如消耗魔力、经验值、金钱或特定物品，从而创造出独一无二的互动玩法。

激活器/触发器示例

以下仅为部分激活器类型示例

• BLOCK_DRY
• CROP_GROW
• PLAYER_BLOCK_BREAK
• PLAYER_DEATH
• PLAYER_FIRST_CONNECTION
• PLAYER_KILL_ENTITY
• ENTITY_SPAWN
• ENTITY_DEATH
• ENDERDRAGON_CHANGE_PHASE

🎮基于 SCore 的强大功能

本插件构建于 SCore 之上，为你提供了极其丰富的自定义工具。

预设命令与条件

• 你可以直接使用超过 100 种 预设命令和 100 种 预设条件来构建复杂的游戏机制。
• 由于 SCore 是开源的，你甚至可以编写属于自己的命令和条件，实现完全自由的创作。

🔧简易创建与安装

插件的创建过程直观易懂，尤其得益于其内置的游戏内编辑器。

快速开始

• 安装过程简单，无需专业技术知识。
• 在游戏中输入命令 /ee editor 即可启动编辑器，开始创作你的专属事件。

✨兼容性与性能

• 插件兼容多个 Minecraft 版本。
• 经过深度优化，确保性能高效，能与你的服务器环境无缝集成。

> 请注意：本文档描述的是 ExecutableEvents 的 免费/演示版本。

💡ExecutableEvents 简介

ExecutableEvents 是一款强大的 Minecraft 插件，它允许你通过创建自定义事件来深度控制服务器。无论是玩家互动、实体行为，还是世界变化，你都可以使用直观的 YAML 配置文件来定义复杂的触发条件和执行动作，无需编写代码即可实现高度定制化的游戏体验。

🎮核心特性

ExecutableEvents 的核心在于其灵活的事件系统，主要由两部分构成：

触发器

触发器用于检测游戏内的特定情况。当条件满足时，关联的事件就会被执行。

• 多种类型：支持玩家交互、实体行为、方块变化、命令执行等多种触发器。
• 可配置条件：可以为每个触发器设置详细的条件，精确控制何时触发。

可执行动作

当事件被触发后，将按顺序执行预设的一系列动作。

• 丰富动作库：包含发送消息、执行命令、生成实体、给予物品、播放音效、运行脚本等大量动作。
• 条件分支：动作可以附带条件，实现“如果...则...”的逻辑判断。
• 循环与延迟：支持循环执行动作，或为动作添加延迟。

🔧快速开始

安装

• 确保服务器已安装 Java 17 或更高版本。
• 将 ExecutableEvents.jar 文件放入服务器的 plugins 文件夹。
• 重启服务器。插件会自动生成配置文件夹 (plugins/ExecutableEvents/)。
• 根据你的需求，在配置文件夹中创建或编辑 YAML 格式的事件文件。

创建第一个事件

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

    events:
      welcome-event:
        triggers:
          player-join:
        executables:
          - send-message: "&a欢迎来到服务器，{player}！"

• 保存文件，并在游戏内或控制台使用命令 /ee reload 重载配置。
• 现在，当有玩家加入服务器时，他们将收到一条欢迎消息。

✨进阶功能

变量系统

插件内置强大的变量系统，允许你在动作中动态使用信息。

• 预定义变量：如 {player}（玩家名）、{location}（位置）、{world}（世界名）等。
• 自定义变量：你可以在动作中设置和调用自己的变量。

条件系统

在触发器和动作中均可应用条件，实现精细控制。

• 触发器条件：例如，只有当玩家在特定世界且拥有权限时才触发事件。
• 可执行条件：例如，只有满足特定条件时才执行某个动作。

与其他插件联动

ExecutableEvents 可以很好地与其他插件协同工作。

• PlaceholderAPI 支持：在消息中使用其他插件提供的占位符（如 %player_health%）。
• 钩子与 API：开发者可以通过提供的 API 让其他插件触发 ExecutableEvents 或添加新的可执行动作类型。

❓常用命令与权限

命令

• /ee help - 显示帮助信息。
• /ee reload - 重载所有事件配置文件。
• /ee list - 列出所有已加载的事件。
• /ee run <事件名> [玩家] - 手动为指定玩家运行一个事件。
• /ee info <事件名> - 查看某个事件的详细信息。

主要权限

• executableevents.* - 所有权限。
• executableevents.reload - 允许使用重载命令。
• executableevents.run - 允许使用手动运行事件的命令。
• executableevents.bypass - 允许玩家绕过某些事件的触发（如果事件配置中启用了“可绕过”选项）。

⭐文档与支持

• 官方文档：更详细的教程、触发器与动作的完整列表，请访问 https://docs.ssomar.com/executableevents/。
• Discord 社区：如需帮助、报告问题或分享创意，可以加入官方 Discord 社区。
• 插件下载：请在 SpigotMC 或作者指定的下载页面获取最新版本的插件。