区块格式

Template:Translation：未知参数。 区块（Chunks）以16*256*16立方块为单位存储地形和实体信息。区块也会同时储存预处理的光照、等高线数据及其他元数据信息。

NBT结构

区块使用NBT格式储存，遵循以下结构组成（详见下面方块格式了解每组阵列中的方块排序）

根标签
- DataVersion：该区块NBT结构的版本
- Level：区块数据
  - xPos：该区块的X坐标
  - zPos：该区块的Z坐标
  - LastUpdate：自该区块上次更新以来经过的刻。
  - InhabitedTime：玩家已在该区块的总刻数。注意该值在多个玩家处于同一区块时会增长得更快。用于区域难度：增加带有一些装备的生物的生成几率，生物自带的盔甲附有附魔效果的机率，生成带有药水效果蜘蛛的几率，生成拥有捡起物品能力的生物的几率以及决定僵尸被攻击时生成其他僵尸的几率。该值大于等于3600000时，区域难度会最大程度影响该区块。在0及以下时，难度等级被限制到最低（虽然该值设置为负数时会被设置为0，但是把该值回归到正数还是要花时间的）。详见区域难度获取更多信息。
  - Biomes：256字节的生物群系信息，有些区块可能不具备该信息。区块内垂直的一列占用一字节空间，生物群系ID可在数据值页面查看。如果这个数组不存在，游戏在加载和保存区块时会自动根据世界的种子添加并赋值；若数组内任何数值为“-1”，游戏也会根据正确信息改正。
  - HeightMaps：对应256个值均被压缩为9位（0-256）的几个不同的高度数据。
    - LIGHT_BLOCKING：最高的透明度不为0的方块^{[失效：Lua错误：bad argument #1 to 'lc' (string expected, got nil)。]}（在18w45a中被移除）。
    - MOTION_BLOCKING：最高的能阻挡移动或含有液体的方块。
    - MOTION_BLOCKING_NO_LEAVES：最高的阻挡移动、含有液体或在minecraft:leaves标签里的方块。
    - OCEAN_FLOOR：最高的非空气固体方块。
    - OCEAN_FLOOR_WG：最高的既不是空气也不包含液体的方块。此值用于世界生成。
    - WORLD_SURFACE：最高的非空气方块。
    - WORLD_SURFACE_WG：最高的非空气方块。此值用于世界生成。
  - CarvingMasks:
    - AIR:
    - LIQUID:
  - Sections：一组复合标签，每个标签都包含一组子区块的描述。
    - 一个独立的子区块。
      - Y：这个子区块的Y索引（不是坐标）。范围为0到15（从低到高），没有重复，然而子区块若为空时可能会缺失。
      - Palette：几组在区块中用到的方块状态。
        ：方块状态
        Name：方块ID
        
        Properties：方块状态属性列表，name字段是方块状态属性的名称。
        Name：方块属性的名称以及它的值。
      - BlockLight：2048字节记录了每个方块发出的亮度。使加载时间相较于重新计算变得更快。每方块占用4字节。
      - BlockStates：一个64位长的变量，能够存储4096个索引的数组。索引的顺序对应Sections中Palette元素的顺序。在Section中的所有索引大小相同，其大小需要表示最大的索引（最小为4位）。若此索引不能被64整除，其位数会继续增加。
      - SkyLight：2048字节记录了阳光和月光打在每个方块上的亮度。每方块占用4字节。
  - Entities：该列表的每个TAG_Compound 都定义了该区块里的实体。详见下面的实体格式。如果该列表为空，则该标签则为一个字节列表标签。
  - TileEntities：在该列表的每个TAG_Compound 都定义了该区块里的实体。详见下面的实体格式。如果该列表为空，该列表将会是个结束标签的列表（1.10版本以前为字节标签）。
  - TileTicks：可能不存在。每个在该列表的 TAG_Compound 标签都是该区块中的一个等待更新的“活跃”方块。它们用于保存红石机械的状态、掉落的沙子或水以及其他活动。详见下面的附加刻格式。这个标签可能不存在。
  - LiquidTicks:
  - Lights：一个拥有16个列表的列表。
  - LiquidsToBeTicked：一个拥有16个列表的列表。
  - ToBeTicked：一个拥有16个列表的列表。
  - PostProcessing：一个拥有16个列表的列表。
  - Status：是这些值的其中之一：empty、base、carved、liquid_carved、decorated、lighted、mobs_spawned、finalized、fullchunk、或postprocessed。
  - Structures：
    - References：
      - 结构名称：
    - Starts：
      - 结构名称：只存储能在当前维度生成的结构，如末地城只会保存在末地区块里。
        ChunkX：结构的起始X坐标。如果ID为INVALID则无此字段。
        
        ChunkZ：结构的起始Z坐标。如果ID为INVALID则无此字段。
        
        id：如果在此区块里没有此类型的结构，此值为“INVALID”，否则为结构的名称。
        
        biome：结构所在的生物群系的ID。如果ID为INVALID则无此字段。
        
        BB：整个结构的边界。该值有6个整数：最小X、Y和Z坐标以及最大X、Y和Z坐标。如果ID为INVALID则无此字段。
        
        Valid：1或0（true/false）-（仅限村庄）村庄是否至少生成了3条不是路的结构。如果ID为INVALID则无此字段。
        
        Processed：（仅限遗迹）已创建部分结构的区块列表。如果ID为INVALID则无此字段。
        
        X：该区块的X坐标。
        
        Z：该区块的Z坐标。
        
        Children：组成此结构的子结构。如果ID为INVALID则无此字段。
        ：子结构数据。
        id：子结构ID。一般是大量缩写代码而不是易懂的代码。
        
        Rot：海底遗迹与沉船的方向。有效值为：COUNTERCLOCKWISE_90、NONE、CLOCKWISE_90和CLOCKWISE_180。
        
        BiomeType：此遗迹所处的海洋的温度。有效值是WARM和COLD。
        
        Template：海底遗迹或沉船用到的模板。
        
        integrity:该结构的完整度（仅用于海底遗迹）。
        
        TPX：该海底遗迹或沉船的X坐标起始点。
        
        TPY：该海底遗迹或沉船的Y坐标起始点。
        
        TPZ：该海底遗迹或沉船的Z坐标起始点。
        
        isLarge：1或0（true/false） - 若此海底遗迹是大型遗迹则为true。
        
        GD：似乎是一种测量该子结构与起始点距离的方式。
        
        O：可能是子结构的朝向。
        
        BB：子结构的边界。（不包括悬在道路上方的村庄屋顶）值为6个整数：最小X、Y和Z坐标以及最大X、Y、Z坐标。
        
        Width：（神殿和小屋）结构的宽度（X/Z）。
        
        Height：（神殿和小屋）结构的高度（Y）。
        
        Depth：（神殿和小屋）结构的深度（X/Z）。
        
        HPos：（神殿和小屋）为将结构放置在地面上而移动到的Y高度。若该结构未被移动则为-1。
        
        placedTrap1：1或0（true/false）-（丛林神庙）是否放置了走廊发射器发射箭的陷阱。
        
        placedTrap2：1或0（true/false）-（丛林神庙）是否放置了箱子发射器发射箭的陷阱。
        
        placedMainChest：1或0（true/false）-（丛林神庙）是否放置了主箱子。
        
        placedHiddenChest：1或0（true/false）-（丛林神庙）是否放置了隐藏箱子。
        
        hasPlacedChest0：1或0（true/false）-（沙漠神殿）是否放置了箱子。
        
        hasPlacedChest1：1或0（true/false）-（沙漠神殿）是否放置了箱子。
        
        hasPlacedChest2：1或0（true/false）-（沙漠神殿）是否放置了箱子。
        
        hasPlacedChest3：1或0（true/false）-（沙漠神殿）是否放置了箱子。
        
        Witch：1或0（true/false）-（沼泽小屋）是否已经在这小屋里生成女巫。
        
        sc：1或0（true/false）-（废弃矿井“MSCorridor”）走廊是否有蜘蛛网。
        
        hr：1或0（true/false）-（废弃矿井“MSCorridor”）走廊是否有铁轨。
        
        hps：1或0（true/false）-（废弃矿井“MSCorridor”）走廊是否有一个洞穴蜘蛛刷怪箱。
        
        Num：（废弃矿井“MSCorridor”）走廊长度。
        
        tf：1或0（true/false）-（“MSCrossing”）路口是否为两层高。
        
        D: （废弃矿井“MSCrossing”）指示路口“即将到来”的方向。
        
        Entrances：（废弃矿井“MSRoom”）房间出口列表。
        ：出口的边界。
        
        Chest：1或0（true/false）-（下界要塞“NeSCLT”和“NeSCRT”）该要塞子结构是否应该有一个箱子但其尚未生成。（要塞“SHCC”）该要塞子结构是否放置了箱子。（村庄“ViS”）在铁匠铺里是否已经生成了箱子。
        
        Mob：1或0（true/false）-（下界要塞"NeMT"）该要塞子结构是否应该有一个烈焰人刷怪箱但其尚未生成。（要塞“SHPR”）蠹虫刷怪箱是否生成在该子结构里。
        
        Seed：（下界要塞“NeBEF”）断桥结构的随机数种子。
        
        EntryDoor：（要塞）进入该子结构的门的类型。
        
        Steps：（要塞“SHFC”）走廊长度
        
        leftLow：1或0（true/false）-（要塞“SH5C”）在五通道路口中是否在下面向上的楼梯中有一个出口。
        
        rightLow：1或0（true/false）-（要塞“SH5C”）在五通道路口中是否在上面向上的楼梯中有一个出口。
        
        leftHigh：1或0（true/false）-（要塞“SH5C”）在五通道路口中是否在下面向下的楼梯中有一个出口。
        
        rightHigh：1或0（true/false）-（要塞“SH5C”）在五通道路口中是否在上面向下的楼梯中有一个出口。
        
        Tall：1或0（true/false）-（要塞“SHLi”）图书馆是否有通往上方的楼梯。
        
        Type：（要塞“SHRC”）指示房间里是否有一根插上了火把的柱子、一个喷泉、有一个箱子的向上的楼梯或只是一个空房间。
        
        Source：1或0（true/false）-（要塞“SHSD”）螺旋楼梯是否是要塞原本的或是随机生成的。
        
        Left：1或0（true/false）-（Stronghold "SHS"）是否在走廊左侧有一个开口。
        
        Right：1或0（true/false）-（Stronghold "SHS"）是否在走廊右侧有一个开口。
        
        Type：（村庄）村庄类型：0=平原、1=沙漠、2=热带草原、3=针叶林。
        
        Zombie：1或0（true/false）-（村庄）是否把该村庄生成为僵尸村庄。
        
        VCount：（村庄）在这个村庄生成的村民数量。
        
        HPos：（村庄）为把村庄放在地面上而移动至的Y坐标。若其未被移动则此值为-1。
        
        CA：（村庄“ViF”和“ViDF”）在耕地格子里的作物。
        Name：方块ID
        
        Properties：方块状态属性列表，[name]是方块状态属性的名称。
        Name：方块状态名称以及它的值。
        
        CB：（村庄“ViF”和“ViDF”）在耕地格子里的作物。
        Name：方块ID
        
        Properties：方块状态属性列表，[name]是方块状态属性的名称。
        Name：方块状态名称以及它的值。
        
        CC：（村庄“ViDF”）在耕地格子里的作物。
        Name：方块ID
        
        Properties：方块状态属性列表，[name]是方块状态属性的名称。
        Name：方块状态名称以及它的值。
        
        CD：（村庄“ViDF”）在耕地格子里的作物。
        Name：方块ID
        
        Properties：方块状态属性列表，[name]是方块状态属性的名称。
        Name：方块状态名称以及它的值。
        
        Terrace：1或0（true/false）-（村庄“ViSH”）屋子是否有通向屋顶和栅栏的梯子。
        
        T：（村庄“ViSmH”）桌子：0为无桌子，1和2会把桌子放在屋子的两边。
        
        C：（村庄“ViSmH”）屋顶类型。
        
        Length：（村庄“ViSR”）道路长度。

方块格式

此段落需要更新。

段落中某些信息已经不符合当前版本情况。

在Anvil文件格式中, 方块的位置被按照YZX来排序以此达到压缩的目的。

坐标系如下：

X 增加向东，减少向西；
Y 增加向上，减少向下；
Z 增加向南，减少向北。

这也发生在产生最自然的扫描方向上，因为所有在最少有效维度里（例如在这种情况下是X轴）的索引都出现为每个在下一个最有效维度里的索引。因此读取一个排序为YZX的数组像读一本头朝北放置的书，所有的字母（或X索引）同一时间都在一条线上（或Z索引），并且所有的线同一时间都在一页纸（或Y索引）上。对于二维数组（如“Biomes”和“HeightMap”），不适用的Y维度被简单地忽略了，好像书本只有一页厚那样。

在区块里的每个子区块是一个16x16x16格的区域，一个区块至多有16个子区块。子区块0是区块最底下的子区块，子区块15是区块最高的子区块。为了节省空间，完全为空的子区块不会被保存。在每个子区块里由一个“Y”字节标签用于索引子区块，0到15和用于方块的字节数组组成。“Blocks”字节数组拥有4096个局部方块ID，每个方块占用8个字节。另一个字节数组“Add”是用来存储方块ID高于255的方块，长度为2048字节，用来储存4096个方块ID的其他部分，每个方块占用4个字节。当“Blocks”和“Add”字节数组同时存在时，在“Add”数组的局部ID被左移位8个字节并添加到“Blocks”数组的局部ID中以组成真实的方块ID。“Data”字节数组长度也是2048字节，但可储存4096个方块数据值，每个方块占用4个字节。“BlockLight”和“SkyLight”字节数组与“Data”字节数组相同，但这两个字节数组是用来分别储存方块亮度等级和天空亮度等级的。“SkyLight”的值代表了日光或月光有多少能到达方块，这取决于当前天空的亮度等级。

长度为2048字节数组的字节顺序（如“Add”、“Data”、“BlockLight”和“SkyLight”）为每个方块仅给予4个字节，它似乎是一个异常的例外，否则它们一致为大数据存储格式的标准格式。它也运行计数器以转化为大概自然的可读印刷方向。如果方块在0开始，它们在奇数之前被偶数分组（如0和1共享一个字节、2和3共享下一个字节如此类推）。根据这些指示，Minecraft在至少有效的半字节里储存偶数方块，在最高有效字节里储存奇数方块。因此，block[0]是在0x0F的byte[0]，block[1]是在0xF0的byte[0]，block[2]是在0x0F的byte[1]，block[3]是在0xF0的byte[1]，如此类推。

下面的伪代码显示了如何从一个子区块中获取单个方块的信息。鼠标移到文本上面以查看附加信息或注释。

byte Nibble4(byte[] arr, int index){ return index%2 == 0 ? arr[index/2]&0x0F : (arr[index/2]>>4)&0x0F; }
int BlockPos = y*16*16 + z*16 + x;
byte BlockID_a = Blocks[BlockPos];
byte BlockID_b = Nibble4(Add, BlockPos);
short BlockID = BlockID_a + (BlockID_b << 8);
byte BlockData = Nibble4(Data, BlockPos);
byte Blocklight = Nibble4(BlockLight, BlockPos);
byte Skylight = Nibble4(SkyLight, BlockPos);

实体格式

每个实体是一个包含在区块文件的实体列表中的一个 TAG_Compound（协议标签）。唯一例外的是玩家（Player）实体，它储存在level.dat，或者在服务器文件中的<player>.dat。

实体数据

- Air：当前实体所剩的空气值。在空气中充满至300，折算为生物淹没在水中15秒后生物才开始窒息，如该实体生命值为20点，那么实体在35秒后才会死亡。如果此项小于等于0时实体在水中，那么其每秒会受到1点伤害。
- CustomName：当前实体的自定义名称的JSON文本。会出现在玩家的死亡信息与村民的交易界面，以及玩家的光标指向的实体的上方。可能不存在。
- CustomNameVisible：如果为true且实体拥有自定义名称，那么名称会总是显示在它们上方，而不受光标指向的影响。若实体并没有自定义名称，显示的则是默认的名称。可能不存在。
- FallDistance：当前实体已经坠落的距离。值越大，实体落地时对其造成伤害更多。
- Fire：距离火熄灭剩余的时间刻数。负值表示当前实体能够在火中站立而不着火的时间，未着火时默认为-20。
- Glowing：表示实体是否有发光的轮廓线。可能不存在。
- HasVisualFire：如果为true，那么实体会看起来已着火，但实际上可能未着火。可能不存在。
- Invulnerable：如果为true，那么当前实体不会受到除虚空伤害外的任何伤害，但这些实体仍然会被处于创造模式的玩家伤害到。此项对于生物与非生物实体的作用是类似的：生物不会受到任何来源（包括药水）的伤害，无法被钓鱼竿、攻击、爆炸或者抛射物推动；除支持物被移除外，诸如载具的物件都不会被摧毁。
- Motion：当前实体的速度，单位是米/每刻。
  - ：X轴速度分量。
  - ：Y轴速度分量。
  - ：Z轴速度分量。
- NoGravity：如果为true，实体在空中不会坠落，在盔甲架上的效果却是使 Motion标签将失去效果。可能不存在。
- OnGround：表示实体是否正在接触地面。
- Passengers：正在骑乘当前实体的实体的数据。两个实体都能控制移动，被刷怪笼召唤时生成条件由最上方的实体决定。
  - ：一个乘客。
    - 详见实体格式。
- PortalCooldown：距离当前实体可以再次穿过下界传送门向回传送的时间刻数。在初次传送后，起始值为300刻（15秒）并逐渐倒计时至0。
- Pos：当前实体的坐标。
  - ：X轴坐标。
  - ：Y轴坐标。
  - ：Z轴坐标。
- Rotation：实体的旋转角度。
  - ：当前实体以Y轴为中心，俯视时顺时针的角度（即偏转角）。正南方为0。不会超过360度。
  - ：当前实体与水平面之间的倾斜角（即俯仰角）。水平面为0，正值表示面朝下方，相反则为上方。不超过正负90度。
- Silent：表示当前实体是否不会发出任何声音。可能不存在。
- Tags：自定义的记分板标签数据。可能不存在。
  - ：一项记分板标签。
- TicksFrozen：实体的冷冻时间，不小于0。当实体在细雪中时每刻增加1，离开细雪则每刻减少2。可能不存在。
- UUID：实体的UUID，用4个32位整数表示，按从高位到低位的顺序存储。

生物

生物实体
实体ID	名称
bat	蝙蝠
blaze	烈焰人
cat	猫
cave_spider	洞穴蜘蛛
chicken	鸡
cod	鳕鱼
cow	牛
creeper	苦力怕
dolphin	海豚
donkey	驴
drowned	溺尸
elder_guardian	远古守卫者
ender_dragon	末影龙
enderman	末影人
endermite	末影螨
evoker	唤魔者
ghast	恶魂
giant	巨人
guardian	守卫者
horse	马
husk	尸壳
illusioner	幻术师
iron_golem	铁傀儡
llama	羊驼
magma_cube	岩浆怪
mooshroom	哞菇
mule	骡
ocelot	豹猫
panda	熊猫
parrot	鹦鹉
phantom	幻翼
pig	猪
pillager	掠夺者
polar_bear	北极熊
pufferfish	河豚
rabbit	兔子
ravager	劫掠兽
salmon	鲑鱼
sheep	羊
shulker	潜影贝
silverfish	蠹虫
skeleton	骷髅
skeleton_horse	骷髅马
slime	史莱姆
snow_golem	雪傀儡
spider	蜘蛛
squid	鱿鱼
stray	流浪者
trader_llama	行商羊驼
tropical_fish	热带鱼
turtle	海龟
vex	恼鬼
villager	村民
vindicator	卫道士
wandering_trader	流浪商人
witch	女巫
wither	凋灵
wither_skeleton	凋灵骷髅
wolf	狼
zombie	僵尸
zombie_horse	僵尸马
zombie_pigman	僵尸猪人
zombie_villager	僵尸村民
fox	狐狸

每个生物都有额外的标签来储存它们的血量、状态、效果。玩家是生物的一个子类。

蝙蝠

Java版：

实体数据
- 实体共通标签
- 活体共通标签
- 生物共通标签
- BatFlags：表示蝙蝠是否正在倒挂在方块下面。

弹射物实体
实体ID	名称
arrow	射出的箭
dragon_fireball	末影龙火球
ender_pearl	丢出的末影珍珠
egg	丢出的蛋
fireball	恶魂火球
llama_spit	羊驼的口水
potion	丢出的喷溅药水
small_fireball	烈焰人火球/火焰弹
shulker_bullet	潜影贝导弹
snowball	丢出的雪球
spectral_arrow	光灵箭
trident	三叉戟
wither_skull	凋灵之首
xp_bottle	丢出的附魔之瓶

交通工具实体
实体 ID	实体名称
Boat	船
~~Minecart~~ （已弃用）	矿车运输矿车动力矿车
chest_minecart	运输矿车
furnace_minecart	动力矿车
spawner_minecart	刷怪箱矿车
tnt_minecart	TNT矿车
hopper_minecart	漏斗矿车
commandblock_minecart	命令方块矿车

Dynamic Tile Entities
实体ID	实体名称
tnt	点燃的TNT
falling_block	掉落中的方块

其他实体
实体ID	名称
area_effect_cloud	区域效果云
armor_stand	盔甲架
ender_crystal	末影水晶
evocation_fangs	尖牙
eye_of_ender_signal	末影之眼
fireworks_rocket	烟花火箭
item_frame	物品展示框
leash_knot	拴绳结
painting	画
shulker_bullet	潜影贝导弹
	钓鱼竿浮标

二进制	整数	结果
2^0	1	禁用添加或改变主手物品
2^1	2	禁用添加或改变靴子物品
2^2	4	禁用添加或改变护腿物品
2^3	8	禁用添加或改变胸甲物品
2^4	16	禁用添加或改变头盔物品
2^5	32	禁用添加或改变副手物品
2^8	256	禁用移除或改变主手物品
2^9	512	禁用移除或改变靴子物品
2^10	1024	禁用移除或改变护腿物品
2^11	2048	禁用移除或改变胸甲物品
2^12	4096	禁用移除或改变头盔物品
2^13	8192	禁用移除或改变副手物品
2^16	65536	禁用添加主手物品
2^17	131072	禁用添加靴子物品
2^18	262144	禁用添加护腿物品
2^19	524288	禁用添加胸甲物品
2^20	1048576	禁用添加头盔物品
2^21	2097152	禁用添加副手物品

方块实体
方块实体ID	对应方块
banner	旗帜
barrel	木桶
beacon	信标
bed	床
bell	钟
blast_furnace	高炉
brewing_stand	酿造台
campfire	营火
cauldron	炼药锅^{[仅BE和LCE]}
chest	箱子陷阱箱
comparator	红石比较器
command_block	命令方块
conduit	潮涌核心
daylight_detector	阳光传感器
dispenser	发射器
dropper	投掷器
enchanting_table	附魔台
ender_chest	末影箱
end_gateway	末地折跃门方块
end_portal	末地传送门方块
furnace	熔炉
hopper	漏斗
jigsaw	拼图方块
jukebox	唱片机
lectern	讲台
mob_spawner	刷怪箱
piston	移动中的活塞
shulker_box	潜影盒
sign	告示牌
skull	头颅
smoker	烟熏炉
structure_block	结构方块

数据值		描述
Dec	Hex	描述
0	0x0	白色床
1	0x1	橙色床
2	0x2	品红色床
3	0x3	淡蓝色床
4	0x4	黄色床
5	0x5	黄绿色床
6	0x6	粉红色床
7	0x7	灰色床
8	0x8	淡灰色床
9	0x9	青色床
10	0xA	紫色床
11	0xB	蓝色床
12	0xC	棕色床
13	0xD	绿色床
14	0xE	红色床
15	0xF	黑色床

物品实体
实体名	名称
item	掉落的物品
xp_orb	经验球

Minecraft Wiki

区块格式

NBT结构

方块格式

实体格式

生物

猫的皮肤种类

项圈颜色

基因

鹦鹉的颜色

潜影贝颜色

村民种类

村民职业

项圈颜色

僵尸村民种类

僵尸村民职业

狐狸种类

弹射物

物品和经验球

交通工具

动态方块

其他

禁用部位

方块实体值格式

附加刻格式

历史

参考

Fan Feed