Minecraftプラグイン BlueSlimeCore

🔌 BlueSlimeCore について

BlueSlimeCore は、他のプラグインの共通基盤として使うことを目的とした、ライブラリ型の Minecraft プラグインです。サーバー向けのユーティリティコマンドと、よくある作業（設定、言語/メッセージ、メニュー、アイテムビルダー、バージョン処理）を簡単にする開発者向け API をまとめており、作者は複数のプラグイン間で機能を再利用できます。

🎯 目的

このプラグインは、一般的なプラグイン基盤の重複を解消します。設定管理、言語管理、メニュー作成、マルチバージョン互換の補助、そして少数の管理用ユーティリティコマンドを一元化することで、依存するプラグインは定型コードではなく機能開発に集中できます。

⚙️ 機能

• 設定と言語管理のための開発者向け API（プレイヤーごとの言語サポート、MiniMessage、PlaceholderAPI）。
• インベントリ、ボタン、ページ式メニューを作成するためのメニュー API。
• アイテム、革の防具、ポーション、プレイヤーヘッド向けのアイテムビルダー用ユーティリティ。
• エンティティのスポーン、health/absorption、クールダウンパケット、TPS チェックのためのマルチバージョン/NMS ヘルパー。
• 複数の Factions 実装との互換性を助ける Factions ハンドラー API。
• SpigotMC または Hangar のプラグイン更新確認。
• アイテムの確認やイベントリスナーのデバッグのための小さなサーバーユーティリティコマンド。

🧩 対象ユーザー

• 共通のサーバー機能に再利用可能な基盤が欲しいプラグイン開発者。
• SirBlobman の複数プラグイン、または BlueSlimeCore のユーティリティに依存する他のプラグインを運用しているサーバー管理者。

🏗️ 使用例

• 開発者がメニュー API を使って、在庫処理を一から書かずにショップ画面を作成する。
• 管理者が item-to-nbt を使って、デバッグ用にアイテムの NBT データを確認する。
• プラグインが factions ハンドラーを統合し、1 つの統合レイヤーで複数の Factions 実装をサポートする。

⌨️ コマンド

⚙️ インストール

📥 セットアップ

• 公式の BlueSlimeCore jar をダウンロードし、サーバーの plugins/ ディレクトリに配置します。
• サーバーが対応する Spigot/Paper/Folia ビルドで動作していることを確認し、サーバーを起動または再起動します。
• サーバーコンソールで BlueSlimeCore の起動メッセージを確認し、プラグインが読み込まれたことを確認します。

📦 依存関係

• Java 25 が必要です（サーバー JVM 要件はプロジェクトリポジトリで確認済み）。

🧠 技術メモ

• 確認済みの対応サーバーソフトウェア: Spigot、Paper、Folia。
• このプロジェクトは他のプラグイン開発者向けの API を公開しています。BlueSlimeCore に依存するプラグインを動かすサーバーには、BlueSlimeCore の jar をインストールしてください。
• リポジトリのライセンスは GPL-3.0 です。

🤝 このプラグインが役立つ場面

複数のプラグインを管理している場合や、共通のサーバーユーティリティ（メニュー、メッセージ、マルチバージョンサポート）に依存する機能を開発している場合、BlueSlimeCore は重複コードを減らし、サーバー管理者とプラグイン保守者に一貫した API を提供します。