- 版权类型
- 原创
- 插件中文名称
- WarZChestScatter
- 插件英文名称
- WarZChestScatter
- 原帖地址
- #
- 支持的核心(服务端)
- Spigot
- Paper
- Purpur
- PufferFish
- Leaves
- 其他核心
- 语言支持
- 中文(简体)
- 适配版本(Java)
- 1.21
- 1.20

WIki
https://www.yuque.com/daqingtian-3ob8x/warz/skkvcn1vrervelhv?singleDoc#
《WarZChestScatter - 随机放置物资箱插件》
【1.20+】WarZChestScatter - 战争区域物资箱随机散布插件
插件介绍
WarZChestScatter 是专为末日 / 战争 / 搜打撤类服务器设计的高性能物资箱随机散布插件。
管理员只需一条命令,即可在指定区域内批量随机生成箱子,自动落地、过滤非法地面、控制最小间距,支持异步计算与分批放置,大量生成也不会卡顿。
特别适合:
管理员只需一条命令,即可在指定区域内批量随机生成箱子,自动落地、过滤非法地面、控制最小间距,支持异步计算与分批放置,大量生成也不会卡顿。
特别适合:
- 末日搜打撤服务器
- 战争区域玩法
- 大型生存活动
- 赛季物资刷新系统
- 副本物资投放
⚙ 运行环境
项目 | 要求 |
|---|---|
服务端 | Spigot / Paper / Mohist 1.20+ |
Java | 17+ |
推荐环境 | Mohist 1.20.1 |
核心特性
一键部署
一条命令批量随机生成箱子,无需手动摆放。
自动落地
自动检测最高方块,保证箱子贴地生成,不悬空。
非法地面过滤
自动过滤:
- 水
- 岩浆
- 树叶
- 空气
- 屏障
- 基岩
- 等非法地面
支持关键字:
LEAVES自动展开所有树叶LOGS自动展开所有原木
最小间距控制
可设置箱子之间的最小距离,防止过于密集堆叠。
异步无卡顿设计
采用:
- 异步坐标计算
- 主线程分批放置
- 每 tick 控制放置数量
实测 500 个箱子几乎无感。
一键撤回
支持:
- 批量撤回本次部署
- 已被玩家破坏的自动跳过
- 服务器重启后仍可撤回
持久化记录
部署记录自动写入
重启后:
data.yml重启后:
- 可继续 rollback
- 不丢数据
命令说明
主命令:
别名:
代码:
/wzcs
代码:
/chestscatter
/scatter
命令 | 说明 | 权限 |
|---|---|---|
/wzcs deploy | 开始部署 | warz.scatter.deploy |
/wzcs rollback | 撤回部署 | warz.scatter.rollback |
/wzcs reload | 重载配置 | warz.scatter.reload |
默认仅 OP 可用。
🛠 配置示例
代码:
# WarZChestScatter 配置文件
# 生成区域设置
region:
# 目标世界名称
world: world
# X 轴范围
minX: -500
maxX: 500
# Z 轴范围
minZ: -500
maxZ: 500
# 散布参数
scatter:
# 目标生成数量
amount: 500
# 箱子之间的最小平面距离(格)
min-distance: 10
# 每个箱子最多尝试次数,超过则放弃
max-tries-per-chest: 100
# 每 tick 放置的箱子数量(防卡顿)
per-tick: 5
# 放置的方块类型
block:
type: CHEST
# 非法地面方块列表(落在这些方块上方则跳过)
illegal-ground:
- WATER
- LAVA
- LEAVES
- AIR
- BEDROCK
- BARRIER
- VOID_AIR
- CAVE_AIR
全部参数支持高度自定义。
性能参考
数量 | 推荐 per-tick | 放置时间 | 服务器影响 |
|---|---|---|---|
50 | 5 | ~2秒 | 无感 |
200 | 10 | ~4秒 | 无感 |
500 | 10-20 | ~5-10秒 | 无感 |
1000+ | 20 | ~10-20秒 | 极轻微 |
采用异步算法,不卡主线程。
使用流程
- 修改 config.yml
- 执行
/wzcs reload - 执行
/wzcs deploy - 需要移除时
/wzcs rollback
同一时间仅支持一组未撤回部署。
常见问题
Q:生成数量少于目标数量?
A:区域合法位置不足或最小间距过大,建议扩大区域或降低 min-distance。
Q:箱子生成在树顶?
A:添加
Q:/cs 冲突?
A:使用
Q:重启后还能撤回吗?
A:可以,数据自动恢复。
A:区域合法位置不足或最小间距过大,建议扩大区域或降低 min-distance。
Q:箱子生成在树顶?
A:添加
LEAVES 到 illegal-ground。Q:/cs 冲突?
A:使用
/wzcs 或 /scatter。Q:重启后还能撤回吗?
A:可以,数据自动恢复。
适用玩法展示
- 末日地图物资刷新
- 战争区域补给投放
- 限时活动物资散布
- 赛季重置刷新点
- PVP 战场随机补给
联系方式
- 技术交流群:398893720
- 末日服务器交流群:1063544727
- 定制开发:QQ 1285988665
支持作者:
https://afdian.com/a/sunjood
https://afdian.com/a/sunjood
WarZChestScatter v1.0.0
战争服务器必备物资散布系统