Paper Disposable World

目的

小遊戲與決鬥需要用完就丟的世界，或每場結束要還原的競技場。提供「換世界」與「就地還原」兩條路線；世界操作一律在主執行緒，只有檔案 IO（複製、刪除）在非同步。

---

平台需求

• Paper 1.21.11 / 26.2（兩版皆經編譯驗證）
• 純 Paper API，不需要 Paperweight
• GameRule 舊常數已棄用，範本改以 Registry.GAME_RULE 的 snake_case key 查詢（兩版相同）

---

產生的代碼

VoidChunkGenerator.java

public final class VoidChunkGenerator extends ChunkGenerator {
    @Override public boolean shouldGenerateNoise() { return false; }
    @Override public boolean shouldGenerateSurface() { return false; }
    // ... Bedrock / Caves / Decorations / Mobs / Structures 同樣回 false
    @Override
    public Location getFixedSpawnLocation(World world, Random random) {
        return new Location(world, 0.5, 64.0, 0.5);
    }
}

建立與守衛（DisposableWorlds）

// 資料夾已存在就拒絕：WorldCreator 會把殘缺資料夾當新世界默默生成地形
World world = WorldCreator.name(name)
        .generator(generator)
        .generateStructures(false)
        .keepSpawnLoaded(TriState.FALSE)
        .createWorld();
rules.apply(world);   // 建立後立刻套用遊戲規則

複製模板與刪除（WorldFolders，非同步）

// 複製：略過 uid.dat、session.lock；level.dat 最後才寫
// 刪除：level.dat 最後才刪，半刪的資料夾不會被誤認為世界
WorldFolders.copyTemplate(template, target);
WorldFolders.deleteWorld(folder);

就地還原（ChangeRecorder + ArenaResetService）

// 記錄每格第一次被改之前的 BlockData；還原時每 tick 受方塊數與時間預算限制
cells.putIfAbsent(block.getBlockKey(), block.getBlockData());
block.setBlockData(original, false);
sweeper.sweepAll(world);   // 掉落物、箭、TNT 礦車、水晶等殘留實體

---

執行緒安全

• 世界建立／卸載、方塊與實體操作只在主執行緒
• 只有 WorldFolders 的複製與刪除在非同步；lambda 只攜帶 Path / String
• 回傳的 future 一律在主執行緒完成；onDisable 用 closeAllSync() 同步收尾
• 大量方塊（數十萬格）的 NMS 快速路徑見 nms-chunk-access