コマンド > データタグ

データタグとは

マインクラフトのさまざまなデータは 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> ...]}

１つのタグに内包して、複数の詳細データタグまたは値を記述できるようにするために、リストがあります。
角括弧 [] の中にコンマで区切って列挙します。

データ型

文字列 (TAG_String)

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

数値

１０進法で記述します。他の進法表記は出来ません。
正確に表記するため、数値の後ろにそれぞれ接尾辞をつける場合があります。
浮動小数点型で整数を指定する場合は小数点以下 .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運営掲示板、質問は質問掲示板、雑談等は非公式フォーラムにてお願いします。
• 投稿の前に、一度コメントログや、バージョンアップ直後はパッチノートにも目を通し、既に同じ内容が載っていないか確認して下さい。
• 投稿されているコメントへの返信の際は、返信したいコメント横の○にチェックを入れて返信して下さい。
  表示できる親コメントの数は限られます。新規投稿をむやみに行うことは、他のコメントが流れてしまう要因になります。

コメントログ)