原创 付费 [1.12.2-最新版|Folia]WarZSupplyDrop｜末日商用空投插件｜网页编辑器｜高级粒子演出｜ 1.0.1

[1.12.2+][原创]WarZSupplyDrop｜末日商用空投插件｜网页编辑器｜高级粒子演出｜崩服残留修复
适配版本：1.12.2 - 1.21.x / Folia 兼容
核心定位：末日生存 / WarZ / 商业服专属付费空投插件

---

插件简介​

WarZSupplyDrop 是一款专为 末日生存、战争服、商业氪金服 打造的高品质空投插件，主打 零门槛上手、全维度可控、视觉演出拉满。
摒弃传统空投插件简陋的机制与单调特效，本插件拥有完整六阶段空投生命周期、三套官方高级粒子演出、可视化GUI编辑器、独立网页在线编辑系统，同时独家适配服务器崩服残留自动清理恢复，彻底解决同类插件实体残留、地形破坏、卡服卡顿痛点。
服主可一键启用默认配置快速开服，也可深度自定义空投外观、刷新规则、奖励结构、特效风格，完美适配各类末日对战、资源补给、氪金奖励玩法。

---

核心亮点​

• 完整生命周期机制：预警→降落→锁定→开启倒计时→可领取→结束清理，流程逻辑严谨，沉浸式体验
• 双编辑器系统：游戏内GUI可视化编辑 + 网页在线编辑器，远程改配置、自动备份、一键重载
• 高级粒子演出系统：内置3套专属特效预设，支持光柱、冲击波、螺旋粒子、烟火爆发，无第三方依赖
• 崩服残留修复：独家残留追踪机制，服务器崩溃/强关后，重启自动恢复地形、清理残留实体
• 高度自定义奖池：支持概率、权重、数量区间、隐藏奖励、命令奖励，适配点券、物品、权限等各类奖励
• 全版本兼容：完美适配 Spigot/Paper/Folia，1.12.2 至最新版本通用，自带粒子跨版本兼容
• 轻量化高性能：粒子与实体采用位置调度，低卡顿不卡服，大型服务器也可稳定运行
• 拓展性极强：内置完整API与监听事件，支持二次开发、自定义联动玩法

---

环境依赖​

• 服务端：Spigot / Paper / Folia1.12.2+
• 运行环境：Java 8+
• 可选依赖：PlaceholderAPI（仅拓展变量功能，无依赖不影响基础使用）

---

安装教程​

1. 将 WarZSupplyDrop-1.0.0.jar 放入服务器 plugins 文件夹
2. 启动服务器，插件自动生成全套默认配置文件
3. 输入测试命令 /wsd spawn default here 测试空投功能
4. 使用 /wsd edit default 进入可视化编辑界面自定义奖励

---

基础玩法流程​

所有空投统一遵循六阶段生命周期：WARNING 预警 → DESCENDING 降落 → LOCKED 锁定 → OPENING 倒计时 → OPEN 可领取 → ENDING 清理
默认游玩流程：

1. 服务器全局广播空投预警，提示玩家前往拾取
2. 空投携带粒子特效缓缓降落，视觉效果极具辨识度
3. 落地后锁定保护，防止落地秒捡，增加对战博弈性
4. 玩家右键激活空投，开启倒计时，附近玩家可加速开启
5. 解锁后点击隐藏战利品格子随机领取奖励
6. 奖励领空/超时/管理员终止后，自动全量清理现场

---

全部命令​

主命令​

• /wsd spawn <id> [here|random] - 生成指定空投（当前位置/随机区域）
• /wsd stop <id|all> - 终止单个/全部活跃空投
• /wsd list - 查看当前所有运行中空投
• /wsd tp <id> - 传送到指定空投位置
• /wsd reload - 重载全部配置（无需重启服务器）
• /wsd setpos <dropId> - 保存当前坐标为空投固定落点
• /wsd wand - 获取区域选择器，划定随机刷新区域
• /wsd region add <dropId> <regionId> - 绑定随机刷新区域
• /wsd edit <dropId> - 打开GUI战利品编辑器
• /wsd web - 生成网页在线编辑临时链接
• /wsd give-summoner <玩家> <id> [数量] - 发放空投召唤信标

命令别名（全部通用）​

