如何避免Spigot Watchdog Thread终止服务器及实现大量方块放置

方案1：临时关闭Watchdog检测（仅适合本地开发测试） #

如果你确实可以接受服务器短时间无响应，只需要修改服务端根目录下的spigot.yml配置即可避免进程被终止：
找到settings配置段下的timeout-time项，将默认值60（单位为秒）修改为-1即可完全关闭Watchdog检测，也可以调整为大于你预估的卡顿时长的数值（例如300），方块放置完成后再改回默认值即可。
注意：该方案绝对不要用于公开生产服务器，否则服务器真的出现崩溃时无法自动重启，会大幅延长故障时间。

方案2：分批次同步放置方块（推荐全场景使用） #

该方案不需要修改服务端配置，也不会导致服务器长时间无响应，是生产环境的最优解：
将数千个方块的放置任务拆分为多个小批次，每服务器Tick（1/20秒）只放置固定数量的方块，避免长时间占用主线程触发Watchdog告警。
你可以使用Bukkit自带的调度器实现该逻辑，示例代码如下：

import org.bukkit.scheduler.BukkitRunnable;
import java.util.List;

// 你需要提前组装好待放置的方块数据列表，示例结构为List<BlockPlaceData>
// BlockPlaceData可自定义，至少包含位置location、方块类型material两个属性
public void batchPlaceBlocks(List<BlockPlaceData> blockList, int batchPerTick) {
    new BukkitRunnable() {
        int index = 0;
        final int total = blockList.size();
        @Override
        public void run() {
            // 计算当前批次的结束下标，避免越界
            int end = Math.min(index + batchPerTick, total);
            for (int i = index; i < end; i++) {
                BlockPlaceData data = blockList.get(i);
                // 第二个参数设为false关闭物理更新，大幅提升放置速度
                data.getLocation().getBlock().setType(data.getMaterial(), false);
            }
            index = end;
            // 所有方块放置完成后终止调度任务
            if (index >= total) {
                this.cancel();
                // 此处可添加放置完成后的回调逻辑
            }
        }
    }.runTaskTimer(yourPluginInstance, 0L, 1L); // 0 Tick后开始执行，每1 Tick执行一次
}

// 调用示例：每Tick放置100个方块，可根据服务器性能调整该数值
batchPlaceBlocks(yourBlockList, 100);

可选性能优化点 #

• 若你需要修改的方块属于同一个或少数几个区块，可以直接操作NMS层的区块对象写入方块数据，性能比单个setType调用高10倍以上
• 如果不需要即时显示方块更新，可以批量放置完成后再统一触发区块刷新，进一步降低性能开销

异步操作说明 #

Spigot所有世界、方块相关的API都不是线程安全的，服务端内置了线程安全检查，异步调用方块操作必然触发报错，严重时还会导致世界数据损坏，不要尝试绕开该限制。

内容的提问来源于stack exchange，提问作者PewDiePew