Minecraftサーバー HolographicDisplays プラグイン

## 🔌 Holographic Displays について Holographic Displays は、Minecraft 用のプラグインで、テキストやアイテムを表示できる持続的な浮遊ホログラムを提供します。このプラグインには、ホログラムを作成・編集するためのゲーム内コマンドがあり、ほかのプラグインにホログラムを組み込むための開発者向け API も用意されています。 ## 🎯 目的 このプラグインは、恒久的な見えるエンティティを作らずに、ワールド内で浮遊する情報、ラベル、メニュー、ビジュアルを表示したいというニーズを解決します。サーバー管理、装飾表示、ワールド内メニュー、プラグインが固定位置でプレイヤーにデータを見せる統合に役立ちます。 ## ⚙️ 機能 - 特定の場所に名前付きホログラムを作成・削除できる。 - ホログラムのテキスト行を追加、削除、設定、挿入できる。 - 浮遊アイテムをホログラムの行として表示できる（浮遊アイテム対応）。 - テキストファイルの行をホログラムに読み込める。 - ファイルまたは URL から画像を読み込み、ホログラムとして描画できる（記号の対応付けと最大幅を設定可能）。 - ホログラムを整列、移動、コピー、テレポートできる。 - 手動でファイルを編集せずに、プラグイン設定と保存済みホログラムを再読み込みできる。 - 他のプラグインがホログラムをプログラムから作成・管理できる開発者向け API がある。 ## 🧩 対象ユーザー - ワールド内の視覚的な表示を求めるサーバー管理者（SMP、Survival、Minigame サーバー）。 - ワールド内でプレイヤーにテキストやアイテムを表示するための API が必要なプラグイン開発者。 - 看板、メニュー、情報表示にホログラムを使うスタッフチーム。 ## 🏗️ 使用例 - ミニゲームが、各アリーナの上にホログラムで現在のスコアを表示する。 - サーバーのロビーが、サーバー規則とクリックでテレポートするアイテムを浮遊する行として表示する。 - プラグイン連携が、固定地点のホログラムに動的なプレイヤー統計を表示する。 ## ⌨️ コマンド | **コマンド** | **説明** | **権限** | **アクセス** | |---|---|---:|:---| | `/hd` | メインコマンド。プラグイン情報とバージョンを表示します。 | なし（全員が利用可） | プレイヤー | | `/hd help` | 利用可能なコマンドと簡単なヘルプを表示します。 | なし（全員が利用可） | プレイヤー | | `/hd create <hologramName> [text]` | 現在地に新しいホログラムを作成します。 | `holographicdisplays.create` | Admin | | `/hd delete <hologram>` | 名前付きホログラムを削除します。 | `holographicdisplays.delete` | Admin | | `/hd list [page]` | 既存のホログラムと場所を一覧表示します。 | `holographicdisplays.list` | Admin | | `/hd near <radius>` | 指定半径内で近くにあるホログラムを一覧表示します。 | `holographicdisplays.near` | Admin | | `/hd teleport <hologram>` | ホログラムの場所へテレポートします。 | `holographicdisplays.teleport` | Admin | | `/hd align <axis> <hologram> <reference>` | 指定した軸で、あるホログラムを別のホログラムに合わせます。 | `holographicdisplays.align` | Admin | | `/hd movehere <hologram>` | ホログラムを自分の足元位置へ移動します。 | `holographicdisplays.movehere` | Admin | | `/hd edit <hologram>` | ホログラムの編集オプションを開きます。 | `holographicdisplays.edit` | Admin | | `/hd addline <hologram> <text>` | ホログラムにテキスト行を追加します。 | `holographicdisplays.addline` | Admin | | `/hd removeline <hologram> <number>` | ホログラムから番号付きの行を削除します。 | `holographicdisplays.removeline` | Admin | | `/hd setline <hologram> <number> <newText>` | 特定の行のテキストを変更します。 | `holographicdisplays.setline` | Admin | | `/hd insertline <hologram> <number> <text>` | 指定したインデックスの後に行を挿入します。 | `holographicdisplays.insertline` | Admin | | `/hd info <hologram>` | 行番号付きでホログラムの内容を表示します。 | `holographicdisplays.info` | Admin | | `/hd copy <from> <to>` | あるホログラムの内容を別のホログラムへコピーします。 | `holographicdisplays.copy` | Admin | | `/hd readtext <hologram> <file>` | ファイルの行をホログラムに読み込みます。 | `holographicdisplays.readtext` | Admin | | `/hd readimage <hologram> <image> <width> [-a]` | ファイルまたは URL から画像をホログラムに描画します。 | `holographicdisplays.readimage` | Admin | | `/hd reload` | 設定と保存済みホログラムを再読み込みします。 | `holographicdisplays.reload` | Admin | 注意: ドキュメントでは、各サブコマンドに個別の権限があるとされています（例: `/hd list` には `holographicdisplays.list` が必要です）。メインの `/hd` コマンドは誰でも利用できます。 ## 🔐 権限 | **権限** | **説明** | **デフォルト** | |---|---|---:| | `holographicdisplays.<subcommand>` | 各 `/hd` サブコマンドごとの個別権限（例: `holographicdisplays.list`）。 | 指定なし | | `holographicdisplays.update` | 設定で有効な場合、参加時に更新通知を受け取ります。 | 指定なし | | `holographicdisplays.*` | すべての holographicdisplays 権限を付与します（権限プラグインが対応している場合）。 | 指定なし | ## ⚙️ インストール ### 📥 セットアップ - 信頼できるカタログから公式プラグイン JAR をダウンロードします。 - JAR を Bukkit/Spigot 用サーバーの `plugins/` ディレクトリに配置します。 - サーバーを再起動し、コンソールでプラグインが読み込まれたことを確認します。 ### 📦 依存関係 - 公式ドキュメントの要約には必須の依存関係は記載されていません。インストール時は、ダウンロードページで任意の連携があるか確認してください。 ### 🧾 設定 - このプラグインは設定ファイルと保存済みホログラムをサポートします。ファイルを編集した後は、用意されている再読み込みコマンドで変更を反映してください。 - 画像の描画と記号のマッピングは、プラグイン設定から構成できます。 ## 🧠 技術メモ - 公式ドキュメントには、Minecraft 1.13+ における素材名の変更と画像/アイコンの扱いに関するアップグレードガイドが含まれています。 - プラグイン連携向けの開発者 API が документация されています。 ## 🤝 このプラグインが役立つ場面 情報、メニュー、またはプラグイン連携のために、永続的で編集可能なワールド内表示が必要な場合、Holographic Displays は名前付きホログラム、ファイル/画像の取り込み、そして他のプラグインがホログラムを確実に作成・更新できる API を提供します。

プラグイン