Éditeur .mcstructure — fichiers de structure Bedrock

Compatible avec Minecraft Bedrock Edition et Java Edition, ainsi qu'avec tous leurs logiciels serveur, courants ou non : Vanilla, Paper, Spigot, Purpur, Folia, Fabric, Forge, NeoForge, Mohist, Sponge, Bedrock Dedicated Server, PocketMine-MP, Nukkit, PowerNukkitX, Cloudburst, Dragonfly, Endstone, LeviLamina et les autres. Liste complète.

Un fichier .mcstructure contient du NBT petit-boutiste non compressé écrit par un bloc de structure Bedrock. Déposez-en un ci-dessous pour lire ses dimensions, sa palette de blocs, ses indices de blocs et les données de ses entités de bloc, modifier n'importe quelle valeur et télécharger le fichier dans le même encodage. Les créateurs d'add-ons et de cartes peuvent ainsi corriger une structure sans rouvrir le monde.

Blocs de structureAdd-ons BedrockPacks de comportementNBT petit-boutiste

Déposez un fichier .mcstructure ici

level.dat · .nbt · .mcstructure · .schem · .schematic · .dat · extractions de chunks

Contenu d'un fichier .mcstructure

BaliseTypeContenu
format_versionIntRévision du format de structure, 1 dans les fichiers actuels
sizeListe de IntDimensions X, Y, Z du volume capturé
structure_world_originListe de IntEmplacement de la capture dans le monde
structureCompoundContient toutes les données ci-dessous
structure.block_indicesListe de Int[]Deux couches d'indices de palette, généralement les blocs et leur immersion ; -1 signifie « laisser le bloc existant »
structure.entitiesListe de CompoundEntités capturées avec la structure
structure.palette.default.block_paletteListe de CompoundChaque état de bloc distinct : name, states, version
structure.palette.default.block_position_dataCompoundNBT des entités de bloc, indexé par l'indice linéaire de la position

Les indices de block_indices parcourent X, puis Z, puis Y. L'indice linéaire (x * sizeZ + z) * sizeY + y pointe dans la liste de la palette. Cette correspondance permet de corriger un seul bloc mal défini sans régénérer la structure.

Modifications courantes

  • Remplacer un type de bloc partout en modifiant une entrée de block_palette : chaque position qui pointe vers cet indice change avec elle.
  • Corriger un état de bloc, par exemple un facing incorrect ou un waterlogged accidentel, dans le composé states.
  • Supprimer les entités capturées par erreur en retirant leurs entrées de la liste entities.
  • Réparer les données d'entités de bloc — contenu des coffres, texte des panneaux, paramètres des générateurs — dans block_position_data.
  • Vérifier la version enregistrée dans les entrées de palette lorsqu'une structure est importée avec des blocs incorrects après une mise à jour du jeu.

Emplacement des fichiers

Les blocs de structure enregistrent les fichiers dans le dossier structures/ du monde, sous le nom <namespace>_<name>.mcstructure. Les packs de comportement les placent dans leur propre dossier structures/, où le jeu les charge par espace de noms. Les deux emplacements utilisent le même format et s'ouvrent ici.

L'équivalent de Java Edition est le fichier de structure .nbt gros-boutiste compressé avec gzip : son encodage et la disposition de ses balises diffèrent. La page de l'éditeur Java les décrit, et cet éditeur les ouvre également.

Questions fréquentes

Puis-je convertir un fichier .mcstructure en structure .nbt Java ?

L'éditeur peut réencoder les octets en gros-boutiste avec gzip, mais la disposition des balises diffère. Les structures Java utilisent palette/blocks avec d'autres clés et noms de blocs. Le fichier réencodé est lisible, mais ne constitue pas une structure Java valide.

Pourquoi mon fichier .mcstructure n'est-il pas compressé ?

Bedrock écrit les fichiers de structure sous forme de NBT petit-boutiste brut, sans enveloppe gzip. C'est normal ; l'éditeur le détecte comme Bedrock brut.

Que signifie l'indice -1 dans block_indices ?

Il désigne une position que la structure ne modifie pas. Le bloc déjà présent dans le monde est donc conservé lorsque la structure est placée.

Puis-je redimensionner une structure en modifiant size ?

Pas uniquement ainsi : block_indices possède une entrée par position, donc la longueur du tableau doit correspondre exactement au nouveau volume. Modifier seulement size produit un fichier refusé par le jeu.

Outils associés