SyncBot: Sync: new page from Minecraft

2026-05-18T11:07:47Z

Sync: new page from Minecraft

New page

{{about|the heightmaps of chunk terrain|the heightmaps controlling three-dimensional textures|Texture set}}
{{Missing information|Heightmaps {{in|be}}<br><small>Note: Heightmaps do exist {{in|be}}, this is confirmed by feature placement behavior packs which can use <code>"y": "query.heightmap(variable.worldx, variable.worldz)"</code> in the distribution to place a feature on the surface, but no other information about heightmaps has been found.</small>}}

'''Heightmaps''' are maps to store the Y-level of the highest block at each horizontal coordinate. They are stored in chunk files and used for various game calculations.

== Motion blocking ==
The last four heightmaps are based on a property called motion blocking. This is defined as follows:

* [[Minecraft:Cobweb|Cobwebs]] and [[Minecraft:Bamboo Sapling|bamboo saplings]] are considered not motion blocking.
* The block must be "solid". On [[Minecraft:Java Edition]], this is defined using the [[Minecraft:Legacy solid]] property. Note that this is not the same as having a collision box. Some blocks like snow [[Minecraft:Azalea|azaleas]] are not considered solid while having a collision box, and other blocks like [[Minecraft:Banner|banners]] are considered solid while having no collision box.

== Types ==
Several different heightmaps check and store highest block of different types, and are used for different purposes. {{IN|java}}, there are six heightmap types:

* <code>WORLD_SURFACE</code>: Stores the Y-level of the highest non-air (all types of air) block.
* <code>WORLD_SURFACE_WG</code>: Stores the Y-level of the highest non-air (all types of air) block. Used only during world generation.
* <code>OCEAN_FLOOR</code>: Stores the Y-level of the highest block whose [[Minecraft:material]] blocks motion. Used only on the server side.
* <code>OCEAN_FLOOR_WG</code>: Stores the Y-level of the highest block whose material blocks motion. Used only during world generation.
* <code>MOTION_BLOCKING</code>: Stores the Y-level of the highest block whose material blocks motion or blocks that contains a fluid ([[Minecraft:water]], [[Minecraft:lava]], or [[Minecraft:waterlogged]] blocks).
* <code>MOTION_BLOCKING_NO_LEAVES</code>: Stores the Y-level of the highest block whose material blocks motion, or blocks that contains a fluid (water, lava, or waterlogged blocks), except various [[Minecraft:leaves]]. Used only on the server side, e.g. for pillager patrol spawning.

== Usage ==
Heightmaps are used for various in-game calculations. For example, a lightning rod can only be triggered when there is no non-air block above it. Therefore, the game compares the Y-level of lightning rod with heightmap WORLD_SURFACE to know if there are non-air blocks above it.

Heightmaps of both server side and client side can be seen in [[Minecraft:debug screen]]. The "CH" line is the value in client side heightmaps at the player's current X/Z coordinates. The "SH" line is the server side value in heightmaps at the player's current X/Z coordinates. In the two lines:
* S means WORLD_SURFACE
* O means OCEAN_FLOOR
* M means MOTION_BLOCKING
* ML means MOTION_BLOCKING_NO_LEAVES

{{cmd|execute positioned over}} can change the execution position of the command to one block above the Y-level stored in the specified heightmap. WORLD_SURFACE_WG and OCEAN_FLOOR_WG cannot be used in this command.

== Navigation ==
{{Navbox Java Edition technical|general}}

[[Minecraft:fr:Champ de hauteur]]
[[Minecraft:ja:高度マップ]]
[[Minecraft:pt:Heightmap]]
[[Minecraft:zh:高度图]]

Minecraft:Heightmap - Revision history

SyncBot: Sync: new page from Minecraft