
Airdrop 是一个 Paper 插件,允许从空中投放可配置的“包裹”。
包裹是一组物品,可以配置权限和价格。当订购/呼叫时,包裹会以一个由鸡背着降落伞的箱子形式从天而降!
有关命令和配置说明,请参阅 wiki:Wiki

Airdrop is a Paper plugin that allows configurable "packages" to be dropped in from the sky.
Packages are groups of items that can be configured with permissions and a price. The package when ordered / called in arrives from the sky in a crate, carried by a chicken parachute!
See the wiki for commands and configuration instructions: Wiki
下载 Airdrop
下载 Airdrop
下载 Airdrop
下载 Airdrop
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Airdrop
下载 Airdrop
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Airdrop
Airdrop 4.2.0 新增包预览与定向投递功能
自 4.1.0 版本以来的更新说明。
玩家可以在订购前浏览奖励,并将包裹发送给其他玩家或指定位置。管理员无需重新打开编辑器即可更改价格。
在订购前浏览包的价格和奖励
/airdrop packages显示玩家可以请求的包、它们的价格,以及只读的奖励预览(包含物品名称、附魔和描述文本)。价格为零的包被标记为“免费”(Free)。- 浏览操作不会订购掉落物,也不会向玩家收费。请使用预览中显示的自订命令进行订购;本版本未包含 GUI 结账功能。
- 管理员仍可在共享视图中编辑包。对包和权限的更改会刷新目录或关闭过期的预览,而不相关的包更改则保留管理员的工作草稿。
将包裹发送给玩家或坐标
- AIRDR-101:当拴绳断裂时(包括在远程目的地丢失持有者),鸡不再掉落拴绳物品。普通的拴绳仍保留其正常的掉落行为。
- 使用
/airdrop send <package> to <player>发送给在线的确切玩家,或使用/airdrop send <package> at <x> <z> [world]发送给绝对表面坐标。玩家当前所在的维度是隐式的;控制台必须提供维度参数。 - AIRDR-99:补全功能现在提供明确的
to(目标玩家)和at(目标坐标)选项。裸目标将被拒绝。X/Z 坐标输入会显示所需轴的使用提示,而非数字建议,从而在不产生空服务器回复的情况下解决本地问题。玩家名称和维度名称的补全功能仍然可用。不完整的坐标和多余参数会收到原生语法错误。未修改的英文用法/帮助信息已迁移;自定义文本得以保留。 - 发起投递的玩家支付包的费用,而非接收者。
airdrop.cost.bypass权限可使投递和自订变为免费,默认值为 false。仅拥有 Operator 状态或airdrop.admin权限并不能免除费用。有效的权限通配符可能包含费用豁免。 airdrop.send默认值为 true;发送者仍需具备包的访问权限。原生控制台和 RCON 投递默认免费;明确的发送权限或费用权限拒绝仍会阻止这些操作。其他非玩家发送者需要明确的费用豁免。- 免费的玩家请求仍遵守冷却时间、待处理请求保护、容量限制和保护着陆规则。
- 目标在确认时被捕获;移动或断开连接不会重定向掉落物。接收者会收到传入和着陆的消息,包括发送者的名字,并且在支持的客户端上会显示内联的玩家头像。箱子仍然是公共桶;离线奖励不会排队。
- 设置
gifting.require-recipient-permission: true以要求命名接收者具备包的访问权限。此可选检查不适用于坐标。 - 投递失败时,如果插件仍处于活动状态,可以向原始付款人退还已确认的费用。支付结果不明确和停机导致的失败仍保留现有局限性;失败的付费请求永远不会变为免费。
- 仅限开发环境的 gift/grant 命令已被 send 取代。命名为
send、gift或grant的包仍然是合法的。
远程投递在收费前准备地形
- 远程目标在通过权限和准入检查后异步加载。除非启用了
drop.remote-loading.generate-new-chunks,否则目标和其周围两个区块的 ticking 区域必须已经生成。 - 远程准备默认支持两个并发加载,尝试冷却时间为五秒,超时时间为十秒。失败的尝试也会消耗尝试延迟。准备超时不会向发送者收费。
- 新地形生成要求 ticking 区域位于世界边界内。目标在着陆或失败前保持保留,下落时间有上限。本地掉落保留其降落伞飞离动画;远程准备在着陆时清理其降落伞。
- 免费的远程箱子在收集、清理或其配置的过期时间(默认为十分钟)之前保持加载状态。它们仍然是免费箱子,而非付费可回收桶;卸载维度或停止插件仍会移除它们。付费箱子保留其现有的恢复行为。
原子式更改价格并识别受阻的掉落物
/airdrop package price <package> <new-price>原子式保存一个有限且非负的价格,而不会更改奖励物品或不相关的包。管理员、控制台和 RCON 均可执行此操作;无需重载。验证或保存失败会使文件和实时注册表保持不变。- 开放目录在重新定价后刷新。已接受的请求保留其捕获的价格;后续请求使用新价格。
- 受阻的玩家请求会描述最高表面材质和 Y 坐标,并建议移动到开阔天空。使用
{material}和{y}自定义errors.sky-blocked-surface。其他目标失败使用errors.invalid-target。
升级前审查新设置和集成事件时机
- 如果包裹在下落过程中目标方块发生变化,投递可能会失败,而不是移动到预留的目标位置。已确认的费用仍会按照正常退款流程处理,前提是插件保持启用状态。最初报告的落地不匹配问题仍在调查中(AIRDR-100)。
- 支持的运行环境仍为 Paper 1.21.11 与 Java 21。升级前请备份插件及其数据文件。现有的包裹文件将保留其奖励和价格;缺失的新设置将使用上述默认值。
- 新的英文消息键会合并到现有本地化文件中,但不会替换已自定义的值。未修改的库存发送消息已更新,以解释新的控制台策略。自定义本地化文件可以翻译目录、发送、价格和目的地反馈相关的消息。
- 扩展 API
1.0.0仍作为初始采用标识符。请求事件现在在临时准入和地形解析之后触发。早期拒绝的请求没有请求上下文或生命周期事件;集成开发需同时检查返回句柄的结果并监听事件。详见 API 版本策略。 - 文档现已托管于 GitHub,Modrinth 上的概述更为简洁。Real-Paper 相关内容已扩充,且集成测试套件通过复用服务器来减少重复的启动工作。
Airdrop 4.1.0 添加了投递消息和支持的插件 API
涵盖自 4.0.0 版本以来变更的发行说明。
Airdrop 4.1 告知玩家其货箱何时生成并降落。新的版本化 API 允许其他插件请求投放并跟踪投递结果。
玩家可以追踪自己的投递
- 当货箱生成时,玩家会收到一条传入消息,其中包含付费投放的费用金额。着陆消息提供货箱的方块坐标,如果玩家已移动到其他世界,则显示世界名称。
- 根帮助和标签补全功能显示发送者可用的命令和包。删除包时会建议现有的包名。
LuckPerms 现在是可选的
- LuckPerms 现在是可选的。当缺少 LuckPerms 时,Airdrop 使用标准的 Bukkit 权限。非操作员仍然需要明确的包权限。
- 当
packages.yml缺失时创建的入门包仍收取10.0费用。现有的包文件(包括故意空的packages: {})保留其内容和价格。 - 管理员定价为
0的包无需经济插件即可工作。付费的玩家请求需要启用经济支持、VaultUnlocked 或 Vault,以及兼容的经济提供商。
状态和支付诊断帮助管理员调查失败情况
- 新的
/airdrop status命令报告就绪状态、经济可用性及其提供商、包数量和修订版、待处理请求、活跃投放、容量限制以及最新的脱敏诊断信息。管理员和控制台用户可以在 Airdrop 启动期间运行此命令。 /airdrop version分别标识插件、扩展 API、Paper 目标和 Java 要求,并提供文档链接。未更改的旧英文版本消息会自动升级;自定义文本继续使用其遗留占位符正常工作。- 支付警告包括请求 ID、玩家、金额和提供商,以帮助管理员调查不确定的扣款和失败的退款。
包和货箱修复保护奖励
- 命名为 Save、Cancel、Back 或 Help 的奖励物品得以保留。编辑器控件通过其元数据而非显示名称进行识别。
- 爆炸处理让桶的内容交由 Paper 处理,而不是在 Airdrop 清理期间删除它们。旧的库存事件不能移除替换桶或改变另一个货箱的状态。
- 货箱效果在成功打开后停止。取消打开会使效果继续运行,而缺失或无效的烟雾设置会使烟雾保持禁用状态。
- 如果目标世界在付费货箱生成之前卸载,Airdrop 会在插件保持活动期间尝试对已确认的收费进行一次尽力而为的退款。模棱两可的支付结果和关闭期间的失败仍不会触发自动退款。
- 启动和重载回调在关闭开始后停止发布状态。
插件集成获得版本化服务和生命周期事件
Airdrop 在 com.airdropmc.api 下引入了扩展 API 1.0.0,该 API 独立于插件和 Paper 进行版本控制。
- 通过 Bukkit 的
ServicesManager发现AirdropApi,并在请求投放前等待就绪。 - 提交类型化的玩家或系统请求,并通过
DropHandle观察单独的生成和最终结果,包括投递和支付状态。 - 通过支持的事件取消请求或着陆尝试。观察完成的生成、着陆、结果、包注册表更改、恢复的投放以及货箱跟踪的结束。
- 查询不可变的包和活跃投放快照,具有用于跨事件跟踪投放的请求 ID 和货箱 ID。
- 使用新的 集成指南、API Javadocs 和兼容性策略。 自动签名检查保护支持的 API 免受意外更改的影响。
Airdrop 4.1 对旧的公共实现类进行了源和不二进制不兼容的更改。请针对支持的 API 重新构建集成。控制器、管理器、Crate 和配置包装器不在该 API 范围内。PackageDropEvent 和 PackageLandEvent 仍然是弃用的、不受支持的适配器;请改用 com.airdropmc.api.event。
CannotAffordException 已被移除,EconomyUnavailableException 现在需要 DISABLED 或 NO_PROVIDER 原因。
在更新集成之前,请参阅 4.1 迁移指南 和 API 版本政策。
升级需要有效的包文件
- 受支持的运行时是 Java 21 的 Paper 1.21.11。
- 升级前备份插件及其数据。重命名称为
create、delete或status的包,并更新其权限授予;这些名称现在是保留字。 - Airdrop 现在强制执行最多 27 个配置的包 的限制。每个包仍然可以容纳多达 27 个奖励堆叠。
- 格式错误或缺失的物品列表、无效的物品条目以及没有可交付物品的付费包现在将拒绝配置。无效的物品条目将标识包和条目索引。失败的重载将保留之前的活动状态;必须在 Airdrop 就绪之前纠正无效的启动数据。
- 不需要新的
config.yml设置。烟雾注释现在描述着陆货箱上方的列。新的英文消息键会自动添加;自定义区域设置可以翻译投递、帮助和状态消息。
关于这个资源的讨论、问题反馈与使用心得
还没有讨论,来发第一帖吧
你是这个资源的作者?登录后可认领此资源。
相似资源
插件
PacketEvents 是一款专为 Minecraft Java 版打造的协议库,旨在简化数据包的处理与传输。
插件
ExyliaPlugins 的库。
插件
通过对话框或铁砧界面帮助你的 Anthme
插件
重新定义服务器上的生物运输方式。使用高度可定制的口袋道具,安全地捕获、存储和释放任何实体。
插件
为基于 Spigot/Paper/Folia 的服务器添加对 Vivecraft 的支持
插件
用于绘制游戏内地图或在浏览器中随探索实时进行地图绘制的实时地图。
评论 0
登录后参与评分
还没有评论,来抢沙发吧