ガイド

Spigotプラグインの作り方

2026年10月7日に更新

SpigotプラグインはBukkit/Spigot APIを使うので、Spigotと、Paperを含むそのすべてのフォークで動きます。プラグインがどこで動くか分からないときには、最も幅広い選択肢です。このガイドでは、プロジェクト、コード、ビルドを説明します。

例を、自分のサーバーに合わせて変更してください。

Codexeでこれを生成

手順

  1. 1.Javaとビルドツールを用意する

    Minecraftのバージョンに合ったJDK(17、21、25)をインストールし、MavenまたはGradleを使います。

  2. 2.Spigot APIを追加する

    Spigotのリポジトリから、バージョンに合ったspigot-apiをprovidedスコープで追加します。コンパイルにだけ必要で、実行時にはサーバーが提供します。

  3. 3.コマンドとリスナーを書く

    getCommand("name").setExecutor(...)でCommandExecutorを登録し、registerEventsでイベントリスナーを登録します。

  4. 4.plugin.ymlを書く

    名前、バージョン、メインクラス、api-version(1.13以降)、コマンド、権限。

  5. 5.ビルドしてインストールする

    mvn packageを実行し、target/の.jarをサーバーのplugins/フォルダにコピーして、再起動します。

古いバージョン(1.8〜1.12)

多くのミニゲームサーバーは、今も1.8で動いています。APIが古く(api-versionがなく、マテリアル名も異なります)、1.21のチュートリアルからコピーするのではなく、そのバージョン向けにプラグインを書く必要があります。Codexeはバージョンを尋ね、そのAPI向けにコードを書きます。

Codexeで

プラグインを説明し、「Spigot」とバージョンを書いてください。CodexeがMavenプロジェクトを生成し、コンパイルし、エラーを修正して、ダウンロードの前に、そのバージョンのテストサーバーでテストできるようにします。

よくある質問

BuildToolsは必要ですか?

Spigotサーバーを動かす場合や、NMS(サーバー内部のコード)を使う場合だけです。通常のAPIに対してコンパイルするだけなら、spigot-apiの依存関係で十分です。

SpigotプラグインとPaperプラグインのどちらですか?

どこでも動かす必要があるならSpigot、サーバーがPaperで追加のAPIを使いたいならPaperです。Paperプラグインの作り方をご覧ください。

Spigotプラグインを作る

このプロンプトは、そのまま送信できる状態で開きます:

“Kitsという名前のSpigot 1.8.8プラグイン: /kit <name>で設定したアイテムセットを渡し、キットごとにクールダウンがある。キットはconfig.ymlで定義し、キットごとに権限kits.<name>があり、クールダウンは再起動しても保存される。”

Codexeでこれを生成
Spigotプラグインの作り方: セットアップ、コード、ビルド | Codexe