UPGRADING.md

升級說明

通用流程

1. 在面板內停止所有 Minecraft 伺服器。
2. 關閉 BlockPilotMC。
3. 備份 .env、runtime 與 Server。
4. 取得新版本原始碼或更新包。
5. 重新安裝平台相依套件並建置。
6. 啟動面板並檢查 /api/health。
7. 瀏覽器使用 Ctrl+F5 清除舊前端快取。

systemd 升級

在新版本專案根目錄執行：

chmod +x scripts/install-systemd.sh
sudo ./scripts/install-systemd.sh

安裝程式會停止既有服務、更新程式碼、重新執行 npm ci 與 npm run build，並保留：

/opt/blockpilot/.env
/opt/blockpilot/runtime
/opt/blockpilot/Server

升級後確認：

sudo systemctl status blockpilot
sudo journalctl -u blockpilot -n 80 --no-pager

直接執行的原始碼升級

請先進入含有 package.json 的專案根目錄：

npm ci
npm run build
./start-linux.sh

跨平台搬移

Windows 與 Linux 的原生 npm 套件不可共用：

rm -rf node_modules
npm ci

start-linux.sh 也會檢查平台識別，發現不同平台的 node_modules 時會重新安裝。

JWT 與登入

保留 runtime/security 可維持既有 JWT 金鑰。若移除該目錄，既有登入權杖會失效，但帳號、世界存檔與伺服器設定不會消失。