Minecraftプラグイン HolographicDisplays

🔌 Holographic Displays について

Holographic Displays は、Minecraft 用のプラグインで、テキストやアイテムを表示できる持続的な浮遊ホログラムを提供します。このプラグインには、ホログラムを作成・編集するためのゲーム内コマンドがあり、ほかのプラグインにホログラムを組み込むための開発者向け API も用意されています。

🎯 目的

このプラグインは、恒久的な見えるエンティティを作らずに、ワールド内で浮遊する情報、ラベル、メニュー、ビジュアルを表示したいというニーズを解決します。サーバー管理、装飾表示、ワールド内メニュー、プラグインが固定位置でプレイヤーにデータを見せる統合に役立ちます。

⚙️ 機能

• 特定の場所に名前付きホログラムを作成・削除できる。
• ホログラムのテキスト行を追加、削除、設定、挿入できる。
• 浮遊アイテムをホログラムの行として表示できる（浮遊アイテム対応）。
• テキストファイルの行をホログラムに読み込める。
• ファイルまたは URL から画像を読み込み、ホログラムとして描画できる（記号の対応付けと最大幅を設定可能）。
• ホログラムを整列、移動、コピー、テレポートできる。
• 手動でファイルを編集せずに、プラグイン設定と保存済みホログラムを再読み込みできる。
• 他のプラグインがホログラムをプログラムから作成・管理できる開発者向け API がある。

🧩 対象ユーザー

• ワールド内の視覚的な表示を求めるサーバー管理者（SMP、Survival、Minigame サーバー）。
• ワールド内でプレイヤーにテキストやアイテムを表示するための API が必要なプラグイン開発者。
• 看板、メニュー、情報表示にホログラムを使うスタッフチーム。

🏗️ 使用例

• ミニゲームが、各アリーナの上にホログラムで現在のスコアを表示する。
• サーバーのロビーが、サーバー規則とクリックでテレポートするアイテムを浮遊する行として表示する。
• プラグイン連携が、固定地点のホログラムに動的なプレイヤー統計を表示する。

⌨️ コマンド

注意: ドキュメントでは、各サブコマンドに個別の権限があるとされています（例: /hd list には holographicdisplays.list が必要です）。メインの /hd コマンドは誰でも利用できます。

🔐 権限

⚙️ インストール

📥 セットアップ

• 信頼できるカタログから公式プラグイン JAR をダウンロードします。
• JAR を Bukkit/Spigot 用サーバーの plugins/ ディレクトリに配置します。
• サーバーを再起動し、コンソールでプラグインが読み込まれたことを確認します。

📦 依存関係

• 公式ドキュメントの要約には必須の依存関係は記載されていません。インストール時は、ダウンロードページで任意の連携があるか確認してください。

🧾 設定

• このプラグインは設定ファイルと保存済みホログラムをサポートします。ファイルを編集した後は、用意されている再読み込みコマンドで変更を反映してください。
• 画像の描画と記号のマッピングは、プラグイン設定から構成できます。

🧠 技術メモ

• 公式ドキュメントには、Minecraft 1.13+ における素材名の変更と画像/アイコンの扱いに関するアップグレードガイドが含まれています。
• プラグイン連携向けの開発者 API が документация されています。

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

情報、メニュー、またはプラグイン連携のために、永続的で編集可能なワールド内表示が必要な場合、Holographic Displays は名前付きホログラム、ファイル/画像の取り込み、そして他のプラグインがホログラムを確実に作成・更新できる API を提供します。