.mcstructureエディター — Bedrock構造物ファイル

Minecraft Bedrock EditionとJava Editionに対応し、一般的なものから小規模なものまで両方の全サーバーコアを扱えます: Vanilla、Paper、Spigot、Purpur、Folia、Fabric、Forge、NeoForge、Mohist、Sponge、Bedrock Dedicated Server、PocketMine-MP、Nukkit、PowerNukkitX、Cloudburst、Dragonfly、Endstone、LeviLaminaなど。全一覧。

.mcstructure はBedrockのストラクチャーブロックが書き出す非圧縮リトルエンディアンNBTです。下へドロップすると、サイズ、ブロックパレット、ブロックインデックス、ブロックエンティティデータを確認・編集し、同じエンコードでダウンロードできます。ワールドを開き直さずに構造物を修正したいアドオン作者やマップ制作者向けです。

ストラクチャーブロックBedrockアドオンビヘイビアーパックリトルエンディアンNBT

ここに.mcstructureファイルをドロップ

level.dat · .nbt · .mcstructure · .schem · .schematic · .dat · チャンクのダンプ

.mcstructure の内部

タグ型内容
format_versionInt構造物形式のリビジョン。現在のファイルでは1
sizeInt のリスト取得範囲のX、Y、Z寸法
structure_world_originInt のリストワールド内で構造物を取得した位置
structureCompound以下の全データを格納
structure.block_indicesInt[] のリスト通常はブロックと水没状態を表す2層のパレットインデックス。-1 は「その位置を変更しない」
structure.entitiesCompound のリスト構造物と一緒に取得したエンティティ
structure.palette.default.block_paletteCompound のリスト個別のブロック状態: name、states、version
structure.palette.default.block_position_dataCompound位置のフラットインデックスをキーにしたブロックエンティティNBT

block_indices はX、Z、Yの順で、パレット一覧へのフラットインデックスは (x * sizeZ + z) * sizeY + y です。この対応を使うと、構造物を作り直さずに1ブロックだけ修正できます。

一般的な編集内容

  • すべての同種ブロックを置換する: block_palette の1項目を編集すると、そのインデックスを参照する全位置が変わります。
  • ブロック状態を修正する: 誤った facing や意図しない waterlogged を states Compound内で変更します。
  • エンティティを除去する: 誤って含まれた項目を entities Listから削除します。
  • ブロックエンティティデータを修復する: チェスト内容、看板テキスト、スポナー設定を block_position_data 内で編集します。
  • バージョン情報を確認する: 更新後に誤ったブロックとして読み込まれる場合は、パレット項目のバージョンを確認します。

ファイルの保存場所

ストラクチャーブロックはワールドディレクトリー内の structures/ フォルダーへ <namespace>_<name>.mcstructure という名前で保存します。ビヘイビアーパックではパック内の structures/ に配置し、ゲームが名前空間で読み込みます。どちらも同じ形式です。

Java Editionで対応する形式はgzip圧縮ビッグエンディアンの構造物 .nbt で、エンコードもタグ配置も異なります。Javaエディターページで説明しており、このエディターでも開けます。

よくある質問

.mcstructureをJavaの.nbt構造物へ変換できますか?

バイト列をビッグエンディアンgzipへ再エンコードできますが、タグ配置が異なります。Java構造物は別のキーとブロック名を持つ palette/blocks を使うため、再エンコードしただけでは有効なJava構造物になりません。

.mcstructureが圧縮されていないのはなぜですか?

Bedrockは構造物ファイルをgzipなしの生のリトルエンディアンNBTとして保存します。正常な形式で、エディターでは Bedrock 生データ と判定されます。

block_indicesの-1は何を意味しますか?

構造物が変更しない位置を示します。配置時にはワールド内の既存ブロックがそのまま残ります。

sizeを編集して構造物の大きさを変えられますか?

block_indices は各位置に1項目必要なため、配列長を新しい体積へ正確に合わせる必要があります。size だけを変えるとゲームが拒否するファイルになります。

関連ツール