Unknown Network

ホログラム・Displayエンティティ・BossBar

1. ホログラム

ホログラムはNPCの上などに固定的なテキスト行を表示する機能です。NPCのセリフをクリック／近接時に表示する /npc text とは異なります。

代表的な操作：

/npc hologram add 旅人ギルド
/npc hologram add クエスト受付
/npc hologram set 1 冒険者ギルド
/npc hologram remove 2
/npc hologram clear

現行コマンド資料では、add、insert、set、remove、edit_npc、clear、lineheight、viewrange、行上下のmargin設定などが掲載されています。行番号・引数の詳しい書式は /npc help hologram を確認してください。

テキスト構文

NPC名・ID等のプレースホルダー、チャット色／装飾、対応箇所でのMiniMessageやPlaceholderAPIを利用できる場合があります。使用可能な置換は Text Syntax を参照してください。

よく使う場面

  • NPCの役職や店名を常時表示
  • 操作案内「右クリックで話しかける」
  • メニューやショップの名称
  • 名前だけでは伝えきれない情報を複数行で表示

2. Text Display

MinecraftのText Display系エンティティでは、テキストをエンティティとして表示します。現行コマンドには次のような設定があります。

/npc textdisplay --text "ようこそ"
/npc textdisplay --shadowed true --seethrough false

これはコマンド構造を示す例です。引用符・スペースの扱いと利用できるフラグは実際の /npc help textdisplay に従ってください。Citizensのホログラム機能とMinecraft標準のText Displayでは、編集方法・行管理・対象となるエンティティが異なるため、目的に合わせて選択します。

3. Item Display／Block Display／Display設定

Display系エンティティは、アイテム・ブロック・テキスト等を表示するためのエンティティです。通常Mobとは異なり、移動AIや装備スロットより、表示変換・スケール・回転・オフセット・補間・明るさ・視認距離が重要です。

現行コマンド一覧の /npc display には、たとえば以下の項目があります。

  • ビルボード（カメラに向く方法）
  • 明るさ（ブロック光・空光）
  • 補間の遅延と時間
  • 高さ・幅・スケール
  • 視認距離
  • 左右の回転変換
  • 位置オフセット

/npc itemdisplay はアイテムDisplayのtransform設定を扱うコマンドとして掲載されています。詳細は使用版のヘルプを参照してください。

4. BossBar

/npc bossbar はNPCに関連するボスバー表示の設定を扱います。現行コマンド資料には、スタイル、色、タイトル、表示状態、表示権限、フラグ、追跡値（health／placeholder）、表示範囲などが挙げられています。

使い方の方向性：

  • ボスやイベントNPCの体力表示
  • 接近しているプレイヤー向けの状態表示
  • 権限を持つプレイヤーだけに見せる表示

BossBarが体力を追跡するか、Placeholderを使うか、他プラグインと競合しないかは実際の設定で確認してください。

5. 文字が見えない場合

  1. 対象NPC／Displayが正しくスポーンしているか。
  2. viewrange、明るさ、スケール、オフセットが適切か。
  3. 文字列の色が背景と同化していないか。
  4. プレースホルダーが解決されているか。
  5. クライアント側の表示更新（再ログイン等）で改善するか。
  6. Minecraft・Citizensのバージョンが対象コマンドに対応しているか。

参照：https://wiki.citizensnpcs.co/Commands、https://wiki.citizensnpcs.co/Text_Syntax

Citizens - Holograms Display | Unknown Network