最速で作るKotlin Minecraft Plugin開発 A-2 環境構築

Last updated at 2024-08-01Posted at 2024-08-01

概要

プラグインの作成
Kotlinプロジェクト変換
Paperサーバー準備 + 必要最低限のプラグインを準備
更新スクリプトの作成
結

プラグインの作成

場所: 作ったプラグインをどこかデスクトップなどでまとめて置けるように、分かりやすいところに置きましょう。
Main Classがcom.github.<あなたのID>で始まっていることを確認してください。
Group IDがcom.github.<あなたのID>であることを確認してください。

Minecraft Version	JDK Version
1.12 ~ 1.16.5	8(11も可)
1.17 ~ 1.17.1	16
1.18 ~ 1.20.4	Java 17
1.20.5 ~	Java 21

JDKがインストールされてない場合 JDK > JDKをダウンロード > バージョン「上記」 > ベンダー「Amazon Corretto、JetBrains Runtime、Oracle JDKあたりを選んでおけばよいです」

可能であればサーバーは常にLTSの最新版で動かし、プラグインもそれに合わせる形が良いので、21でそろえるのが望ましいのですが、今回の所は確実に動くことを最優先として上記のバージョン表に従ってください。
後々JDKバージョンが分かってきたら最新のものを選んでもよいと思います。

Javaのバージョンに関する詳細

Kotlinプロジェクト変換

src > main > java > GroupId.ArtifactId > <メインクラス> (この場合はExamplePlugin)
メインクラスを右クリックし、「JavaファイルをKotlinファイルに変換」

OK、プロジェクトでKotlinを構成します > OK

gradle.buildが開かれ、画像の記述が追加されたことを確認し、右上のGradleアイコンをクリック(またはCtrl + Shift + O)

plugins {

    id "com.github.johnrengelman.shadow" version "8.1.1"

}

plugins内に「id "com.github.johnrengelman.shadow" version "バージョン"」を追記
https://plugins.gradle.org/plugin/com.github.johnrengelman.shadow
上記のサイトから最新バージョンを入力してください(執筆時は8.1.1)

再び右上のGradleアイコンをクリック(またはCtrl + Shift + O)

再び「JavaファイルをKotlinファイルに変換」をクリックしてください。

src > main > java > 右クリック > リファクタリング > 名前の変更
java -> kotlinに名前を変更してください

最終的にこうなれば完了です。

Paperサーバーの準備 + 必要最低限のプラグインを準備

Paper サーバーを準備してください

サーバーの建て方が分からない際は揚げたてのポテトさんの記事が分かりやすく、オススメです。

ポート開放のステップはスキップしていただいて構いません。

必要最低限のプラグインを準備

下記二つのプラグインをpluginsフォルダーに入れ、導入してください

更新スクリプトの作成

デフォルトのターミナルをGit Bashに変更

設定を開く

「ターミナル」で設定内を検索 > シェルパス > bash.exeで終わっているものを選択します
Windowsの方はデフォルトであれば画像通りに
Macの方は「/bin/bash」になるかなと思います。

右上のほうの実行ボタン左のドロップダウンメニュー > 実行構成の編集

Gradle

RunにshadowJarを入力

一度戻り
プロジェクト名 > 右クリック > 新規 > ファイル > replace.sh

shadowJarを一度実行

-all.jarで終わるjarファイルが作成されていることを確認し、絶対パスのコピー

先ほど作成したreplace.shを開き、中身に下記を記述

ビルド成果物パス -> 先ほどコピーしたもの
サーバーのpluginsフォルダのパス -> エクスプローラーなどでpluginsフォルダを右クリックし、「パスのコピー」などでしてください。

Windows環境の方はパスの区切り文字を「\」から「/」へと変えてください。Ctrl + Rなどで一括置換すると便利です。

cp -f "<ビルド成果物のパス>" "<サーバーのpluginsフォルダのパス>"
rm "<ビルド成果物のパス>"

ダブルクオーテーションは念のため消さないことをオススメします。

私の環境では最終的にこうなりました

cp -f "C:/Users/atsuk/Desktop/IntelliJ IDEA/ExamplePlugin/build/libs/ExamplePlugin-1.0.0-all.jar" "C:/Users/atsuk/Desktop/Server/plugins"
rm "C:/Users/atsuk/Desktop/IntelliJ IDEA/ExamplePlugin/build/libs/ExamplePlugin-1.0.0-all.jar"

再び + > Shell Script