Minecraftプラグイン DeluxeTags

🔌 DeluxeTags について

DeluxeTags は、Spigot 向けの Minecraft プラグインで、権限ベースの追加タグ（プレフィックス）を提供します。プレイヤーはゲーム内 GUI またはコマンドでアンロックしたり切り替えたりできます。タグは「追加のプレフィックス」として扱われ、プレースホルダーを使ってチャット、tab、その他のチャット連携に表示できます。

🎯 目的

DeluxeTags は、ランク/グループのプレフィックスとは別に、任意でアンロック可能な見た目用タグをプレイヤーに与える問題を解決します。メインのグループやランクを変更せずに、購入可能・アンロック可能・報酬として付与可能なタグを、有効/無効にできるサーバーに便利です。

⚙️ 機能

• 権限ベースのタグ: deluxetags.tag.<identifier> でアクセスを付与できます（設定例では deluxetags.tag.example）。
• 利用可能なタグを閲覧・選択できるプレイヤー用 GUI。
• タグを一覧表示・選択・管理するコマンド（プレイヤー用および管理者用コマンドはプロジェクトで文書化されています）。
• PlaceholderAPI 対応と、アクティブなタグ、識別子、説明、数をチャット形式に挿入するためのプレースホルダー。
• プラグイン設定スニペットに表示される、GUI アイテム、名前、ページ設定のカスタマイズ。
• 参加時にプレイヤーのタグを読み込むオプション、チャット整形との連携、更新確認。

🧩 対象ユーザー

• ランクのプレフィックスとは別に、見た目用でアンロック可能なチャットタグがほしい Survival / SMP サーバー。
• LuckPerms などの権限プラグインで見た目報酬を付与しているサーバー。
• プレイヤー向けに、GUI ベースのシンプルなタグ選択画面がほしい管理者。

🏗️ उपयोग例

• VIP タグの権限を、購入できる見た目用アイテムとしてプレイヤーに付与し、タグ GUI で切り替えられるようにする。
• イベント報酬として特定のタグ権限を付与し、勝者が利用可能なタグから新しいタグを選べるようにする。
• 管理者がコマンドでカスタムタグを作成し、権限で使用可能なプレイヤーを設定する。

⌨️ コマンド

注: プロジェクトのドキュメントでこれらのコマンドは確認されています。特定のコマンド権限ノード（タグごとのノードパターン以外）は主要ソースには記載されていません。

🔐 権限

このプラグインはタグごとの権限ノードを使用します。その他のコマンド固有のノードは、利用可能な主要プロジェクトファイルでは明示的に文書化されていません。

⚙️ インストール

📥 セットアップ

• プロジェクトの Spigot リソースまたは公式ビルド成果物からプラグインの JAR をダウンロードします。
• JAR をサーバーの plugins/ フォルダに配置します。
• サーバーを起動または再起動し、コンソールでプラグインが読み込まれたことを確認します。

📦 依存関係

• PlaceholderAPI — 対応済み（プラグインにプレースホルダーと papi_chat オプションが含まれます）。設定およびプレースホルダー例に記載されています。

🧾 設定

• DeluxeTags は、タグ、GUI 設定、メッセージを定義する YAML 設定を使用します。設定には、タグ項目、GUI アイテム設定、プレースホルダー、チャット形式オプションの例が含まれます。設定でよく見られるキー: deluxetags:, gui:, format_chat, papi_chat, load_tag_on_join。

🧠 技術メモ

• プロジェクトのソースは公開 GitHub リポジトリで入手できます。
• Spigot のプロジェクトには、1.8 から 1.21 までのテスト済み Minecraft バージョンが記載されており、テスト済みバージョン一覧には 1.20.6 の項目も含まれています。
• 開発ビルドと CI 成果物は、プロジェクトの CI サーバーから提供されます。
• リポジトリ上ではソースホストに公開リリースは表示されません。CI 成果物は別途利用できます。

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

プレイヤーに、ランクグループを変えずに GUI やコマンドで有効化できる、任意の権限ベースの見た目用タグを持たせたいなら、DeluxeTags は PlaceholderAPI 連携によるチャット表示も備えた、シンプルで設定しやすい解決策です。