minecraft-alias

Minecraft Java Edition (Spigot/Paper 1.20+) 用の軽量プラグインで、任意のコマンドにシンプルなエイリアスを設定できます。

✨ 主な機能

• /alias add <exec_command> by <alias_command> でエイリアス登録
• /alias list [page] で 10 件ごとのページ表示
• /alias remove <alias_command> で削除
• エイリアス実行時に元コマンドを自動実行。追加の引数も自動的に引き渡し
• OP または minecraftalias.admin 権限を持つプレイヤーのみが管理

⚙️ 動作環境

• Java 17+
• Spigot / Paper 1.20.1 互換サーバー

🧱 ビルド方法

mvn clean package

target/minecraft-alias.jar をサーバーの plugins/ に配置し、サーバーを再起動してください。

📋 コマンド一覧

コマンド	説明
/alias add <exec_command> by <alias_command>	/alias_command を実行すると /<exec_command> が実行されるように登録します
/alias remove <alias_command>	登録済みエイリアスを削除します
/alias list [page]	登録済みエイリアスをページ表示します (1 ページ 10 件)

例: /alias add gamemode creative by gm 1 → /gm 1 で /gamemode creative が実行されます。

/<alias> に続けて入力した追加引数は、そのまま元コマンドへ連結されます。

削除時も同じ区切りで指定できます。/alias remove gm 1 のように入力してください。

🗂️ 設定ファイル

plugins/MinecraftAlias/config.yml

aliases:
  gm 1: gamemode creative

ゲーム内で登録・削除したエイリアスが自動で反映されます。

🚀 開発

サーバーの準備

https://papermc.io/downloads から paper を選択し、Paper x.x.xをダウンロードする。 ダウンロードした.jarファイルを以下のコマンドで実行する。

java -Xmx2G -jar paper-1.21.8-60.jar nogui

初回実行時、同ディレクトリに eula.txtが作成されるので、内容を以下に変更して保存する。

eula=true

再度サーバーを起動する。Done! と表示されればOK。

java -Xmx2G -jar paper-1.21.8-60.jar nogui

.jarファイルのビルド

以下のコマンドでjava-17を選択する。

sudo update-alternatives --config java

以下のコマンドで.jarファイルをビルドする。

mvn clean package

pluginの導入

サーバーのpluginsフォルダに既に.jarファイルがあれば削除する。

rm -rf ./minecraft-alias-1.0.0-SNAPSHOT.jar

ビルドした.jarファイルを配置する。(↓コマンドの例)

mv ~/minecraft/minecraft-alias/target/minecraft-alias-1.0.0-SNAPSHOT.jar .

サーバーの起動

.jarファイルを最初に実行したときのjavaのバージョンに変更する(例 java-21)

sudo update-alternatives --config java

以下のコマンドでサーバーを起動する。

java -Xmx2G -jar paper-1.21.8-60.jar nogui

サーバーに入る

Ubuntu上で以下のコマンドを実行する。

ip addr show eth0

inet の値を確認する。 サーバーアドレスを <inet の値>:25565 とすればサーバーに接続できる。