左メニュー
左メニューサンプル左メニューはヘッダーメニューの【編集】>【左メニューを編集する】をクリックすると編集できます。ご自由に編集してください。掲示板雑談・質問・相談掲示板更新履歴最近のコメントカウン...
Information icon.svg
この項目はJava Edition限定の要素です。
表示エンティティ
表示エンティティ（英：Display Entity）はデータパックやマップ製作向けのエンティティであり、様々なものを表示するのに利用できる。ブロック表示エンティティ（block_display）、アイテム表示エンティティ（item_display）、テキスト表示エンティティ（text_display）の3種類が存在する。/summonや/execute summonコマンドでのみ作成できる。
目次
振る舞い
マーカーと同様に、表示エンティティは移動せず、ダメージも受けず、サウンドも発せず、ブロックの設置も邪魔せず、プレイヤーやその他エンティティを外に押し出しもしない。マーカーと異なるのは、クライアント側で描画され、デバッグ画面のEの値（総エンティティ数）に計上されるという点である。
表示エンティティに当たり判定はなく、F3 + Bで当たり判定を表示させても、表示エンティティに対する当たり判定は表示されないが、視線の向きを示す青色の線は表示される。表示エンティティに向かってF3 + Iを押しても、エンティティデータはクリップボードにコピーされない。
使用法
表示エンティティはコマンドでのみ召喚できる。省略時の内容は、ブロック表示エンティティ、アイテム表示エンティティ、テキスト表示エンティティでそれぞれ{Name:"minecraft:air"}、{id:"minecraft:air",Count:0b}、'{"text":""}'であり、NBTを指定せずにコマンドで作成した場合、不可視のエンティティとして生成される。エンティティデータを変更することで表示内容やその他視覚効果、およびモデルの回転、縮尺、平行移動を容易に編集できる。
custom_model_data付きのアイテム表示エンティティによって任意のカスタムモデルを容易に表示することができる。
アイテム表示エンティティの場合、NBTを直接編集する以外にも、container.0スロットに対して/lootや/itemを使うことでも表示アイテムを編集できる。
補間アニメーション
表示エンティティのプロパティのうちいくつかは補間機能を持ち、時間をかけて徐々に変化するようなアニメーションを表示することができる。補間機能に対応しているプロパティは、#エンティティデータ項を参照。
補間機能に対応しているプロパティに変更が加えられると変更前後の値が共にクライアント側に保存され、変更を受け取ったクライアント側のティックからstart_interpolationティック後にアニメーションを開始し、interpolation_durationティックをかけて変更前の値から変更後の値へ滑らかに変化させる。
サーバーは1ティックに高々1回だけクライアントとのエンティティの同期を行うため、1ティック内で複数回プロパティを変更した場合も1回で同様の変更を行った場合と同様に作用する。
補間機能は対応しているプロパティに対して一括で作用するため、プロパティごとに補間機能を別個に作用させることはできない。
技術的情報
ID
| エンティティ | 名前空間ID | 翻訳キー |
|---|---|---|
| ブロック表示エンティティ | block_display | entity.minecraft.block_display |
| アイテム表示エンティティ | item_display | entity.minecraft.item_display |
| テキスト表示エンティティ | text_display | entity.minecraft.text_display |
エンティティデータ
「エンティティフォーマット」も参照
表示エンティティにはエンティティの様々な属性を含むエンティティデータが存在する。
アイテム表示エンティティ- ルートタグ。
- すべてのエンティティに共通するタグ
- すべての表示エンティティに共通するタグ
- item：表示するアイテム。
- すべてのアイテムに共通するタグ
- item_display：アイテムモデルの表示の仕方。アイテムモデルのJSONのdisplayフィールドで定義されるようなモデル変換の種類を指定する。none、thirdperson_lefthand、thirdperson_righthand、firstperson_lefthand、firstperson_righthand、head、gui、ground、fixed（省略時）のいずれかの値を指定する。
- ルートタグ。
- すべてのエンティティに共通するタグ
- すべての表示エンティティに共通するタグ
- block_state：ブロック状態。
- ブロック状態
- ルートタグ。
- すべてのエンティティに共通するタグ
- すべての表示エンティティに共通するタグ
- alignment：テキストの水平方向の配置。center（省略時）、left、rightのいずれかを指定する。
- background：背景色。ARGB値で指定する。アルファチャンネルが0.1未満のピクセルはバニラのシェーダーの描画対象外であるため、Aの値が26（0x1A）未満の場合、完全に透明な背景となる。省略時は1073741824（
0x40000000）である。補間対象である。 - default_background：trueのとき、チャットなどで使用されるデフォルトの背景色が使われる。 backgroundより優先される。省略時はfalseである。
- line_width：1行の最大幅。これを超える幅のテキストは改行される（注：改行文字\nを挿入することでも改行できる）。省略時は200である。
- see_through：ブロック越しにテキストが表示されるかどうか。省略時はfalseである。
- shadow：テキストの影の有無。省略時はfalseである。
- text：Raw JSONテキストフォーマットで記述した、表示するテキスト。
- text_opacity：テキストのアルファ値。本来0から255の値であるが、符号なし整数型はNBTに存在しないため、127より大きい値は256を減算する必要があり、よって-128から127の値を指定することとなる。背景色と同様に、26未満のアルファ値は完全な透明として扱われる。省略時は-1であり、これはアルファ値255すなわち完全な不透明に対応する。補間対象である。
歴史
| Java Edition | |||||
|---|---|---|---|---|---|
| 1.19.4 | 23w06a | ブロック表示エンティティ、アイテム表示エンティティ、テキスト表示エンティティが追加された。 | |||
| Pre-release 4 | 新規の補間アニメーションが開始する際、現行の補間アニメーションの最終地点ではなく現在の状態から次のアニメーションを開始するようになった。 | ||||
| Release Candidate 1 | 補間機能が、クライアント側のティックの最初に始まるようになった。 | ||||
| フィールドinterpolation_startが、異なる機能を持つstart_interpolationに置き換わった。 | |||||
| start_interpolationは、補間機能発動の更新を受け取った次のクライアント側のティックから、補間機能開始までのティック数を指定する。例えば、これが0に設定されている場合は更新を受け取った次のクライアント側のティックの初めから補間機能が開始される。 | |||||
| start_interpolationはエンティティデータに保存されない。/dataを用いて動作させる際、補間値が更新されたのにstart_interpolationが変更されたタグの中に含まれていない場合、補間機能は前回の更新から継続して、新しい値で行われる。 | |||||
問題点
「表示エンティティ」、「ブロック表示エンティティ」、「アイテム表示エンティティ」、または「テキスト表示エンティティ」に関する問題点は、バグトラッカーにて管理されている。問題点の報告はそちらで行ってほしい。
テンプレート:Entities/contentを表示 [編集]
特に記載のない限り、コミュニティのコンテンツはCC BY-NC-SAライセンスの下で利用可能です。