Minecraft Wiki
Advertisement
このページで各エンティティ固有のデータ構造を表示するためのテンプレート(~/ED)の翻訳が未完了です。英語版を参照してデータの拡充にご協力ください。

エンティティは対応するディメンションのフォルダ内のentitiesフォルダに保存されている。regional Minecraft Anvilファイルのように、r.x.z.mca(x、zは特定の数値)の形式で保存されている。

フォルダ構造[]

  • (ワールドのセーブデータのディレクトリ)
    • entities
      • r.x.z.mca
    • DIM-1
      • entities
        • r.x.z.mca
    • DIM1
      • entities
        • r.x.z.mca

NBT構造[]

全てのエンティティは、データ上はChunkファイルのエンティティリスト内の名前のない TAG_Compoundである。唯一の例外はプレイヤーエンティティで、サーバー上のlevel.datまたは<player>.datに保存されている。

  • ルートタグ。
    •  DataVersion: Chunkデータのバージョン。
    •  Position: このChunkの位置。
      • : チャンクのX座標。
      • : チャンクのZ座標。
    •  Entities: 全てのエンティティ。このリスト内のTAG_Compoundがチャンク内のエンティティすべてを定義している。

エンティティフォーマット[]

全てのエンティティが下記の構造によって表現されている。

  • エンティティデータ。
    •  Air: 各ティックでのエンティティが持っている空気の量。呼吸ができない状態(非透過ブロック内で窒息している状態を除く)では毎ティック1ずつ減少する。-20になった時点でまだ呼吸ができない場合、そのエンティティはHealth(体力)を1失い、Airは0にリセットされる。ほとんどのMobのAirの最大値は300であるが、イルカでは4800、ウーパールーパーでは6000になる。
    •  CustomName: エンティティのカスタム名を記録するJSONテキスト。死亡メッセージや村人の交易画面のGUI、、そしてプレイヤーがそのエンティティにカーソルを向けたときにエンティティの上に表示されるボックスなどに表示される。値が空白、あるいは存在しない場合もある。data removeで削除することはできないが、値を空白に設定することで同様の結果を発生できる。
    •  CustomNameVisible: 1(true)か0(false)の値をとる。Trueの場合かつこのエンティティが CustomNameに値を持つ場合、プレイヤーのカーソル位置に関係なく常にエンティティの名前が頭上に表示される。Trueかつエンティティが CustomNameを持たない場合は、デフォルトの名前が表示される。なおこのNBTタグは存在しない場合がある。
      ボート・トロッコおよびその亜種についてはやや仕様が異なり、この値がfalseの場合はターゲットしている間のみ、trueの場合は常に名前が表示される。
    •  FallDistance: 現時点でエンティティが落下している距離。落下していない時点では0であり、落下開始すると開始地点からの落下距離が代入される。この値が大きいと、地面に激突したときのダメージも比例して大きくなる。
    •  Fire: エンティティに点いた火が消えるまでのティック数。負の値はエンティティが火の中で炎上せずに耐えられる時間に影響する。デフォルトは炎上していない時の-20である。
    •  Glowing: 1(true)か0(false)の値をとる。エンティティが発光しているかどうかを示す(Trueで発光)。
    •  HasVisualFire: 1(true)か0(false)の値をとる。Trueの場合、エンティティが実際に炎上しているかどうかに関わらず、炎上しているように描画される。
    •  id: 文字列表現されたエンティティのID。プレイヤーエンティティにはこの要素は存在しない。
    •  Invulnerable: 1(true)か0(false)の値をとる。Trueならばエンティティは一切ダメージを受けない(不死身:Invulnerable)。これは生物エンティティにも非生物エンティティにも適用可能であり、Trueの場合はエンティティは(ポーション効果を含め)一切のダメージを受けないことに加え、釣り竿や攻撃、爆発や投擲物で動かされることもなく、乗り物や額縁などに関しても破壊することができない(額縁は張り付いているもとのブロックが壊れると剥がれる)。さらにプレイヤーは全ての敵対的Mobに無視される。ただし、これがtrueであるMobもクリエイティブモードのプレイヤーからはダメージを受けることには注意が必要である。
    •  Motion: 倍精度浮動小数点数で記述されたXYZ方向の3成分で表現されたプレイヤーの速度(単位はメートル毎ティック)。
    •  NoGravity: 1(true)か0(false)の値をとる。Trueならばエンティティは自然に落下することはない。ゲーム内では溶岩の上にいるストライダーに対してTrueで設定されている。
    •  OnGround: 1(true)か0(false)の値をとる。Trueならばエンティティは地面に接触していると見なされる。
    •  Passengers: このエンティティに騎乗しているエンティティのデータ。なお、自然にスポーンした際には運動の決定は両方が、スポーン条件の決定は一番上のMobが行っている。
      • : 騎乗しているエンティティのデータ。この形式が適用される(再帰)。
        • すべてのエンティティに共通するタグ
        • 騎乗しているエンティティ特有のデータ
    •  PortalCooldown: エンティティがネザーポータルからテレポートする可能性のある時刻までのティック数。カウントはテレポート後から300ティック(15秒)で始まり、0までカウントされる。
    •  Pos: 倍精度浮動小数点数で記述されたXYZ座標で示した現在のエンティティの座標。
    •  Rotation: 2つの浮動小数点数で記述されたエンティティの回転角。
      • 時計回りの方向を正とするY軸周りの回転角(水平角・ヨー角とも)。南が0度で値域は0度~360度。
      • 水平を基準としたエンティティの傾き(鉛直角・ピッチ角とも)。水平が0度で、下に傾く方向が正。値域は-90~+90度。
    •  Silent: 1(true)か0(false)の値をとる。Trueならばエンティティは一切の音を発しない。この要素は存在しない場合がある。
    •  Tags: このエンティティのスコアボードのタグ
    •  TicksFrozen: 凍結開始からの経過ティック数。このタグは全てのエンティティに対して定義されているが、実際に使用されているのはfreeze_immune_entity_typesのタグに属するMobのみである。粉雪の中にいる間1ティック毎に1増加し、最大値は300、粉雪の外にいるときは2づつ減少する。
    •  UUID: エンティティのUUIDである。128bitのUUIDは4つの32bitの整数として、最上位ビットから最下位ビットの順で保存されている。

