プラグインとAPIバージョンの互換性

プラグインは特定のサーバーAPIバージョン向けにビルドされています。バージョンが一致しない場合、読み込みに失敗するか、動作中にエラーが発生します。

互換性を決める要素

• ゲームバージョン。 1.20 向けのプラグインは通常 1.21 では動作しません。内部クラスが変更されているためです。
• コア。 Bukkit/Spigot/Paper は「下位から上位へ」の互換性があります。Bukkit プラグインは Paper で動作しますが、Paper 固有の API を使用している場合はその逆は成り立ちません。
• 依存関係。 Vault、PlaceholderAPI、ProtocolLib もバージョンを一致させる必要があります。

api-version

プラグインの plugin.yml には次のように記述します。

api-version: 1.21

この行が完全に欠けている場合、サーバーはプラグインをレガシーとして扱い、互換モードを有効にします。ログに警告が表示されます。これはエラーではなく、古いプラグインであることを示すサインです。

よくある症状

インストール前の確認

コントロールパネルの「プラグインとMOD」カタログは、お使いのコアとバージョンで絞り込み、インストール前に非互換性を警告します — インストール方法。手動でアップロードする場合は、プラグインのページを確認してください。対応バージョンの範囲が必ず記載されています。