MCMETA ファイル形式とは?
.mcmeta は、Mojang Studios が開発した Minecraft (Java Edition) で使用されるプレーンテキストの JSON メタデータ ファイルです。このファイルには、リソースパックやデータパックの構成データのほか、フレームの順序、フレーム時間、補間設定などのテクスチャごとのアニメーション プロパティが保存されます。
.mcmeta ファイルは Minecraft において 2 つの異なる役割を果たします。最も重要なのは pack.mcmeta で、すべてのリソースパックまたはデータパックのルートに配置され、パックのフォーマット バージョンと説明を宣言します。2 つ目の役割はテクスチャごとのアニメーション制御です。テクスチャの隣に .mcmeta ファイル(例:water_still.png.mcmeta)を配置することで、ゲームプレイ中にアニメーション フレームをいつ、どのように再生するかをゲームに指示します。
.mcmeta ファイル内のデータはプレーンテキスト形式で保存されているため、パック作成者はゲームのソースコードをいじることなく編集できます。構造は標準的な JSON 表記に従っており、典型的な pack.mcmeta は次のようになります。
{ "pack": { "pack_format": 34, "description": "My Resource Pack" } }
pack_format の数値は対象の Minecraft バージョンと一致させる必要があり、メジャー リリースごとに増加します。古いチュートリアルで示されている値 «4» は、バージョン 1.13-1.14 にのみ適用されます。
Minecraft 自体は .mcmeta ファイルを直接開きません。パックを読み込むときにそれらを参照するだけです。ユーザーはメモ帳や Visual Studio Code などのテキスト エディタで pack.mcmeta を編集したり、オンライン ツールを使用して生成したりできます。
セキュリティと安全性
リスク: LOWMCMETA ファイルは実行コードやマクロを含まないプレーンテキストの JSON であるため、開いて読み取っても安全です。唯一の実用的なリスクは編集ミスです。無効な JSON(カンマや括弧の欠落)や間違った pack_format は、Minecraft がパックを拒否したり、互換性がないと表示したりする原因になります。ロードする前にエディタで JSON を検証してください。パック自体はサードパーティから提供されるため、他のダウンロードと同様にパックのソースを信頼できるか確認してください。
形式の詳細
概要MCMETA ファイルを開くプログラム
pack.mcmeta を含むパックを resourcepacks/ または datapacks/ に配置すると、ゲームが .mcmeta を読み込んでロードします。 pack.mcmeta を生成します。pack_format の間違いを防げます。 技術的詳細
詳細仕様| ファイル形式 | プレーンテキスト UTF-8 JSON オブジェクト。バイナリ コンテンツなし |
| MIME タイプ | application/json |
| ファイル命名規則 | パックのルートにある `pack.mcmeta`、またはアニメーション テクスチャ ファイルに付随する `<texture>.png.mcmeta` |
| マジックバイト | なし - `{` で始まる(標準 JSON)。バイナリ シグネチャなし |
| 主要な `pack.mcmeta` キー | `pack_format`(対象の Minecraft バージョンに一致する整数)および `description`(文字列または JSON テキスト コンポーネント) |
| `pack_format` の変遷 | Java Edition 1.6.1 で «1» として導入。メジャー リリースごとに増加し、Java Edition 1.21.x までに 30 台半ばに到達 |
| テクスチャ アニメーション キー | `frametime`(フレームあたりのチック数、デフォルトは 1)、`frames`(フレーム インデックスまたはオブジェクトの配列)、`interpolate`(ブール値、デフォルトは false) |
| デフォルトのアニメーション フレームレート | アニメーション ブロックから `frametime` が省略されている場合、1 フレームあたり 1 チック(20 ticks/s で毎秒 20 フレーム) |
| ファイル サイズ | 通常 1 KB 未満。最小限の `pack.mcmeta` は 50-100 バイト程度 |
| プラットフォームの範囲 | Java Edition のみ。Bedrock Edition は `.mcmeta` の代わりに `manifest.json` を使用 |
| `pack.mcmeta` を使用するパックの種類 | リソースパック、データパック、ワールドパック - すべてルート フォルダに `pack.mcmeta` が必要 |
| オーバーレイのサポート | Java Edition 1.20.2(`pack_format` 18 以降)より、`pack.mcmeta` でバージョン条件付きのアセット オーバーライド用ディレクトリを宣言可能 |
| エンコーディング | UTF-8。BOM(バイト順マーク)は不要であり、省略すべき |
| 開発元 | Mojang Studios (Microsoft) |
| リリース日 | 2013 (resource/data pack metadata, Minecraft Java Edition 1.6/1.7) |
| 仕様書 | minecraft.wiki |
MCMETA の変換
コミュニティ Q&A
ユーザーからの質問まだ質問はありません。MCMETA ファイルについて最初の質問をしてみましょう。
よくある質問
.mcmeta ファイルを開くにはどうすればよいですか?
Minecraft の pack.mcmeta とは何ですか?
pack_format 番号が保持されており、これにより Minecraft はそのパックがどのゲーム バージョンをサポートしているかを判断します。パックに «互換性がありません» と表示されます。修正方法は?
pack_format をお使いの Minecraft バージョンに合わせて設定してください(例:1.21.8 の場合は 48)。1.21.9 以降では min_format/max_format を使用します。ジェネレーター ツールを使えば、適切な番号を選択できます。.png.mcmeta ファイルとは何ですか?
water_still.png.mcmeta)。その中の «animation» ブロックが、テクスチャの垂直フレーム ストリップをタイミング付きのアニメーション テクスチャに変換します。.mcmeta を別の形式に変換できますか?
.mcmeta という名前と JSON コンテンツである必要があります。Bedrock Edition は .mcmeta を使用しますか?
manifest.json を使用します。.mcmeta ファイルは Minecraft Java Edition 専用です。