AxEnvoys - 空投补给箱

💡简介

AxEnvoys 是一款可高度自定义的插件，它让“补给箱”从天而降！你可以手动指定补给箱的降落地点，也可以让插件在特定范围内随机生成它们。

🎮基本信息

• 支持的 Minecraft 版本: 1.20.2 - 1.21.10
• 必需的 Java 版本: 21 或更高
• 源代码: https://github.com/Artillex-Studios/AxEnvoys

✨核心功能

• 自定义数量: 你可以设置任意数量的补给箱（Envoys）。
• 命令奖励: 可以将任何命令设置为开启补给箱的奖励。
• 冷却时间: 可为每个补给箱或整体事件设置独立的冷却时间。
• 自定义生成位置: 可以设置固定的降落点，或指定一个范围进行随机生成。
• 自定义消息: 可以为每个补给箱事件定义专属的提示消息。
• 全息图: 从 2.0 版本开始，支持无需任何依赖的全息图显示。
• 烟花效果: 补给箱生成时会伴随烟花特效。
• 自定义方块支持: 兼容 ItemsAdder 和 Oraxen 的自定义方块。
• 信号弹启动: 可以使用信号弹（Flare）来手动触发一个补给箱事件。

🔧依赖与扩展

• 变量支持: 插件支持 PlaceholderAPI，可在消息中使用变量。
• 自定义方块: 需要配合 ItemsAdder 或 Oraxen 插件来实现自定义方块外观。

💡介绍

AxEnvoys 是一款独特的插件，它彻底改造了传统的“空投”或“信使”游戏玩法。它允许你创建自定义的“使者”事件，这些事件会在世界中生成包含战利品的容器。玩家可以攻击这些容器来获取奖励，为你的服务器增添激动人心的公共活动。

🎮功能特性

• 完全可自定义的使者

- 创建具有独特名称、外观和生成权重的使者。

- 为每个使者设置独立的战利品表。

• 动态生成系统

- 使者在预定义的区域（世界和坐标范围）内随机生成。

- 可配置的生成数量、间隔和同时存在的最大使者数量。

• 丰富的战利品系统

- 使用强大的战利品表系统，支持多种物品类型和奖励。

- 包含命令、经验、货币等多种奖励方式。

- 可设置物品数量范围、奖励权重和触发信息。

• 事件与提示

- 可自定义的全局开始、进行中和结束公告。

- 支持标题、聊天栏和动作条提示。

- 当使者被打开或所有使者被清空时触发事件。

• 高性能与优化

- 专为高性能和低延迟设计。

- 智能的容器生成与清理机制。

🔧命令与权限

主要命令

• /axenvoys - 显示帮助信息。
• /axenvoys help - 显示帮助信息。
• /axenvoys reload - 重载插件配置和数据文件。
• /axenvoys start <envoy> - 手动启动指定的使者事件。
• /axenvoys stop - 手动停止当前活动的使者事件。
• /axenvoys spawn <envoy> - 在玩家位置生成一个指定的使者容器。
• /axenvoys gui - 打开使者管理GUI（需要管理员权限）。

权限节点

• axenvoys.admin - 授予所有管理员命令的访问权限。
• axenvoys.bypass - 允许玩家在处于创造模式或旁观模式时打开使者容器。

✨安装与设置

要求

• 服务器软件: Spigot、Paper 或任何基于它们的衍生核心（如 Purpur）。
• Java版本: Java 17 或更高版本。
• AxSeries 框架: 需要安装 AxSeries 库插件。

安装步骤

• 确保服务器已安装并运行 AxSeries。
• 下载最新版本的 AxEnvoys 插件 JAR 文件。
• 将 JAR 文件放入服务器的 plugins 文件夹。
• 重启服务器。
• 根据 plugins/AxEnvoys/config.yml 中的说明配置使者和战利品表。

初始配置

安装后，插件会生成配置文件。你需要

• 在 envoys.yml 中定义你的使者类型（名称、材质、生成权重等）。
• 在 loottables.yml 中为每个使者创建战利品表，添加物品、命令等奖励。
• 在 config.yml 中调整生成区域、间隔、消息等全局设置。

❓常见问题

• 问：使者不生成怎么办？

- 检查 `config.yml` 中的 `worlds` 和 `spawn-region` 设置，确保坐标范围正确且世界已加载。

- 确认生成间隔 (`spawn-interval`) 和数量 (`spawn-amount`) 设置合理。

• 问：如何添加新的奖励类型？

- 在 `loottables.yml` 中编辑对应使者的战利品表。你可以添加 `items`（原版物品）、`commands`（执行命令）或 `experience` 等部分。

• 问：支持PlaceholderAPI吗？

- 是的，AxEnvoys 支持 PlaceholderAPI。你可以在消息配置中使用相关占位符来显示信息，例如当前活动使者数量。

• 问：如何手动触发一个事件？

- 拥有 `axenvoys.admin` 权限的玩家可以使用 `/axenvoys start <使者名称>` 命令。

⭐支持与链接

• 官方文档: https://docs.artillex-studios.com/axenvoys.html
• 支持与问题反馈: 请访问开发者的官方 Discord 服务器或支持页面。
• 更新日志: 请在官方发布页面查看最新版本和改动信息。