Mob[]

Mob
エンティティID 名前
axolotl ウーパールーパー
bat コウモリ
bee ミツバチ
blaze ブレイズ
cat ネコ
cave_spider 洞窟グモ
chicken ニワトリ
cod タラ
cow ウシ
creeper クリーパー
dolphin イルカ
donkey ロバ
drowned ドラウンド
elder_guardian エルダーガーディアン
ender_dragon エンダードラゴン
enderman エンダーマン
endermite エンダーマイト
evoker エヴォーカー
fox キツネ
ghast ガスト
giant ジャイアント
glow_squid ヒカリイカ
goat ヤギ
guardian ガーディアン
hoglin ホグリン
horse ウマ
husk ハスク
illusioner イリュージョナー
iron_golem アイアンゴーレム
llama ラマ
magma_cube マグマキューブ
mooshroom ムーシュルーム
mule ラバ
ocelot ヤマネコ
panda パンダ
parrot オウム
phantom ファントム
pig ブタ
piglin ピグリン
piglin_brute ピグリンブルート
pillager ピリジャー
polar_bear シロクマ
pufferfish フグ
rabbit ウサギ
ravager ラヴェジャー
salmon サケ
sheep ヒツジ
shulker シュルカー
silverfish シルバーフィッシュ
skeleton スケルトン
skeleton_horse スケルトンホース
slime スライム
snow_golem スノウゴーレム
spider クモ
strider ストライダー
squid イカ
stray ストレイ
trader_llama 商人のラマ[Java Edition限定]
tropical_fish 熱帯魚
turtle カメ
vex ヴェックス
villager 村人
villager_v2 村人[Bedrock Edition限定]
vindicator ヴィンディケーター
wandering_trader 行商人
witch ウィッチ
wither ウィザー
wither_skeleton ウィザースケルトン
wolf オオカミ
zoglin ゾグリン
zombie ゾンビ
zombie_horse ゾンビホース
zombie_villager 村人ゾンビ
zombie_villager_v2 村人ゾンビ[Bedrock Edition限定]
zombified_piglin ゾンビピグリン