/supplydrop、/warzdrops、/airdrop

---

权限节点​

• warzsupplydrop.use - 玩家基础使用权限（互动、领奖）
• warzsupplydrop.admin - 管理员全权限
• warzsupplydrop.spawn - 手动生成空投权限
• warzsupplydrop.edit - GUI编辑战利品权限
• warzsupplydrop.web - 网页编辑器权限
• warzsupplydrop.summoner - 使用召唤信标权限

---

网页编辑器（特色功能）​

插件内置独立 HTTP 网页服务（默认端口8081），支持远程在线配置空投，无需反复修改服务端文件。

核心机制​

• 安全授权：5分钟一次性链接 + 30分钟会话Token，杜绝非法访问
• 自动备份：保存配置前自动备份全部空投、奖池、演出配置
• 实时生效：保存后自动重载配置，全服广播更新提示
• 全维度编辑：空投参数、奖励概率、粒子演出、刷新规则一网打尽

反向代理配置示例​

<div data-xf-p="1">web-editor:<br> enabled: true<br> host: "0.0.0.0"<br> port: 8081<br> public-host: "https://drop.example.com"</div>

---

高级粒子演出系统​

内置三套官方演出预设，无需自行编写复杂粒子参数，一键切换风格：

• supply_crate（标准军用）：简洁通用，适配绝大多数常规空投
• meteor_signal（陨石信号）：火焰、冲击波、烟火特效拉满，视觉冲击极强
• silent_cache（静默秘藏）：轻盈隐蔽特效，适合稀有高阶空投

支持自定义：降落尾迹、垂直光柱、地面脉冲环、螺旋粒子、阶段爆发、冲击波等全模块特效。

---

崩服残留自动清理​

解决绝大多数空投插件通病：服务器崩溃、强制关闭后，方块残留、浮空实体、全息残留无法清理，导致地图脏乱、卡顿掉帧。
本插件独家残留追踪机制：

1. 空投生成时自动记录原始方块与实体数据
2. 所有衍生实体添加专属标记
3. 服务器重启自动恢复地形、清理全部残留实体

---

战利品池配置特色​

• 支持 概率+权重 双机制抽奖，奖励分配更合理
• 隐藏未知补给格，点击揭秘，提升抽奖趣味性
• 支持区间数量掉落（1-3个）
• 支持自定义命令奖励，可实现点券、金币、权限、礼包等所有氪金奖励
• GUI可视化调整参数，无需手写配置文件

命令奖励示例（发放100点券）：
<div data-xf-p="1">commands:<br> - "[console] eco give %player% 100"</div>

---

PlaceholderAPI 变量​

• %warzdrops_active_count% - 当前活跃空投数量
• %warzdrops_next_time% - 下次自动空投倒计时
• %warzdrops_phase_&lt;id&gt;% - 指定空投当前阶段
• %warzdrops_time_&lt;id&gt;% - 指定空投剩余时间

---

更新日志​

2026-07-09（最新版本 1.0.0）​

• 新增完整网页在线编辑器系统
• 新增安全Token授权、自动备份、实时重载机制
• 新增网页编辑专属权限与提示配置

2026-07-05​

• 新增高级粒子演出系统+三套官方预设
• 新增崩服残留追踪、地形恢复、实体清理功能
• 升级GUI编辑器，支持概率、权重、数量可视化修改
• 新增奖励预览、命令奖励编辑功能
• 优化Folia/Paper兼容性，大幅降低卡顿

---

常见问题 FAQ​

Q：空投不显示 BossBar？
A：检查 config.yml 中 bossbar.enabled 是否为 true；Folia 服务端需手动开启 enabled-on-folia。
Q：粒子特效不显示？
A：部分高版本粒子不兼容1.12.2低版本，替换为低版本适配粒子即可。
Q：GUI修改奖励后不生效？
A：修改后关闭GUI自动保存，执行 /wsd reload 重载配置即可生效。

---

帖子最后说明​

本插件为原创商用向空投插件，专为 WarZ 末日生存服优化，功能全面、性能稳定、无垃圾冗余代码，适配各类商业服运营玩法。
后续将持续更新新特效、新玩法、拓展API，欢迎各位服主使用反馈！
如需定制专属特效、专属玩法、联动拓展，可联系作者定制！