FAWEReplace

插件

· 作者 angushushu

使用 FAWE API 替换大区域中的方块和实体。

0 本站下载 0 关注 更新于 9 个月前

最新 1.0.4 · 1.21.11 · Bukkit / Paper

一键开服(送7天)

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   # 移除盔甲架

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源