.mcstructure

保存与加载 ​

导出按钮会在结构方块中创建.mcstructure文件。这些文件必须放置在行为包中，才能通过加载结构方块在游戏中调用。文件路径决定了结构标识符，该标识符需要输入到结构方块中以加载对应结构。

示例：BP/structures/house.mcstructure → mystructure:houseBP/structures/dungeon/entrance.mcstructure → dungeon:entranceBP/structures/stuff/towers/diamond.mcstructure → stuff:towers/diamond

第一个子文件夹定义命名空间，后续文件夹定义路径，最后以结构文件名结尾。

注意：直接放在structures文件夹中的文件会被赋予mystructure命名空间。如果structures文件夹中的结构与显式mystructure文件夹中的结构重名，游戏会产生以下内容日志警告：

[structure][warning]-加载默认命名空间的结构时发生冲突。在根目录和mystructure目录中都发现了名为<name>的结构。

这种情况下，mystructure文件夹中的文件会"胜出"，导致直接放在structures文件夹中的文件被忽略。

文件格式 ​

mcstructure文件是未压缩的NBT文件。与所有基岩版NBT文件一样，它们以小端格式存储。标签结构如下：

format_version: 当前固定为1。

size: 包含三个整数的列表，描述结构边界尺寸。

结构在X方向上的尺寸。

结构在Y方向上的尺寸。

结构在Z方向上的尺寸。

structure: 实际数据复合标签。

block_indices: 包含两个子列表的列表，分别对应两个层级。这些列表包含结构中的方块，每个方块存储为调色板的整数索引（见下文）。按ZYX顺序从最低角到最高角排列。例如，如果结构尺寸为[2,3,4]，那么每个层级列表中的24个值（各维度乘积）代表位于[(0,0,0), (0,0,1), (0,0,2), (0,0,3), (0,1,0), (0,1,1), (0,1,2), (0,1,3), (0,2,0), (0,2,1), (0,2,2), (0,2,3), (1,0,0), (1,0,1), (1,0,2), (1,0,3), (1,1,0), (1,1,1), (1,1,2), (1,1,3), (1,2,0), (1,2,1), (1,2,2), (1,2,3)]位置的方块（相对于原点）。索引值为-1表示无方块，加载时会保留原有方块。这种情况出现在保存结构空洞时，第二层的大多数方块都是如此。两个层级共享同一个调色板。

包含 主层级方块的索引。

包含 次层级方块的索引。该层级通常为空，除非该位置方块被水浸没。

包含 entities: 实体列表，以NBT格式存储，与世界文件中的实体完全相同。Pos和UniqueID等标签会被保存，但加载时会被替换。

palette: 包含多个命名调色板，推测是为了支持同一结构的多个变体。但目前只会保存和加载default调色板。

单个调色板（目前仅命名为default）。

block_palette: 方块状态列表。该列表包含方块索引引用的有序条目。

单个方块状态。

name: 方块的标识符，如minecraft:planks。 states: 方块的状态键值对。例如：wood_type:"acacia"、bite_counter:3、open_bit:1b。值的NBT类型与状态对应：枚举值为字符串，标量数字为整数，布尔值为字节。 version: 该方块的兼容版本号（撰写时为1.19版本，当前为17959425）。例如，17879555是十六进制01 10 D2 03，表示1.16.210.03。

block_position_data: 包含结构中单个方块的附加数据。每个键都是block_indices中方块扁平化列表的整数索引。层级未指定，因为无关紧要。

<index>: 单个附加方块数据，对应其索引位置的方块。

block_entity_data: 方块实体数据，以NBT格式存储，与世界文件中的方块实体完全相同。位置标签会被保存，但加载时会被替换。层级未指定，因为一个方块空间不能共存多个方块实体。

tick_queue_data: 包含一个或多个计划刻信息的复合标签。用于珊瑚死亡、水流等需要计划更新的方块。

单个待处理刻。

tick_delay: 该方块应被更新前剩余的刻数。目前似乎没有其他相关值存在。

structure_world_origin: 包含三个整数的列表，描述结构最初在世界中的保存位置。等于保存结构方块的位置加上其偏移设置。用于确定加载时实体的放置位置。实体的新绝对位置等于其旧位置减去这些值，再加上结构加载位置的原点。

结构原点X坐标。 结构原点Y坐标。 结构原点Z坐标。

如果...会发生什么 ​

测试修改结构文件加载后的结果：

• 如果size中的维度超过原版保存限制64*256*64，结构仍能正常加载。
• 如果方块层级列表中的值不是整数标签，所有值会被视为0。
• 如果方块层级列表中的值等于或大于调色板大小或小于-1，会放置空气方块。
• 如果default调色板不存在，加载结构不会放置任何方块。
• 如果任何具有固定名称的标签未指定或类型错误，结构加载失败并出现以下内容日志错误：

[Structure][error]-从行为包'<path>'加载结构'<identifier>'时失败 | 结构缺少必填字段"<tag>"。

• 如果block_indices不包含恰好两个值，结构加载失败并出现以下内容日志错误：

[Structure][error]-从行为包'<path>'加载结构'<identifier>'时失败 | "block_indices"字段应为包含2个数组的数组，但实际有<count>个数组。

• 如果block_indices中的值不是列表标签，结构加载失败并出现以下内容日志错误：

[Structure][error]-从行为包'<path>'加载结构'<identifier>'时失败 | "block_indices"字段的第一个数组缺失或不是列表。

• 如果block_indices中两个列表长度不等，结构加载失败并出现以下内容日志错误：

[Structure][error]-从行为包'<path>'加载结构'<identifier>'时失败 | "block_indices"字段的数组需要保持相同大小。

• 如果block_indices中两个列表的长度不等于结构各维度乘积，结构加载失败并出现以下内容日志错误：

[Structure][error]-从行为包'<path>'加载结构'<identifier>'时失败 | "block_indices"字段的元素数量应与"size"字段定义的尺寸相符。

NBT编辑器 ​

您可以在此处找到一些NBT编辑器的下载链接。

原始来源