Trình sửa .mcstructure — tệp cấu trúc Bedrock

Hỗ trợ Minecraft Bedrock Edition và Java Edition — cùng mọi phần mềm máy chủ phổ biến hoặc ít gặp của cả hai: Vanilla, Paper, Spigot, Purpur, Folia, Fabric, Forge, NeoForge, Mohist, Sponge, Bedrock Dedicated Server, PocketMine-MP, Nukkit, PowerNukkitX, Cloudburst, Dragonfly, Endstone, LeviLamina và các phần mềm còn lại. Danh sách đầy đủ.

Tệp .mcstructure là NBT little-endian không nén do structure block Bedrock ghi. Thả tệp bên dưới để đọc kích thước, bảng block, chỉ số block và dữ liệu block entity, sửa bất kỳ phần nào rồi tải tệp xuống với cùng kiểu mã hóa — phù hợp khi người làm add-on hoặc bản đồ cần vá cấu trúc mà không mở lại thế giới.

Structure blockAdd-on BedrockBehavior packNBT little-endian

Thả tệp .mcstructure vào đây

level.dat · .nbt · .mcstructure · .schem · .schematic · .dat · dữ liệu chunk trích xuất

Bên trong .mcstructure có gì

ThẻKiểuNội dung
format_versionIntPhiên bản định dạng cấu trúc, bằng 1 trong các tệp hiện tại
sizeDanh sách IntKích thước X, Y, Z của vùng đã chụp
structure_world_originDanh sách IntVị trí lấy cấu trúc trong thế giới
structureCompoundMọi dữ liệu bên dưới nằm tại đây
structure.block_indicesDanh sách Int[]Hai lớp chỉ số bảng block — thường là block và trạng thái ngập nước; -1 nghĩa là "giữ nguyên nội dung hiện có"
structure.entitiesDanh sách CompoundCác thực thể được chụp cùng cấu trúc
structure.palette.default.block_paletteDanh sách CompoundMọi trạng thái block riêng biệt: name, states, version
structure.palette.default.block_position_dataCompoundNBT của block entity, dùng chỉ số phẳng của vị trí làm khóa

Chỉ số trong block_indices chạy theo X, rồi Z, rồi Y — chỉ số phẳng (x * sizeZ + z) * sizeY + y vào danh sách bảng block. Ánh xạ này cho phép sửa một block bị đặt sai mà không cần tạo lại cấu trúc.

Những thay đổi thường gặp

  • Đổi một loại block ở mọi vị trí bằng cách sửa một mục trong block_palette — mọi vị trí trỏ đến chỉ số đó sẽ thay đổi theo.
  • Sửa trạng thái block như facing sai hoặc waterlogged vô tình được bật trong compound states.
  • Xóa thực thể bị đưa vào ngoài ý muốn bằng cách xóa các mục khỏi danh sách entities.
  • Sửa dữ liệu block entity — đồ trong rương, văn bản biển, cài đặt spawner — bên trong block_position_data.
  • Kiểm tra dấu phiên bản trên các mục bảng block khi cấu trúc nhập vào có block sai sau khi cập nhật trò chơi.

Vị trí các tệp

Structure block lưu vào thư mục structures/ bên trong thư mục thế giới, trong các tệp có tên <namespace>_<name>.mcstructure. Behavior pack đặt chúng trong structures/ của pack, nơi trò chơi tải theo namespace. Cả hai dùng cùng định dạng và đều mở được tại đây.

Tệp tương đương của Java Edition là cấu trúc .nbt big-endian nén gzip — kiểu mã hóa và bố cục thẻ khác. Trang trình sửa Java mô tả các tệp đó, và công cụ này cũng mở được chúng.

Câu hỏi thường gặp

Tôi có thể chuyển .mcstructure sang cấu trúc .nbt Java không?

Trình sửa có thể mã hóa lại byte thành big-endian gzip, nhưng bố cục thẻ khác nhau — cấu trúc Java dùng palette/blocks với khóa và tên block khác. Tệp mã hóa lại có thể đọc được nhưng không phải cấu trúc Java hợp lệ.

Tại sao .mcstructure của tôi không được nén?

Bedrock ghi tệp cấu trúc dưới dạng NBT little-endian thô, không có lớp bọc gzip. Đây là bình thường; trình sửa phát hiện nó là Bedrock thô.

Chỉ số -1 trong block_indices có nghĩa gì?

Nó đánh dấu vị trí mà cấu trúc không thay đổi, vì vậy block hiện có trong thế giới được giữ lại khi đặt cấu trúc.

Tôi có thể đổi kích thước cấu trúc bằng cách sửa size không?

Không thể chỉ sửa riêng — block_indices có một mục cho mỗi vị trí nên độ dài mảng phải khớp chính xác với thể tích mới. Chỉ đổi size sẽ tạo tệp bị trò chơi từ chối.

Công cụ liên quan