FAWEReplace
简介
FAWEReplace 是一款高性能的 Paper 插件,专为大规模 Minecraft 世界清理任务而设计。基于 FastAsyncWorldEdit (FAWE) 的异步处理能力,它能高效地处理批量方块替换和实体移除操作。
前置依赖
FastAsyncWorldEdit (FAWE)
教程
命令
- 开始/继续清理:
/frl start - 开始新的清理任务:
/frl start --fresh - 停止清理:
/frl stop - 检查清理进度:
/frl status - 帮助教程:
/frl help - 重载配置:
/frl reload
配置
language: zh_CN # 或 en_US
# 目标区域坐标
world: "world"
target:
start:
x: -1000
z: -1000
# y: -64 # 可选:如果未设置,将自动使用完整的世界高度
end:
x: 1000
z: 1000
# y: 320 # 可选:如果未设置,将自动使用完整的世界高度
# 插件启用时自动开始
# !警告:建议保持为 false,手动启动更安全
confirm: false
# 性能配置
# 并行处理线程数
# !重要:请根据您的使用情况选择合适的值
#
# 在线服务器(有玩家在线):
# - 2GB 内存:1-2 个线程
# - 4GB 内存:2-3 个线程
# - 5GB 内存:2-3 个线程(推荐:2)
# - 8GB+ 内存:3-5 个线程
#
# 离线处理(最大性能):
# - 4GB 内存:4-6 个线程
# - 5GB 内存:6-8 个线程
# - 8GB 内存:8-12 个线程
# - 16GB+ 内存:12-16 个线程
#
parallel: 2
# 区域/图块大小
# 每个工作线程处理的区域大小
# 数值越大 = 图块数量越少,但每个图块的处理时间越长
region:
x: 512
z: 512
# y: 256 # 可选:如果未设置,将自动计算
# 处理模式
# 分块模式
# 启用后,会将大区域分割成较小的图块以进行并行处理
tiling:
enabled: true
# 快速模式
# 使用 FAWE 的快速异步处理功能
fast-mode: true
# 进度日志频率
# 每处理 N 个图块输出一次进度日志
# 提示:
# - 在线服务器:50-100(更详细的进度反馈)
# - 离线处理:100-200(减少日志开销)
progress-log-every: 100
# 安全选项
# 跳过未生成的区块
# 强烈建议保持启用
#
# 特性:
# - 仅处理玩家访问过的区块
# - 避免生成新的空区块
# - 防止出现高度图警告
# - 提升性能
#
skip-ungenerated-chunks: true
# 自动修复区块高度图
# 建议在 MCA Selector 中防止出现黑色区块
#
# 特性:
# - 在方块替换后自动刷新高度图
# - 防止在 MCA Selector 中出现黑色区块
# - 对性能影响极小
auto-fix-heightmap: true
# 内存保护
# 防止 OutOfMemoryError 崩溃
memory-protection:
# 启用自动内存监控
# 推荐:在线服务器必须启用
# 离线处理:可禁用以获得最大速度(但存在崩溃风险)
enabled: true
# 最低可用内存百分比 (0.0-1.0)
# 当可用内存低于此值时暂停处理
#
# !推荐值:
# 在线服务器:0.20-0.25 (20-25%,更安全)
# 离线处理:0.10-0.15 (10-15%,激进)
min-free-memory-percent: 0.20
# 内存不足时的等待时间(毫秒)
# !推荐值:
# 在线服务器:5000 (5秒)
# 离线处理:2000-3000 (2-3秒)
wait-on-low-memory-ms: 5000
# 内存持续不足时的最大重试次数
# 设置为 -1 表示无限重试(不推荐)
max-memory-retries: 10
# 性能节流
# 在操作之间添加延迟以减少服务器负载
# !重要提示:
# 有玩家在线的服务器:使用适度延迟
# 离线处理:将所有值设为 0 以获得最大速度(提升 10-40%!)
performance:
# 区块处理批次之间的延迟(毫秒)
# 推荐值:
# 离线模式:0(最大速度 / max speed)
# 轻度在线:50-100
# 重度在线:100-200
delay-between-batches-ms: 100
# 单个区块操作之间的延迟(毫秒)
# 推荐值:
# 离线模式:0(最大速度)
# 在线模式:10-20
delay-between-chunks-ms: 20
# 强制垃圾回收频率
# 每处理 N 个区块执行一次 GC
# 推荐值:
# 离线模式:0(由 JVM 自动管理,速度最快)
# 内存问题:100-200
# !注意:通常 0 是最佳选择,JVM 的 GC 优化效率更高
gc-every-chunks: 50
# 存档/检查点系统
# 保存进度以便在中断后恢复
resume:
# 启用存档/检查点功能
# 建议:保持启用状态
enabled: true
# 进度文件名
# 保存在插件数据文件夹中
file: "progress.yml"
# 保存频率
# 每处理 N 个区块保存一次进度
# 推荐值:
# - 在线服务器:25(更频繁地保存)
# - 离线处理:100(减少 I/O 开销)
save-every: 25
# 方块替换规则
# 定义要替换的方块类型
# 重要警告:
# X 不要替换常见的建筑方块(如 STONE、DIRT、WOOD 等)
# O 仅替换你想要清理的方块(容器、机器等)
#
# 格式:
# - origin: <Bukkit 材质名称>
# target: <目标方块,通常为 AIR>
#
# 完整材质列表:
# https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/Material.html
方块:
- 来源:SHULKER_BOX(潜影盒)
目标:AIR(空气)
- 来源:YELLOW_SHULKER_BOX(黄色潜影盒)
目标:AIR(空气)
- 来源:GREEN_SHULKER_BOX(绿色潜影盒)
目标:AIR(空气)
- 来源:PURPLE_SHULKER_BOX(紫色潜影盒)
目标:AIR(空气)
- 来源:DISPENSER(发射器)
目标:AIR(空气)
- 来源:ORANGE_SHULKER_BOX(橙色潜影盒)
目标:AIR(空气)
- 来源:FURNACE(熔炉)
目标:AIR(空气)
- 来源:BLACK_SHULKER_BOX(黑色潜影盒)
目标:AIR(空气)
- 来源:LIME_SHULKER_BOX(亮绿色潜影盒)
目标:AIR(空气)
- 来源:HOPPER(漏斗)
目标:AIR(空气)
- 来源:GRAY_SHULKER_BOX(灰色潜影盒)
目标:AIR(空气)
- 来源:RED_SHULKER_BOX(红色潜影盒)
目标:AIR(空气)
- 来源:LIGHT_BLUE_SHULKER_BOX(淡蓝色潜影盒)
目标:AIR(空气)
- 来源:BREWING_STAND(酿造台)
目标:AIR(空气)
- 来源:BROWN_SHULKER_BOX(棕色潜影盒)
目标:AIR(空气)
- 来源:BARREL(木桶)
目标:AIR(空气)
- 来源:CAMPFIRE(营火)
目标:AIR(空气)
- 来源:LIGHT_GRAY_SHULKER_BOX(浅灰色潜影盒)
目标:AIR(空气)
- 来源:TRAPPED_CHEST(陷阱箱)
目标:AIR(空气)
- 来源:DROPPER(投掷器)
目标:AIR(空气)
- 来源:WHITE_SHULKER_BOX(白色潜影盒)
目标:AIR(空气)
- 来源:CHEST(箱子)
目标:AIR(空气)
- 来源:SOUL_CAMPFIRE(灵魂营火)
目标:AIR(空气)
- 来源:BLUE_SHULKER_BOX(蓝色潜影盒)
目标:AIR(空气)
- 来源:MAGENTA_SHULKER_BOX(品红色潜影盒)
目标:AIR(空气)
- 来源:PINK_SHULKER_BOX(粉色潜影盒)
目标:AIR(空气)
- 来源:CYAN_SHULKER_BOX(青色潜影盒)
目标:AIR(空气)
- 来源:BLAST_FURNACE(高炉)
目标:AIR(空气)
- 来源:SMOKER(烟熏炉)
目标:AIR(空气)
# 实体清理
# 移除指定的实体类型
# !注意:
# - 请谨慎使用!可能会移除玩家的物品、怪物等。
# - 建议先在测试服务器上测试
实体:
# 启用实体清理
enabled: false
# 完整列表:
# https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/entity/EntityType.html
#
types: []
# 示例:
# - ITEM # 移除掉落物
# - ZOMBIE # 移除僵尸
# - ARMOR_STAND # 移除盔甲架
你是这个资源的作者?登录后可认领此资源。
相似资源
ExyliaLib
ExyliaServices
ExyliaPlugins 的库。
前置实用
26
Vessel
muhdfdeen
重新定义服务器上的生物运输方式。使用高度可定制的口袋道具,安全地捕获、存储和释放任何实体。
生物存储
13
WorldEdit
me4502
一个在游戏内运行的 Minecraft 地图编辑器! 支持选区、蓝图、复制粘贴、笔刷和脚本。 可在创造模式中使用,也可在生存模式中临时使用。
前置管理
10
LobbyAPI
Zombie_Striker_Dev
创建用户友好的菜单以前往不同的世界
管理交通
9
tkChat
tkkr
专为 Velocity 打造的自制聊天插件,功能丰富——支持跨服群组/全局/私聊消息,并集成 LibertyBans 的禁言功能。
管理社交
9
Yeth's TPA
yethdev
一个高度兼容、功能完善且稳定的 TPA 模组
社交交通
9
评论 0
登录后参与评分
还没有评论,来抢沙发吧