PaperMCに自動アップデート機能はない？スクリプトで解決する方法

マイクラサーバーのアップデートってかなり面倒ですよね。

手動でJARファイルをダウンロード
サーバーを再起動する

この2つのステップだけですが、できるだけ自動化したいもの。

しかし、PaperMCを自動的にアップデートする方法は、公式には用意されていないんです。

この記事では、PaperMCの配布APIを使って、最新版のPaperを自動でダウンロードするスクリプトを紹介します。

あとはファイルを差し替えて再起動するだけ。更新作業を少しでも自動化したい人におすすめです。

結論：自動アップデート機能はない

結論ですが、PaperMCを自動的にアップデートする方法は提供されていません。

PaperMCをアップデートするには、

手動でJARファイルをダウンロード
サーバーを再起動する

この2つのステップが必要になります。

少し手間がかかりますが、PaperMCプラグインとの互換性もあるので、公式的には提供されていないのでしょう。

PaperMCの自動更新フロー。最新版確認、旧JAR退避、新JAR取得、起動確認、ロールバックの順に処理する流れを示す図解

最新版を自動ダウンロードするためのスクリプト

ただ、アップデートを手動でやるのが手間だと思う人もいると思います。

そんな人のために、PaperMCのAPIを利用した、自動ダウンロードできるスクリプトを用意しました。

バージョンを指定するだけで、自動でそのバージョンの最新版を取得してくれますよ。

「get-paper-latest.bat」のように、バッチファイルで保存して使ってみてください！

スクリプトはWindows限定です。

@echo off
REM ==== ここで使いたい Paper の version を指定 ====
set "VERSION=1.21.10"

echo Paper %VERSION% の最新ビルド番号を取得中...

REM PowerShellで API を叩いて、builds の最大値（最新ビルド）を取得
for /f "delims=" %%A in ('
  powershell -NoLogo -NoProfile -Command ^
    "(Invoke-RestMethod -Uri \"https://api.papermc.io/v2/projects/paper/versions/%VERSION%\" ).builds | Measure-Object -Maximum | Select-Object -ExpandProperty Maximum"
') do set "BUILD=%%A"

echo 最新ビルド: %BUILD%

REM ダウンロードURLを組み立て
set "URL=https://api.papermc.io/v2/projects/paper/versions/%VERSION%/builds/%BUILD%/downloads/paper-%VERSION%-%BUILD%.jar"

echo ダウンロードURL:
echo   %URL%

REM jar ファイル名（保存先ファイル名）
set "FILENAME=paper-%VERSION%-%BUILD%.jar"

echo ダウンロード中...
curl -L "%URL%" -o "%FILENAME%"

echo 完了: %FILENAME%
pause