Mobはエンティティの下位クラスであり、エンティティ共通のタグに加えて体力、攻撃・ダメージ状態、ポーション効果、そして各Mob固有のその他様々な情報を保存するためのタグを持っている。プレイヤーはMobの下位クラスに位置する。

飛翔体[]

飛翔体エンティティ
エンティティID 名前
arrow
dragon_fireball ドラゴンの火の玉
egg
ender_pearl エンダーパール
experience_bottle エンチャントの瓶
fireball ガスト#ガストの火の玉
firework_rocket ロケット花火
llama_spit ラマの唾
potion スプラッシュポーション
small_fireball ファイヤーチャージ /(ブレイズの火球
shulker_bullet シュルカーの弾
snowball 雪玉
spectral_arrow 光の矢[Java Edition限定]
trident トライデント
wither_skull ウィザーの頭蓋骨

飛翔体(英:Projectile)はエンティティの下位クラスであり、エンティティ共通のタグに加えて固有のタグを持つ。

アイテム・経験値オーブ[]

アイテムエンティティ
エンティティID 名前
experience_orb 経験値オーブ
item アイテム (エンティティ)

アイテムと経験値オーブはエンティティの下位クラスであり、エンティティ共通のタグに加えて固有のタグを持つ。

乗り物[]

乗り物エンティティ
エンティティID 名前
boat ボート
minecart トロッコ
chest_minecart チェスト付きトロッコ
command_block_minecart コマンドブロック付きトロッコ
furnace_minecart かまど付きトロッコ
hopper_minecart ホッパー付きトロッコ
spawner_minecart スポナー付きトロッコ
tnt_minecart TNT付きトロッコ

乗り物はエンティティの下位クラスであり、エンティティ共通のタグに加えて、固有のタグを持つ。

動的ブロック[]

動的ブロックエンティティ
エンティティID 名前
falling_block 落下中のブロック
tnt TNT

動的ブロックはブロックのリアルな動きを実現するためのエンティティの下位クラスであり、エンティティ共通のタグに加えて固有のタグを持つ。

その他[]

その他のエンティティ
エンティティID 名前
area_effect_cloud エリアエフェクトクラウド
armor_stand 防具立て
end_crystal エンドクリスタル
evoker_fangs エヴォーカーの牙
eye_of_ender エンダーアイ
fishing_bobber 浮き
item_frame 額縁
leash_knot リードの結び目
lightning_bolt
marker マーカー
painting 絵画

その他のエンティティはエンティティの下位クラスに位置し、エンティティ共通のタグに加えて固有のタグを持つが、上記のどのカテゴリにも該当しない。

歴史[]

Java Edition
1.1720w45aエンティティはメインの(terrain)Chunkからは分離され、個別のエンティティディレクトリに保存されるようになった(POIストレージと同様)。これらの新しいファイルは従来と同様にNBT付きのregionファイルである。
1.1922w11aMob、プレイヤー、防具立ての ActiveEffects内の Idのデータ型が TAG_Integer(32ビット整数タグ)から TAG_Byte(8ビット整数タグ)に変更された。
1.20.223w32aMob、プレイヤー、防具立てのNBTタグの名称・データ型が以下のように変更された。
  •  ActiveEffects active_effects
  •  Id id(指定形式も数値IDから名前空間IDに変更)
  •  Ambient ambient
  •  Duration duration
  •  ShowParticles show_particles
  •  ShowIcon show_icon
  •  HiddenEffect hidden_effect(この下位構造にも同様の変更が加わっている)
1.20.323w41a非Mobエンティティ全般で CustomName CustomNameVisibleが機能するようになった。
開発中のJava Edition
1.20.524w06aNBTタグの名称が以下のように変更された。
  •  FlowerPos flower_posミツバチ
  •  HivePos hive_pos(ミツバチ)
  •  Leash leash(全てのMob)
  •  PatrolTarget patrol_target襲撃しているMob)
  •  WanderTarget wander_target行商人
Advertisement