文章目錄
Paper 是以 Spigot 為基礎的 Minecraft 伺服器，官方網站列出它對光照引擎、漏斗與實體做的效能最佳化，官方文件也把它定位成 Spigot 的直接替代品，原本的外掛不用修改就能繼續使用。從 Minecraft 26.1 起，Spigot 把地獄與終界存在和原版不同的資料夾，Paper 的遷移文件因此要求先把世界轉回原版的結構，再換上 Paper 的 jar 檔。我照這個順序把一台 Spigot 伺服器換成 Paper，三個維度的世界與外掛的資料都能被完整保留下來。
測試環境是 Windows 11 與 Java 25，Spigot 26.3 用 BuildTools 建置，Paper 是 26.3 的 build 240。Paper 26.1 起需要 Java 25，和 26.1 起的原版伺服器相同，原本執行 Spigot 26.x 的電腦不用另外安裝。
停止伺服器並備份
在 Spigot 的伺服器視窗輸入 stop，等它存檔結束，再把整個伺服器資料夾複製一份。Paper 的遷移文件寫明不支援從 Paper 轉回 Spigot，轉換後想回到原本的狀態只能靠這份備份。
把地獄與終界搬回原版位置
Paper 的遷移文件要讀者照 Spigot 的文件轉回原版，Spigot 目前沒有 26.x 的轉換說明。兩者只差在地獄與終界的位置：原版把三個維度都放在 world/dimensions/minecraft 底下，Spigot 則把地獄與終界各自拆到 world_nether 和 world_the_end 兩個資料夾。轉回原版就是把這兩個維度搬回 world 底下：
在檔案總管照下面三步操作：
- 把
world_nether/dimensions/minecraft裡的the_nether資料夾，整個搬到world/dimensions/minecraft底下。 - 把
world_the_end/dimensions/minecraft裡的the_end資料夾，也搬到world/dimensions/minecraft底下。 - 刪掉
world_nether與world_the_end，裡面剩下的level.dat與data是 Spigot 自己的紀錄，用不到。
搬完後打開 world/dimensions/minecraft，裡面應該有 overworld、the_nether、the_end 三個資料夾。
換成 Paper 並啟動
換成 Paper 只要換掉伺服器資料夾裡的 jar 檔，世界、plugins 資料夾與啟動指令都不用動。Paper 的遷移文件要求把 Paper 的 jar 改成啟動指令裡的檔名：
- 從 Paper 下載頁下載和 Spigot 相同 Minecraft 版本的 Paper，檔名類似
paper-26.3-240.jar。 - 刪掉伺服器資料夾裡原本的 Spigot jar，例如
spigot-26.3.jar。 - 把下載的 Paper 放進伺服器資料夾，改成剛才刪掉的檔名。
接著照原本的方式啟動伺服器，例如雙擊 start.bat。Paper 第一次啟動時會發現世界要轉換，先印出 ALERT 警告並倒數 30 秒：
這段警告提醒沒有備份的人在倒數結束前中斷。前面已經備份，就等它倒數完，Paper 會轉換三個維度的資料夾並繼續啟動，看到 Done 就啟動完成。之後再啟動就不會出現這段警告。
確認轉換結果
在伺服器視窗輸入 version 與 plugins，或用 op 身分在遊戲裡輸入 /version 與 /plugins。版本那行顯示 This server is running Paper version，外掛清單和 Spigot 時相同，再進地獄與終界看原本的建築還在，就代表轉換完成。
實測紀錄
轉換前，我在 Spigot 26.3 伺服器裝了 LuckPerms 5.5.71 與 EssentialsX 2.22.0，用 LuckPerms 建立一個 vip 群組，並在三個維度的同一個座標各放一塊方塊：主世界放鑽石磚、地獄放金磚、終界放綠寶石磚。照上面的步驟換成 Paper 26.3 後，這些資料都還在：
| 項目 | 結果 |
|---|---|
| 三個維度的方塊 | 鑽石磚、金磚、綠寶石磚都在原位 |
| LuckPerms 群組 | vip 群組還在 |
| 外掛清單 | Essentials 與 LuckPerms 兩個都有啟用 |
| 第一次啟動 | 約 39 秒，包含 30 秒的警告等待 |
| 之後的啟動 | 約 9 秒，不再出現警告 |
進遊戲輸入 /version 與 /plugins 的結果如下，伺服器已經是 Paper 的最新 build：
EssentialsX 在外掛清單裡顯示為 Essentials。EssentialsX 2.22.0 的支援版本只到 26.1.2，在 Spigot 與 Paper 26.3 啟動時都會印出 ERROR 等級的 [Essentials] You are running an unsupported server version!，實測仍照常啟用。
總結
Spigot 換成 Paper 前，要先把地獄與終界搬回原版的位置，再換上 Paper 的 jar 檔。實測 Spigot 26.3 換成 Paper 26.3 後，三個維度的方塊、LuckPerms 的群組與兩個外掛都保留下來。Paper 的遷移文件寫明不支援轉回 Spigot。
