コマンド > データタグ

データタグとは

マインクラフトのさまざまなデータは NBT(Named Binary Tag) という独自の形式で保存されています。
その NBT について、ゲーム中でコマンドでアクセスするために用いられるのが「データタグ」です。
記法は(ゆるい形式の) JSON です。

目次


+ブロック
+エンティティ
+アイテム・その他


記述方法

{<tagname>:<value>}
データタグはコロンを挟んだ「タグ名」と「値」のペアで表されます。
tagname は NBT タグの名前で、value はそのタグに割り当てるデータ本体です。
タグは大文字と小文字を区別し、正確に記述する必要があります。
データタグは全体が中括弧 {} の中に記述される必要があります。
タグとコロンと値以外の部分には整形用に空白文字を挿入することができ、コマンドからは無視されます。

データタグの配列 (TAG_Compound)

{<tagname1>:<value>, <tagname2>:<value> ...}
複数のデータタグを列挙するときは配列を使用します。
中括弧 {} の中にコンマで区切ってデータタグを列挙します。

リスト (TAG_List)

{<tagname>:[<value>, <value> ...]}
{<tagname>:[<tagname2>:<value>, <tagname3>:<value> ...]}
1つのタグに内包して、複数の詳細データタグまたは値を記述できるようにするために、リストがあります。
角括弧 [] の中にコンマで区切って列挙します。

データ型

文字列 (TAG_String)

テキストを指定する場合は二重引用符 "" の中に記述します。
二重引用符をテキストの中で使用する場合は前にエスケープ記号をつけ \" とします。
その他の一般的なエスケープは無効です。

数値

10進法で記述します。他の進法表記は出来ません。
正確に表記するため、数値の後ろにそれぞれ接尾辞をつける場合があります。
浮動小数点型で整数を指定する場合は小数点以下 .0 を記述するか、接尾辞を付けないと動作しません。
TAG_Byte 形式の場合は 1/0 に限り true/false という表現をすることができます。

参考:内部形式
種類 TagType 値の範囲 接尾辞
整数(1バイト) TAG_Byte -128~127 B/b
整数(2バイト) TAG_Short -32,768~32,767 S/s
整数(4バイト) TAG_Int -2,147,483,648~2,147,483,647 (なし)
整数(8バイト) TAG_Long -9,223,372,036,854,775,808~9,223,372,036,854,775,807 L/l
浮動小数点(4バイト) TAG_Float ±10^-38~10^38 F/f
浮動小数点(8バイト) TAG_Double ±10^-308~10^308 D/d


編集用コメント

~情報を投稿する際には、以下の点をご確認ください~
ここは、Wiki編集が苦手な方が情報提供を行う場です。関係の無いコメントは予告なく削除されます。
既に同じ情報が載っていないかを確認してください。
投稿されたコメントへの返信は、返信したいコメント横の○をクリック(タップ)して返信して下さい。
新規投稿を重ねてしまうと、他のコメントが流れてしまいます。
Wiki運営に関してはWiki運営掲示板、質問は質問掲示板Minecraft Japan Forum、雑談等はMinecraft Japan Forumにてお願いします。
表示がおかしいと感じる場合、「機種」と、「お使いのブラウザ名」を記載するようにしてください。
コメント欄の方針に関してはコメント欄方針を参照して下さい。
  • ページ分割されて文字検索つかいにくくなたな - 名無しさん 2016-11-04 19:13:10
    • attackspeed書いて無くない? - 名無しさん 2016-11-04 19:21:44
    • ItemのAttributeModifiersの欄にSlot書いてない - 名無しさん 2016-11-04 19:45:49
    • attackspeed,Slot追加しました - 名無しさん 2016-12-31 12:52:53
  • 1.11でNoAI: - 名無しさん 2016-12-01 15:24:37
    • よろしくお願いいたします - ポコ 2016-12-29 13:26:55
  • ↑はミスです。1.11でNoAI:trueのとき物理法則に従わなくなったようです。 - 名無しさん 2016-12-01 15:26:10
  • setblockコマンド時のボタン・レバーのデータタグも・・・ - 名無しさん 2016-12-06 21:06:40
    • ボタン・レバーの向きはデータタグではなく、メタデータ(ダメージ値)ですので違うページで説明すべきですが・・どこに書けば良いんでしょうね。 - 名無しさん 2017-01-01 12:00:30
    • ボタンの情報載せときますね。0(何も書かなかった場合でも)だと、天井に設置され、1だと東を向いて(つまり設置面は西)、2だと西を向いて、3だと南、4だと北に、5だと地面に設置されます。 - 名無しさん 2016-12-06 21:13:59
    • 6と7、おそらく5と変わりません。8は天井に設置(ボタンON)9は東(ON)10、11、12、13も2~5と同じ方向でON。14と15もおそらく13と同じ。 - 名無しさん 2016-12-06 21:16:56
  • なぜエンティティがアイテム・その他の中に含まれていたりするのですか? - 名無しさん 2016-12-21 22:01:42
    • 「ブロック」と「エンティティ」はチャンクデータに、「アイテムその他」ページのはプレイヤーファイルに保存されるという違いがありました。でも分かりづらかったのでエンティティの方にまとめました。 - 名無しさん 2016-12-30 21:18:00
  • MOB,飛行エンティティを ver1.11 対応しました。ご指摘は後日修正したいと思います。 - 名無しさん 2016-12-30 15:22:24
    • 他のページも対応終わりました - 名無しさん 2017-01-01 11:58:59
  • 雷って無いんですか - 名無しさん 2017-01-19 22:04:13
    • Lightning_Boltです。(LとBは小文字でもOK) - 名無しさん 2017-01-22 20:19:07
  • 知識の本がありません - 名無しさん 2017-07-08 07:09:24
  • エンチャントしたらつくNBTタグの変え方は分かりますか? 1から3に変えたいのですが... - 名無しさん 2017-08-10 14:34:05
    • 質問は質問掲示板で - 名無しさん (2017-08-18 10:10:15)
  • アイテムのデータタグで1.13からenchの代わりにEnchantmentsが使用されるようになったので修正をお願いします - 名無しさん (2018-06-11 17:32:11)
最終更新:2016年09月19日 11:37