この記事は「minecraft:stoneって何？」と感じた初心者向けの解説です
Java版のコマンド・データパック、統合版のアドオン制作でよく出るIDの読み方を整理します
Java版26.1時点の仕様を前提に、1.21.11以降の変更点にも触れています
こんにちは。ゆずかきです。
マイクラでコマンドやリソースパックの記事を読んでいると、急にこんな文字列が出てきませんか？
minecraft:stone minecraft:zombie minecraft:diamond_sword
最初に見ると、これだけで少し難しそうに見えると思います。
筆者も最初は「なんで石を出すだけなのに、わざわざminecraft:って付けるの？」と思っていました。
でも安心してください。
これは難しいプログラミング用語というより、マイクラ内のものを間違えずに指定するための住所みたいなものです。
この記事では、名前空間ID・minecraft:・リソースロケーションについて、コマンド初心者さんでも読めるように順番に整理していきますね。
この記事を読めば、次のことが分かります。
minecraft:stoneの読み方が分かります👍minecraft:を省略していい場面・省略しない方がいい場面が分かります👌- Java版と統合版でのID指定の違いが整理できます
- コマンド・データパック・リソースパック・アドオン制作でのエラー原因を減らせます(^^♪
それでは、やっていきましょう！
※本記事は、Java版のコマンド・データパック・リソースパック、統合版のアドオン制作で使うID表記を中心に解説しています。
※ゲーム内の仕様については、Minecraft公式リリースノート・Minecraft Wiki・Microsoft Learnなどの情報を参考にしています。
※統合版はアドオンやJSONの仕様変更が入りやすいため、実際に制作する場合は公式のCreatorドキュメントも確認してくださいね。
目次
1. 名前空間IDとは？
2. minecraft:の意味を先に理解する
3. リソースロケーションの読み方
4. 名前空間IDはどこで使う？
5. Java版と統合版の違い
6. よく見る名前空間IDの実例
7. 古い数値IDとの違いとバージョン変更点
8. よくあるエラーと直し方
9. 初心者向けの覚え方
10. まとめ
11. 参考文献
この記事で分かること
・minecraft:stoneのような名前空間IDの読み方
・Java版と統合版で、ID指定をどう考えればいいか
・コマンドやパック制作でよくある入力ミスの直し方
1. 名前空間IDとは？
名前空間IDとは、マイクラ内のブロック・アイテム・エンティティ・バイオームなどを、ゲームが間違えずに見分けるためのIDです。
たとえば、石なら、
minecraft:stone
ゾンビなら、
minecraft:zombie
ダイヤモンドの剣なら、
minecraft:diamond_sword
という感じですね。
見た目は英語の文字列ですが、考え方はかなりシンプルです。
名前空間:名前
この形で、左側が「どこのものか」、右側が「何か」を表しています。
| 表記 | 左側 | 右側 | 意味 |
|---|---|---|---|
minecraft:stone |
minecraft | stone | マイクラ本体の石 |
minecraft:zombie |
minecraft | zombie | マイクラ本体のゾンビ |
example:custom_item |
example | custom_item | exampleというMODや統合版アドオンなどの独自要素 |
つまり、minecraft:stoneは、
minecraftという名前空間にあるstone
という読み方になります。
この「名前空間」という仕組みがあるおかげで、マイクラ本体・データパック・リソースパック・MOD・統合版アドオンなどが、同じような名前を使っても衝突しにくくなっています。
たとえば、誰かが独自の「ruby」という要素を作ったとしても、
mypack:ruby anotherpack:ruby
のように名前空間を分ければ、ゲーム側は別物として扱えます。
ここが大事です。
名前空間IDは、マイクラ世界の住所です。
2. minecraft:の意味を先に理解する
minecraft:は、マイクラ本体に最初から入っているものを表す名前空間です。
石、土、ゾンビ、クリーパー、ダイヤモンド、オーバーワールドなど、バニラの要素は基本的にminecraft名前空間に入っています。
たとえば、
minecraft:dirt minecraft:creeper minecraft:diamond minecraft:cherry_grove
これらは全部、マイクラ本体側のIDです。
Java版では、コマンドなどの場面でminecraft:を省略できることが多いです。
/give @p minecraft:diamond 1
これは、次のように書いても通る場面があります。
/give @p diamond 1
diamondだけ書いた場合でも、Java版では多くの場合、ゲーム側が「これはminecraft:diamondのことだな」と解釈してくれます。
ただし、初心者さんには最初から省略するより、慣れるまではminecraft:を付けて書く方をおすすめします。
理由は単純で、後からデータパック・リソースパック・MOD・統合版アドオンに触れた時に、IDの見方で迷いにくいからです。
筆者のおすすめ
コマンドを少し試すだけなら省略してもOK。
でも、記事に書く時・人に説明する時・パック制作する時は、minecraft:まで書いた方が親切です。
特に検索でこの記事に来た方は、今後どこかでcustom:sample_itemのような独自IDを見る可能性が高いです。
その時に「左が名前空間、右が名前」と分かっていれば、かなり読みやすくなります。
3. リソースロケーションの読み方
名前空間IDとほぼ同じ文脈で、リソースロケーションという言葉も出てきます。
リソースロケーションは、英語だとResource locationです。
Java版の技術的な説明やMOD制作、データパック、リソースパックの記事でよく見ます。
基本形は同じです。
namespace:path
日本語で読むなら、
名前空間:パス
です。
ここでいうpathは、単なる名前だけでなく、ファイルの場所っぽい意味を持つこともあります。
ブロックやアイテムを指定する場合
minecraft:stone minecraft:oak_planks minecraft:diamond_sword
この場合、右側は「石」「オークの板材」「ダイヤモンドの剣」という種類名として読めばOKです。
テクスチャやモデルを指定する場合
リソースパックでは、右側がフォルダ階層を含むことがあります。
minecraft:block/oak_planks minecraft:item/diamond_sword minecraft:textures/entity/pig/pig.png
このように、/が入ると「フォルダの中をたどる」イメージになります。
Java版のリソースロケーションでは、左側の名前空間に/は使えません。
一方、右側のパスには/を使えます。
minecraft:block/oak_planks
これは、
minecraft名前空間の中にある、block/oak_planksという場所
という読み方です。
大文字は基本使わない
Java版のリソースロケーションでは、基本的に小文字で書きます。
minecraft:diamond_sword ← OK minecraft:Diamond_Sword ← Java版ではNGになりやすい
特にリソースパック制作では、大文字・全角文字・全角コロンが原因で読み込まれないことがあります。
ここは本当に事故りやすいです。
体験談
筆者も最初、ファイル名やIDに大文字を混ぜて、リソースパックが反映されずに困りました。
迷ったら、英小文字・数字・アンダーバー中心で書くのが安全です。
4. 名前空間IDはどこで使う？
名前空間IDは、普段のサバイバルだけを遊んでいると意識しないかもしれません。
でも、コマンドやパック制作に触れた瞬間から、かなり頻繁に出てきます。
代表的な使いどころを見ていきましょう。
コマンドで使う
Java版のコマンドでは、ブロック・アイテム・エンティティ・バイオームなどを指定する時に使います。
/give @p minecraft:diamond_sword 1 /summon minecraft:zombie ~ ~ ~ /setblock ~ ~ ~ minecraft:oak_planks /locate biome minecraft:cherry_grove /effect give @s minecraft:night_vision 30
コマンド入力中に候補が出る場合もあります。
Java版1.21.11では、コマンドのリソース候補がminecraft名前空間だけではなく、他の名前空間の結果も表示されるようになりました。
これはデータパックを使う人には地味に大事な変更です。
独自の名前空間を使った要素を探しやすくなった、ということですね。
データパックで使う
データパックでは、関数・レシピ・ルートテーブル・進捗・タグなどを分けるために名前空間を使います。
例として、yuzukakiという名前空間を使うなら、イメージはこんな感じです。
data/yuzukaki/...
この中に、自分の関数やレシピなどを入れていきます。
たとえば、関数を呼び出す時に、
/function yuzukaki:main
と書けば、yuzukaki名前空間のmainを呼ぶイメージです。
ここでminecraft:mainのようにしてしまうと、マイクラ本体側の名前空間を使うことになります。
独自データパックなら、基本的には自分専用の名前空間を使いましょう。
リソースパックで使う
リソースパックでは、テクスチャ・モデル・サウンド・フォントなどを指定する時に名前空間が出てきます。
バニラのテクスチャを差し替えるなら、minecraft名前空間を使う場面があります。
assets/minecraft/...
一方、独自モデルや独自テクスチャを整理したい場合は、自分の名前空間を用意することがあります。
assets/yuzukaki/...
この場合、JSON内から独自テクスチャなどを参照する時は、
"textures": { "layer0": "yuzukaki:item/custom_sword" }
のように、名前空間付きで書きます。
ここで名前空間を書き忘れると、Java版ではminecraft名前空間として解釈される場面があります。
つまり、せっかくassets/yuzukaki側にファイルを置いても、ゲームがassets/minecraft側を探しに行ってしまうことがあります。
統合版アドオンで使う
統合版のアドオンでは、独自ブロック・独自アイテム・独自エンティティなどのidentifierに名前空間を付けます。
"identifier": "yuzukaki:orange_block"
統合版のCreatorドキュメントでは、独自コンテンツにminecraft名前空間を使わないことが示されています。
minecraftはバニラ要素を上書きするような特別な場面で出てくる名前空間なので、普通に独自要素を作るなら、自分だけの名前空間を使うのが安全です。
5. Java版と統合版の違い
名前空間IDの考え方自体は、Java版も統合版も似ています。
ただし、実際の書き方・省略できる場面・アドオン制作のルールには違いがあります。
特に大事なのは、次の3点です。
| 項目 | Java版 | 統合版 |
|---|---|---|
| 基本形 | namespace:path |
namespace:nameの形が多い |
minecraft:の省略 |
コマンドなどで省略できる場面が多い | 場面によって扱いが違うため、アドオンでは省略しない方が安全 |
| 独自コンテンツ | データパック・リソースパック・MODで独自名前空間を使う | アドオンの独自ブロック・アイテム等では独自名前空間が重要 |
minecraft名前空間 |
バニラ要素の指定・上書きで使う | バニラ上書き以外の独自要素には使わない方が安全 |
Java版では、
/give @p diamond
のように書いても、minecraft:diamondとして扱われる場面があります。
一方で、統合版のアドオン制作では、JSON内のidentifierに名前空間が必須になる場面があります。
"identifier": "my_pack:custom_block"
この差を知らないまま、Java版の記事を統合版アドオンにそのまま持っていくと、エラーの原因になります。
逆に、統合版のアドオン記事をJava版のデータパック制作にそのまま当てはめても、フォルダ構造やJSONの書き方が違って混乱します。
注意！
「名前空間ID」という考え方は共通でも、Java版と統合版でファイル構造やJSON仕様は別物です。
コピペする前に、必ず記事がJava版向けか統合版向けか確認しましょうね。
6. よく見る名前空間IDの実例
ここでは、実際によく見る名前空間IDをまとめます。
初心者さんは、まずこのあたりを見慣れておくとコマンド記事が読みやすくなります。
| 分類 | 名前空間ID | 意味 | 使う場面の例 |
|---|---|---|---|
| ブロック | minecraft:stone |
石 | /setblock、/fill |
| ブロック | minecraft:oak_planks |
オークの板材 | 建築コマンド、リソースパック |
| アイテム | minecraft:diamond_sword |
ダイヤモンドの剣 | /give |
| エンティティ | minecraft:zombie |
ゾンビ | /summon |
| エンティティ | minecraft:villager |
村人 | /summon、データ編集 |
| バイオーム | minecraft:cherry_grove |
桜の林 | /locate biome |
| ディメンション | minecraft:overworld |
オーバーワールド | データパック、ワールドデータ |
| エフェクト | minecraft:night_vision |
暗視 | /effect |
ここでひとつ覚えておきたいのが、同じID文字列でも、どの種類として扱うかは文脈で決まるという点です。
たとえば、minecraft:dirtはブロックとしてもアイテムとしても見かけます。
でも、
/setblock ~ ~ ~ minecraft:dirt
なら「土ブロックを置く」という意味ですし、
/give @p minecraft:dirt 64
なら「土アイテムを渡す」という意味になります。
つまり、名前空間IDだけで全部が決まるのではなく、どのコマンド・どのJSON項目で使っているかもセットで見ます。
ここは意外と大事です。
7. 古い数値IDとの違いとバージョン変更点
昔のマイクラ記事を見ると、今とは違うID表記が出てくることがあります。
たとえば、昔はブロックやアイテムを数値IDで説明している記事がありました。
1 35:14
このような表記ですね。
現在のJava版では、基本的にこういう古い数値IDではなく、
minecraft:stone minecraft:red_wool
のような名前空間IDで読むのが基本です。
Java版1.13では「The Flattening」と呼ばれる大きなID整理があり、多くのブロック・アイテムなどのIDが変更され、古い数値IDやメタデータ依存の表記から、現在のような分かりやすい文字列IDへ移っていきました。
古い記事を読む時の注意
古いコマンド記事で、
/give @p 1 64
のような書き方が出てきた場合、現在のJava版ではそのまま使えない可能性が高いです。
現在なら、石を渡す場合は、
/give @p minecraft:stone 64
のように書くのが基本です。
Java版1.21.11以降の変更点
Java版1.21.11では、コマンド入力時のリソース候補がminecraft名前空間だけでなく、他の名前空間も表示されるようになりました。
これは名前空間IDの基本形が変わったわけではありません。
ただ、データパックやカスタム要素を扱う時に、候補表示が少し便利になった変更です。
Java版26.1以降の変更点
Java版26.1では、ワールド保存データ側で名前空間を使った整理がさらに進みました。
たとえば、データフォルダ内の一部データが名前空間サブフォルダに保存されるようになっています。
ここも、minecraft:stoneのようなIDの読み方そのものが変わったわけではありません。
でも、マイクラ内部では「どの名前空間のデータか」をより明確に扱う方向へ進んでいる、と考えると分かりやすいです。
初心者さん向けの結論
Java版1.13以降の記事を読むなら、基本は名前空間IDで考える。
Java版1.21.11以降・26.1以降でも、namespace:pathという読み方自体は変わっていません。
8. よくあるエラーと直し方
名前空間IDまわりで起きるエラーは、だいたい入力ミス・省略ミス・Java版と統合版の混同が原因です。
ここでは、初心者さんがつまずきやすいパターンを整理します。
1. 大文字を使っている
minecraft:Diamond_Sword
Java版では、リソースロケーションに大文字を混ぜるとエラーになりやすいです。
基本は小文字で書きましょう。
minecraft:diamond_sword
2. 全角コロンを使っている
minecraft：stone
これは見た目が似ていますが、：が全角です。
正しくは半角の:です。
minecraft:stone
日本語入力のままコロンを打つと、ここで事故りがちです。
3. 独自名前空間を書き忘れている
リソースパックで独自テクスチャを作ったのに、
"textures": { "layer0": "item/custom_sword" }
のように書くと、Java版ではminecraft:item/custom_swordとして探される場合があります。
独自名前空間に置いているなら、
"textures": { "layer0": "yuzukaki:item/custom_sword" }
のように、名前空間を明記しましょう。
4. minecraft名前空間で独自アドオンを作っている
統合版アドオンで独自アイテムを作る時に、
"identifier": "minecraft:orange_sword"
のようにすると、将来的な競合や上書き事故の原因になります。
独自要素なら、
"identifier": "yuzukaki:orange_sword"
のように、自分用の名前空間を使う方が安全です。
5. #付きのタグIDと普通のIDを混同している
Java版のコマンドやデータパックでは、
#minecraft:logs
のように、先頭に#が付く表記を見ることがあります。
これは普通のブロックIDではなく、タグを指定している表記です。
minecraft:oak_logのような単体指定とは意味が違います。
minecraft:oak_log → オークの原木そのもの #minecraft:logs → 原木系をまとめたタグ
タグは便利ですが、使える場所が限られます。
エラーが出たら、そのコマンドやJSON項目がタグ指定に対応しているか確認しましょう。
6. Java版の記事を統合版にそのまま使っている
これはかなり多いです。
Java版のコマンド例を統合版に入れると、構文が違って動かないことがあります。
逆に、統合版のアドオンJSONをJava版データパックに持っていっても、そのままでは動きません。
名前空間IDの考え方は似ていますが、コマンド構文・JSON構造・フォルダ構造は別物として見てください。
9. 初心者向けの覚え方
ここまで色々書きましたが、最初から全部覚える必要はありません。
まずは、次の3つだけ覚えておけば大丈夫です。
名前空間IDの覚え方
1.minecraft:stoneは「minecraftのstone」と読む
2. 左側は「どこのものか」、右側は「何か」
3. 迷ったらminecraft:を省略せずに書く
これだけで、コマンド記事やリソースパック記事の読みやすさがかなり変わります。
住所で考えると分かりやすい
名前空間IDは、住所で考えると分かりやすいです。
minecraft:stone
これは、
minecraft町のstoneさん
みたいなものです。
一方、
yuzukaki:stone
なら、
yuzukaki町のstoneさん
です。
同じstoneという名前でも、住んでいる場所が違えば別物として扱えます。
これが名前空間の便利なところです。
記事を書く側ならminecraft:まで書くのがおすすめ
個人的には、攻略記事や配布データの説明を書く時は、できるだけminecraft:まで書くのがおすすめです。
/give @p minecraft:diamond 1
この方が、読者が見た時に「これはバニラのダイヤモンドだな」と分かりやすいからです。
特に、MOD・データパック・アドオンが絡む環境では、同じような名前のアイテムが増えます。
その時に名前空間まで書いてあると、読者にも親切です。
10. まとめ
以上、マイクラの名前空間ID・minecraft:・リソースロケーションについて解説しました。
要点を整理すると、
minecraft:stoneは、minecraft名前空間のstoneという意味minecraft:は、マイクラ本体のバニラ要素を表す名前空間- Java版では
minecraft:を省略できる場面が多いが、慣れるまでは書いた方が分かりやすい - リソースパックやデータパックでは、独自名前空間を使うと整理しやすい
- 統合版アドオンでは、独自コンテンツに自分用の名前空間を使うのが重要
- Java版1.13以降は、古い数値IDではなく名前空間IDで考えるのが基本
このあたりを押さえておけば、コマンド・データパック・リソースパック・統合版アドオンの記事がかなり読みやすくなります。
最初は英語だらけで難しそうに見えるかもしれませんが、慣れるとかなり便利です。
minecraft:stoneを見たら、まずは「左がどこのものか、右が何か」と分解して読んでみてください。
では、本日はここまでで終わります。
最後までご覧いただき、ありがとうございました。
柚子クラでは他にもマイクラの便利な仕様解説や装置解説をまとめているので、是非ご覧くださいね(^^♪
11. 参考文献
この記事を書くにあたり、以下の公式ドキュメント・コミュニティWikiを参考にしています。
- Minecraft Wiki（Resource location）
- Minecraft Wiki（Java Edition data values）
- Minecraft Wiki（Java Edition 1.13/Flattening）
- Minecraft公式（Minecraft Java Edition 1.21.11）
- Minecraft公式（Minecraft Java Edition 26.1）
- Microsoft Learn（Item Documentation - description）
- Microsoft Learn（Block Documentation - Block Description）
- Microsoft Learn（Guidelines for Building Cooperative Add-Ons）
- Bedrock Wiki（Namespaces）
