Minecraft:Density function - Revision history

SyncBot: Sync: updated from Minecraft

2026-10-28T11:05:34Z

Sync: updated from Minecraft

← Older revision		Revision as of 11:05, 28 October 2026
Line 315:		Line 315:
	*** <code>repeat</code>: The gradient will be repeated outside its boundaries.		*** <code>repeat</code>: The gradient will be repeated outside its boundaries.
	*** <code>mirrored_repeat</code>: The gradient will be repeated as such that odd repetitions are mirrored, ensuring continuity between repetitions.		*** <code>mirrored_repeat</code>: The gradient will be repeated as such that odd repetitions are mirrored, ensuring continuity between repetitions.
	** {{nbt\|int\|from_coordinate}}: The coordinate at which the gradient starts.		** {{nbt\|int\|from_coordinate}}: The coordinate at which the gradient starts. A vertical anchor is acceptable if the {{cd\|axis}} is {{cd\|y}}.{{upcoming\|JE 26.4}}
	** {{nbt\|int\|to_coordinate}}: The coordinate at which the gradient ends. It must not equal {{cd\|from_coordinate}}.		** {{nbt\|int\|to_coordinate}}: The coordinate at which the gradient ends. It must not equal {{cd\|from_coordinate}}. A vertical anchor is acceptable if the {{cd\|axis}} is {{cd\|y}}.{{upcoming\|JE 26.4}}
	** {{nbt\|float\|from_value}}: The value at which the gradient starts.		** {{nbt\|float\|from_value}}: The value at which the gradient starts.
	** {{nbt\|float\|to_value}}: The value at which the gradient ends.		** {{nbt\|float\|to_value}}: The value at which the gradient ends.
Line 441:		Line 441:
	*** {{nbt\|string\|manhattan}}: (i.e. {{cd\|abs(dx) + abs(dy) + abs(dz)}})		*** {{nbt\|string\|manhattan}}: (i.e. {{cd\|abs(dx) + abs(dy) + abs(dz)}})
	*** {{nbt\|string\|chebyshev}}: (i.e. {{cd\|max(abs(dx), abs(dy), abs(dz))}})		*** {{nbt\|string\|chebyshev}}: (i.e. {{cd\|max(abs(dx), abs(dy), abs(dz))}})
			</div>

			=== {{cd\|domain_warp}} ===
			Samples an input function by applying an offset to each sampled coordinate.{{upcoming\|JE 26.4}}

			If the offsets change rapidly by a large amount, performance may degrade significantly. This function should be used sparingly.

			<div class="treeview">
			* {{nbt\|compound}}: Root object.
			** {{Nbt\|string\|type}}: The ID of the density function type (in this case, <code>domain_warp</code>).
			** {{Nbt\|string}}{{Nbt\|double\|input}}: {{json ref/density function}} — The input to sample.
			** {{nbt\|int-array\|offset_x}}: {{json ref/density function}} — The offset to apply to sampled X coordinates. The result is impliticly truncated to an integer. If not specified, it defaults to 0.0.
			** {{nbt\|int-array\|offset_y}}: {{json ref/density function}} — The offset to apply to sampled Y coordinates. The result is impliticly truncated to an integer. If not specified, it defaults to 0.0.
			** {{nbt\|int-array\|offset_z}}: {{json ref/density function}} — The offset to apply to sampled Z coordinates. The result is impliticly truncated to an integer. If not specified, it defaults to 0.0.
	</div>		</div>

Line 663:		Line 677:
	\|{{HistoryLine\|java upcoming}}		\|{{HistoryLine\|java upcoming}}
	\|{{HistoryLine\|\|26.4\|dev=snap5\|{{cd\|interpolated}} has been replaced with {{cd\|upscale}}.}}		\|{{HistoryLine\|\|26.4\|dev=snap5\|{{cd\|interpolated}} has been replaced with {{cd\|upscale}}.}}
			\|{{HistoryLine\|\|\|dev=snap6\|Added the {{cd\|domain_warp}} density function.
			\|The {{cd\|from_coordinate}} and {{cd\|to_coordinate}} fields in the {{cd\|gradient}} density function now accept a vertical anchor if the axis is Y.}}
	}}		}}

SyncBot: Sync: updated from Minecraft

2026-10-22T11:16:11Z

Sync: updated from Minecraft

← Older revision		Revision as of 11:16, 22 October 2026
Line 29:		Line 29:

	=== {{cd\|interpolated}} ===		=== {{cd\|interpolated}} ===
			{{until\|JE 26.4}}

	Interpolates at each block in one cell based on the input density function value of some cells around. The size of each cell is <code>size_horizontal * 4</code> and <code>size_vertical * 4</code>.		Interpolates at each block in one cell based on the input density function value of some cells around. The size of each cell is <code>size_horizontal * 4</code> and <code>size_vertical * 4</code>.
	<div class="treeview">		<div class="treeview">
Line 36:		Line 38:
	** {{nbt\|int\|cell_size_xz}}: Size in blocks of the interpolation grid cells on the X and Z axes. The number must not be negative.		** {{nbt\|int\|cell_size_xz}}: Size in blocks of the interpolation grid cells on the X and Z axes. The number must not be negative.
	** {{nbt\|int\|cell_size_y}}: Size in blocks of the interpolation grid cells on the Y axis. The number must not be negative.		** {{nbt\|int\|cell_size_y}}: Size in blocks of the interpolation grid cells on the Y axis. The number must not be negative.
			</div>

			=== {{cd\|upscale}} ===
			Samples the input function at a reduced resolution and upscales on each axis with the specified modes. Modes that require more samples will generally perform worse. Upscaling is peformed by axis in order of Z, X, then Y.{{upcoming\|JE 26.4}}

			<div class="treeview">
			* {{nbt\|compound}}: Root object.
			** {{nbt\|string\|type}}: The ID of the density function type (in this case, <code>upscale</code>).
			** {{Nbt\|string}}{{Nbt\|double\|input}}: {{json ref/density function}} — The input to sample.
			** {{nbt\|int-array\|point}}: {{cd\|[x, y, z]}}; the configuration for this axis.
			*** {{nbt\|string\|mode}}: one of:
			**** {{nbt\|int\|nearest_neighbor}}: Value is discontinuous across cell boundaries, with the gradient always at 0. The values at cell vertices will always be equal to the cell value. One sample per axis.
			**** {{nbt\|int\|interpolate_linear}}: Value is continuous, and the gradient is content with a cell but discontinuous across cell boundaries. The values at cell vertices will always be equal to the cell value. Two samples per axis.
			**** {{nbt\|int\|interpolate_cosine}}: Value and gradient are continuous, and the gradient is 0 at cell boundaries. The values at cell vertices will always be equal to the cell value. Two samples per axis.
			**** {{nbt\|int\|interpolate_cubic}}: Value and gradient are continuous. The values at cell vertices will always be equal to the cell value. Four samples per axis.
			**** {{nbt\|int\|b_spline_cubic}}: Value and gradient are continuous. The values at cell vertices do not necessarily need to equal to the cell value. Four samples per axis.
			*** {{nbt\|int\|cell_size}}: The size of each upscaling cell. Value between 1 and 64, inclusive.
	</div>		</div>

Line 642:		Line 661:
	* {{cd\|shifted_noise}}		* {{cd\|shifted_noise}}
	}}		}}
			\|{{HistoryLine\|java upcoming}}
			\|{{HistoryLine\|\|26.4\|dev=snap5\|{{cd\|interpolated}} has been replaced with {{cd\|upscale}}.}}
	}}		}}

	== Issues ==		== Issues ==
	{{issue list\|projects=MC}}		{{issue list\|projects=MC}}

	~~== References ==~~
	~~{{reflist}}~~

	== External links ==		== External links ==

SyncBot: Sync: updated from Minecraft

2026-09-17T11:12:58Z

Sync: updated from Minecraft

Show changes

SyncBot: Sync: updated from Minecraft

2026-09-16T11:17:39Z

Sync: updated from Minecraft

Show changes

SyncBot: Sync: updated from Minecraft

2026-09-08T11:04:00Z

Sync: updated from Minecraft

← Older revision		Revision as of 11:04, 8 September 2026
Line 510:		Line 510:
	** {{nbt\|int\|richness}}: The probability for an ore block or a raw ore block to be placed, as opposed to {{cd\|filler_block}}. If the value is 0 or lower, all blocks will be the filler block. If the value is 1 or greater, no blocks will be the filler block.		** {{nbt\|int\|richness}}: The probability for an ore block or a raw ore block to be placed, as opposed to {{cd\|filler_block}}. If the value is 0 or lower, all blocks will be the filler block. If the value is 1 or greater, no blocks will be the filler block.
	** {{nbt\|int\|filler_gap}}: Overrides {{cd\|richness}}; if the value is positive, {{cd\|filler_block}} will always be placed.		** {{nbt\|int\|filler_gap}}: Overrides {{cd\|richness}}; if the value is positive, {{cd\|filler_block}} will always be placed.
			</div>

	=== {{cd\|slice}} ===		=== {{cd\|slice}} ===

SyncBot: Sync: updated from Minecraft

2026-08-26T11:10:10Z

Sync: updated from Minecraft

← Older revision		Revision as of 11:10, 26 August 2026
Line 21:		Line 21:
	== Marker functions ==		== Marker functions ==
	=== {{cd\|cache_2d}} ===		=== {{cd\|cache_2d}} ===
			{{until\|JE 26.3}}
	Only computes the input density once per horizontal position.		Only computes the input density once per horizontal position.
	<div class="treeview">		<div class="treeview">
	* {{nbt\|compound}}: Root object.		* {{nbt\|compound}}: Root object.
	** {{Nbt\|string\|type}}: The ID of the density function type (in this case, <code>cache_2d</code>).		** {{Nbt\|string\|type}}: The ID of the density function type (in this case, <code>cache_2d</code>).
	** {{Nbt\|string}}{{Nbt\|double}}{{Nbt\|compound\|argument~~}}{{until\|JE 26.3}} / {{nbt\|double\|input}}{{upcoming\|JE 26.3~~}}: {{json ref/density function}} — The input to be cached.		** {{Nbt\|string}}{{Nbt\|double}}{{Nbt\|compound\|argument}}: {{json ref/density function}} — The input to be cached.
	</div>		</div>

	=== {{cd\|cache_all_in_cell}} ===		=== {{cd\|cache_all_in_cell}} ===
			{{until\|JE 26.3}}
	Used by the game onto <code>final_density</code> and should not be referenced in data packs.		Used by the game onto <code>final_density</code> and should not be referenced in data packs.
	<div class="treeview">		<div class="treeview">
	* {{nbt\|compound}}: Root object.		* {{nbt\|compound}}: Root object.
	** {{Nbt\|string\|type}}: The ID of the density function type (in this case, <code>cache_all_in_cell</code>).		** {{Nbt\|string\|type}}: The ID of the density function type (in this case, <code>cache_all_in_cell</code>).
	** {{Nbt\|string}}{{Nbt\|double}}{{Nbt\|compound\|argument~~}}{{until\|JE 26.3}} / {{nbt\|double\|input}}{{upcoming\|JE 26.3~~}}: {{json ref/density function}} — The input to be cached.		** {{Nbt\|string}}{{Nbt\|double}}{{Nbt\|compound\|argument}}: {{json ref/density function}} — The input to be cached.
	</div>		</div>

	=== {{cd\|cache_once}} ===		=== {{cd\|cache_once}} ===
	If this density function is referenced twice, it is only computed once per block position.		Renamed to {{cd\|cache}}.{{upcoming\|JE 26.3}} If this density function is referenced twice, it is only computed once per block position.
	<div class="treeview">		<div class="treeview">
	* {{nbt\|compound}}: Root object.		* {{nbt\|compound}}: Root object.
	** {{Nbt\|string\|type}}: The ID of the density function type (in this case, <code>cache_once</code>).		** {{Nbt\|string\|type}}: The ID of the density function type (in this case, <code>cache_once</code>{{until\|JE 26.3}} / <code>cache</code>{{upcoming\|JE 26.3}}).
	** {{Nbt\|string}}{{Nbt\|double}}{{Nbt\|compound\|argument}}{{until\|JE 26.3}} / {{nbt\|double\|input}}{{upcoming\|JE 26.3}}: {{json ref/density function}} — The input to be cached.		** {{Nbt\|string}}{{Nbt\|double}}{{Nbt\|compound\|argument}}{{until\|JE 26.3}} / {{nbt\|double\|input}}{{upcoming\|JE 26.3}}: {{json ref/density function}} — The input to be cached.
	</div>		</div>

	=== {{cd\|flat_cache}} ===		=== {{cd\|flat_cache}} ===
			{{until\|JE 26.3}}
	Calculate the value per 4×4 column (Value at each block in one column is the same). And it is calculated only once per column, at Y=0. Used often in combination with <code>interpolated</code>.		Calculate the value per 4×4 column (Value at each block in one column is the same). And it is calculated only once per column, at Y=0. Used often in combination with <code>interpolated</code>.
	<div class="treeview">		<div class="treeview">
	* {{nbt\|compound}}: Root object.		* {{nbt\|compound}}: Root object.
	** {{Nbt\|string\|type}}: The ID of the density function type (in this case, <code>flat_cache</code>).		** {{Nbt\|string\|type}}: The ID of the density function type (in this case, <code>flat_cache</code>).
	** {{Nbt\|string}}{{Nbt\|double}}{{Nbt\|compound\|argument~~}}{{until\|JE 26.3}} / {{nbt\|double\|input}}{{upcoming\|JE 26.3~~}}: {{json ref/density function}} — The input to be cached.		** {{Nbt\|string}}{{Nbt\|double}}{{Nbt\|compound\|argument}}: {{json ref/density function}} — The input to be cached.
	</div>		</div>

Line 58:		Line 61:
	** {{Nbt\|string\|type}}: The ID of the density function type (in this case, <code>interpolated</code>).		** {{Nbt\|string\|type}}: The ID of the density function type (in this case, <code>interpolated</code>).
	** {{Nbt\|string}}{{Nbt\|double}}{{Nbt\|compound\|argument}}{{until\|JE 26.3}} / {{nbt\|double\|input}}{{upcoming\|JE 26.3}}: {{json ref/density function}} — The input to be interpolated.		** {{Nbt\|string}}{{Nbt\|double}}{{Nbt\|compound\|argument}}{{until\|JE 26.3}} / {{nbt\|double\|input}}{{upcoming\|JE 26.3}}: {{json ref/density function}} — The input to be interpolated.
			** {{nbt\|int\|cell_size_xz}}{{upcoming\|JE 26.3}}: Size in blocks of the interpolation grid cells on the X and Z axes. The number must not be negative.
			** {{nbt\|int\|cell_size_y}}{{upcoming\|JE 26.3}}: Size in blocks of the interpolation grid cells on the Y axis. The number must not be negative.
	</div>		</div>

Line 71:		Line 76:
	** {{Nbt\|double\|xz_scale}}: Scales the X and Z before sampling.		** {{Nbt\|double\|xz_scale}}: Scales the X and Z before sampling.
	** {{Nbt\|double\|y_scale}}: Scales the Y before sampling.		** {{Nbt\|double\|y_scale}}: Scales the Y before sampling.
			** {{nbt\|double\|shift_x}}{{upcoming\|JE 26.3}}: Optional; A domain warp to apply on X. If not specified, no warping will be applied (equivalent to 0).
			** {{nbt\|double\|shift_y}}{{upcoming\|JE 26.3}}: Optional; A domain warp to apply on Y. If not specified, no warping will be applied (equivalent to 0).
			** {{nbt\|double\|shift_z}}{{upcoming\|JE 26.3}}: Optional; A domain warp to apply on Z. If not specified, no warping will be applied (equivalent to 0).
	</div>		</div>

Line 110:		Line 118:

	=== {{cd\|shifted_noise}} ===		=== {{cd\|shifted_noise}} ===
			{{until\|JE 26.3}}
	Similar to <code>noise</code>, but first shifts the input coordinates.		Similar to <code>noise</code>, but first shifts the input coordinates.
	<div class="treeview">		<div class="treeview">
Line 488:		Line 497:
	** {{Nbt\|int\|cell_height}}: The resolution of the scan. E.g. if set to <code>4</code>, then only every 4th block is checked.		** {{Nbt\|int\|cell_height}}: The resolution of the scan. E.g. if set to <code>4</code>, then only every 4th block is checked.
	</div>		</div>

			=== {{cd\|ore_vein}} ===
			{{upcoming\|JE 26.3}}
			<div class="treeview">
			* {{nbt\|compound}}: Root object.
			** {{Nbt\|string\|type}}: The ID of the density function type (in this case, <code>ore_vein</code>).
			** {{nbt\|string\|ore_block}}: The ore block to place.
			** {{nbt\|string\|raw_ore_block}}: The raw ore block to place.
			** {{nbt\|string\|filler_block}}: The filler block to place.
			** {{nbt\|float\|raw_ore_chance}}: The probability for a raw ore block to be placed instead of an ore block. Value between 0 and 1 (inclusive).
			** {{nbt\|int\|density}}: The probability for the ore vein to replace a block. If the value is 0 or lower, no block will be replaced.
			** {{nbt\|int\|richness}}: The probability for an ore block or a raw ore block to be placed, as opposed to {{cd\|filler_block}}. If the value is 0 or lower, all blocks will be the filler block. If the value is 1 or greater, no blocks will be the filler block.
			** {{nbt\|int\|filler_gap}}: Overrides {{cd\|richness}}; if the value is positive, {{cd\|filler_block}} will always be placed.

	=== {{cd\|slice}} ===		=== {{cd\|slice}} ===
Line 607:		Line 629:
	}}		}}
	\|{{HistoryLine\|\|\|dev=snap7\|Density functions are no longer evaluated with double-precision floating point values, but instead with single-precision.}}		\|{{HistoryLine\|\|\|dev=snap7\|Density functions are no longer evaluated with double-precision floating point values, but instead with single-precision.}}
			\|{{HistoryLine\|\|\|dev=snap10\|Added the {{cd\|ore_vein}} density function.
			\|{{cd\|cache_once}} has been renamed to {{cd\|cache}}.
			\|Added the {{cd\|shift_x}}, {{cd\|shift_y}}, and {{cd\|shift_z}} fields to the {{cd\|noise}} density function.
			\|Added the {{cd\|cell_size_xz}} and {{cd\|cell_size_y}} fields to the {{cd\|interpolated}} density function.
			\|Removed the following density functions:
			* {{cd\|cache_2d}}
			* {{cd\|cache_all_in_cell}}
			* {{cd\|flat_cache}}
			* {{cd\|shifted_noise}}
			}}
	}}		}}

SyncBot: Sync: updated from Minecraft

2026-08-05T11:10:03Z

Sync: updated from Minecraft

← Older revision		Revision as of 11:10, 5 August 2026
Line 606:		Line 606:
	\|{{cd\|y_clamped_gradient}} has been replaced with {{cd\|gradient}}.		\|{{cd\|y_clamped_gradient}} has been replaced with {{cd\|gradient}}.
	}}		}}
			\|{{HistoryLine\|\|\|dev=snap7\|Density functions are no longer evaluated with double-precision floating point values, but instead with single-precision.}}
	}}		}}

SyncBot: Sync: updated from Minecraft

2026-08-02T11:04:26Z

Sync: updated from Minecraft

← Older revision		Revision as of 11:04, 2 August 2026
Line 150:		Line 150:
	** {{nbt\|string}}{{nbt\|double}}{{nbt\|compound\|input}}: Density Function to round.		** {{nbt\|string}}{{nbt\|double}}{{nbt\|compound\|input}}: Density Function to round.
	** {{nbt\|string}}{{nbt\|double}}{{nbt\|compound\|multiple}}: The output will be rounded to an integer multiple of the value returned by this Density Function. If not specified, defaults to a constant 1.		** {{nbt\|string}}{{nbt\|double}}{{nbt\|compound\|multiple}}: The output will be rounded to an integer multiple of the value returned by this Density Function. If not specified, defaults to a constant 1.
			</div>

			=== {{cd\|clamp}} ===
			Clamps the input between two values.
			<div class="treeview">
			* {{nbt\|compound}}: Root object.
			** {{Nbt\|string\|type}}: The ID of the density function type (in this case, <code>clamp</code>).
			** {{nbt\|string}}{{nbt\|double}}{{nbt\|compound\|input}}: One density function — The input to clamp.
			** {{Nbt\|double\|min}}: The lower bound. Value between −1000000.0 and 1000000.0 (both inclusive).
			** {{Nbt\|double\|max}}: The upper bound. Value between −1000000.0 and 1000000.0 (both inclusive).
	</div>		</div>

Line 307:		Line 317:
	== Mapped density functions ==		== Mapped density functions ==
	These density functions map a set of values onto another set of values.		These density functions map a set of values onto another set of values.

	~~=== {{cd\|clamp}} ===~~
	~~Clamps the input between two values.~~
	~~<div class="treeview">~~
	* {{nbt\|compound}}: Root object.
	** {{Nbt\|string\|type}}: The ID of the density function type (in this case, <code>clamp</code>).
	** {{Nbt\|double}}{{Nbt\|compound\|input}}: One '''density function''' (a new {{Nbt\|double}}{{Nbt\|compound}} density function definition, an {{Nbt\|string\|}}[[Minecraft:resource location\|ID]] is not allowed here<ref>{{cite bug\|MC\|252814\|Clamp density function takes a direct input and doesn't allow a reference\|date=June 11, 2022}}</ref>) — The input to clamp.
	** {{Nbt\|double\|min}}: The lower bound. Value between −1000000.0 and 1000000.0 (both inclusive).
	** {{Nbt\|double\|max}}: The upper bound. Value between −1000000.0 and 1000000.0 (both inclusive).
	~~</div>~~

	=== {{cd\|gradient}} ===		=== {{cd\|gradient}} ===
	[[File:Gradient tiling.png\|thumb\|Demonstration of the different tiling options for the {{cd\|gradient}} density function{{upcoming\|JE 26.3}}, using both an input and output range of -1 to 1.]]		[[File:Gradient tiling.png\|thumb\|Demonstration of the different tiling options for the {{cd\|gradient}} density function{{upcoming\|JE 26.3}}, using both an input range of -100 to 100 and an output range of -1 to 1.]]
	Clamps the given coordinate and maps the gradient to a range.{{upcoming\|JE 26.3}}		Clamps the given coordinate and maps the gradient to a range.{{upcoming\|JE 26.3}}
	<div class="treeview">		<div class="treeview">
Line 456:		Line 456:

	=== {{cd\|distance_to_point}} ===		=== {{cd\|distance_to_point}} ===
			[[File:Distance to point options.png\|thumb\|Demonstration of the different metric options for the {{cd\|distance_to_point}} density function{{upcoming\|JE 26.3}}, using the distance from the point (0, 0).]]
	Computes the distance to a fixed point using the specified distance function.{{upcoming\|JE 26.3}}		Computes the distance to a fixed point using the specified distance function.{{upcoming\|JE 26.3}}

Line 581:		Line 582:
	Added fields to {{cd\|old_blended_noise}} density function: xz_scale, y_scale, xz_factor, y_factor, and smear_scale_multiplier.}}		Added fields to {{cd\|old_blended_noise}} density function: xz_scale, y_scale, xz_factor, y_factor, and smear_scale_multiplier.}}
	\|{{HistoryLine\|\|1.21.9\|dev=25w31a\|Added density functions {{cd\|minecraft:find_top_surface}} and {{cd\|minecraft:invert}}.}}		\|{{HistoryLine\|\|1.21.9\|dev=25w31a\|Added density functions {{cd\|minecraft:find_top_surface}} and {{cd\|minecraft:invert}}.}}
	\|{{HistoryLine\|\|26.2\|dev=snap5\|Added density function {{cd\|minecraft:interval_select}}.\|Removed density function {{cd\|minecraft:weird_scale_sampler}}. Its functionality has been replaced with {{cd\|interval_select}}.}}		\|{{HistoryLine\|\|26.2\|dev=snap1\|Density function {{cd\|minecraft:clamp}} can now take a density function ID as an input.}}
			\|{{HistoryLine\|\|\|dev=snap5\|Added density function {{cd\|minecraft:interval_select}}.\|Removed density function {{cd\|minecraft:weird_scale_sampler}}. Its functionality has been replaced with {{cd\|interval_select}}.}}
	\|{{HistoryLine\|java upcoming}}		\|{{HistoryLine\|java upcoming}}
	\|{{HistoryLine\|\|26.3\|dev=snap4\|Added the following density functions:		\|{{HistoryLine\|\|26.3\|dev=snap4\|Added the following density functions:

SyncBot: Sync: updated from Minecraft

2026-07-30T11:07:42Z

Sync: updated from Minecraft

Show changes

SyncBot: Sync: updated from Minecraft

2026-07-29T11:09:31Z

Sync: updated from Minecraft

Show changes

← Older revision		Revision as of 11:05, 28 October 2026
Line 315:		Line 315:
	*** <code>repeat</code>: The gradient will be repeated outside its boundaries.		*** <code>repeat</code>: The gradient will be repeated outside its boundaries.
	*** <code>mirrored_repeat</code>: The gradient will be repeated as such that odd repetitions are mirrored, ensuring continuity between repetitions.		*** <code>mirrored_repeat</code>: The gradient will be repeated as such that odd repetitions are mirrored, ensuring continuity between repetitions.
	** {{nbt\|int\|from_coordinate}}: The coordinate at which the gradient starts.		** {{nbt\|int\|from_coordinate}}: The coordinate at which the gradient starts. A vertical anchor is acceptable if the {{cd\|axis}} is {{cd\|y}}.{{upcoming\|JE 26.4}}
	** {{nbt\|int\|to_coordinate}}: The coordinate at which the gradient ends. It must not equal {{cd\|from_coordinate}}.		** {{nbt\|int\|to_coordinate}}: The coordinate at which the gradient ends. It must not equal {{cd\|from_coordinate}}. A vertical anchor is acceptable if the {{cd\|axis}} is {{cd\|y}}.{{upcoming\|JE 26.4}}
	** {{nbt\|float\|from_value}}: The value at which the gradient starts.		** {{nbt\|float\|from_value}}: The value at which the gradient starts.
	** {{nbt\|float\|to_value}}: The value at which the gradient ends.		** {{nbt\|float\|to_value}}: The value at which the gradient ends.
Line 441:		Line 441:
	*** {{nbt\|string\|manhattan}}: (i.e. {{cd\|abs(dx) + abs(dy) + abs(dz)}})		*** {{nbt\|string\|manhattan}}: (i.e. {{cd\|abs(dx) + abs(dy) + abs(dz)}})
	*** {{nbt\|string\|chebyshev}}: (i.e. {{cd\|max(abs(dx), abs(dy), abs(dz))}})		*** {{nbt\|string\|chebyshev}}: (i.e. {{cd\|max(abs(dx), abs(dy), abs(dz))}})
			</div>

			=== {{cd\|domain_warp}} ===
			Samples an input function by applying an offset to each sampled coordinate.{{upcoming\|JE 26.4}}

			If the offsets change rapidly by a large amount, performance may degrade significantly. This function should be used sparingly.

			<div class="treeview">
			* {{nbt\|compound}}: Root object.
			** {{Nbt\|string\|type}}: The ID of the density function type (in this case, <code>domain_warp</code>).
			** {{Nbt\|string}}{{Nbt\|double\|input}}: {{json ref/density function}} — The input to sample.
			** {{nbt\|int-array\|offset_x}}: {{json ref/density function}} — The offset to apply to sampled X coordinates. The result is impliticly truncated to an integer. If not specified, it defaults to 0.0.
			** {{nbt\|int-array\|offset_y}}: {{json ref/density function}} — The offset to apply to sampled Y coordinates. The result is impliticly truncated to an integer. If not specified, it defaults to 0.0.
			** {{nbt\|int-array\|offset_z}}: {{json ref/density function}} — The offset to apply to sampled Z coordinates. The result is impliticly truncated to an integer. If not specified, it defaults to 0.0.
	</div>		</div>

Line 663:		Line 677:
	\|{{HistoryLine\|java upcoming}}		\|{{HistoryLine\|java upcoming}}
	\|{{HistoryLine\|\|26.4\|dev=snap5\|{{cd\|interpolated}} has been replaced with {{cd\|upscale}}.}}		\|{{HistoryLine\|\|26.4\|dev=snap5\|{{cd\|interpolated}} has been replaced with {{cd\|upscale}}.}}
			\|{{HistoryLine\|\|\|dev=snap6\|Added the {{cd\|domain_warp}} density function.
			\|The {{cd\|from_coordinate}} and {{cd\|to_coordinate}} fields in the {{cd\|gradient}} density function now accept a vertical anchor if the axis is Y.}}
	}}		}}

← Older revision		Revision as of 11:04, 8 September 2026
Line 510:		Line 510:
	** {{nbt\|int\|richness}}: The probability for an ore block or a raw ore block to be placed, as opposed to {{cd\|filler_block}}. If the value is 0 or lower, all blocks will be the filler block. If the value is 1 or greater, no blocks will be the filler block.		** {{nbt\|int\|richness}}: The probability for an ore block or a raw ore block to be placed, as opposed to {{cd\|filler_block}}. If the value is 0 or lower, all blocks will be the filler block. If the value is 1 or greater, no blocks will be the filler block.
	** {{nbt\|int\|filler_gap}}: Overrides {{cd\|richness}}; if the value is positive, {{cd\|filler_block}} will always be placed.		** {{nbt\|int\|filler_gap}}: Overrides {{cd\|richness}}; if the value is positive, {{cd\|filler_block}} will always be placed.
			</div>

	=== {{cd\|slice}} ===		=== {{cd\|slice}} ===

← Older revision		Revision as of 11:10, 26 August 2026
Line 21:		Line 21:
	== Marker functions ==		== Marker functions ==
	=== {{cd\|cache_2d}} ===		=== {{cd\|cache_2d}} ===
			{{until\|JE 26.3}}
	Only computes the input density once per horizontal position.		Only computes the input density once per horizontal position.
	<div class="treeview">		<div class="treeview">
	* {{nbt\|compound}}: Root object.		* {{nbt\|compound}}: Root object.
	** {{Nbt\|string\|type}}: The ID of the density function type (in this case, <code>cache_2d</code>).		** {{Nbt\|string\|type}}: The ID of the density function type (in this case, <code>cache_2d</code>).
	** {{Nbt\|string}}{{Nbt\|double}}{{Nbt\|compound\|argument~~}}{{until\|JE 26.3}} / {{nbt\|double\|input}}{{upcoming\|JE 26.3~~}}: {{json ref/density function}} — The input to be cached.		** {{Nbt\|string}}{{Nbt\|double}}{{Nbt\|compound\|argument}}: {{json ref/density function}} — The input to be cached.
	</div>		</div>

	=== {{cd\|cache_all_in_cell}} ===		=== {{cd\|cache_all_in_cell}} ===
			{{until\|JE 26.3}}
	Used by the game onto <code>final_density</code> and should not be referenced in data packs.		Used by the game onto <code>final_density</code> and should not be referenced in data packs.
	<div class="treeview">		<div class="treeview">
	* {{nbt\|compound}}: Root object.		* {{nbt\|compound}}: Root object.
	** {{Nbt\|string\|type}}: The ID of the density function type (in this case, <code>cache_all_in_cell</code>).		** {{Nbt\|string\|type}}: The ID of the density function type (in this case, <code>cache_all_in_cell</code>).
	** {{Nbt\|string}}{{Nbt\|double}}{{Nbt\|compound\|argument~~}}{{until\|JE 26.3}} / {{nbt\|double\|input}}{{upcoming\|JE 26.3~~}}: {{json ref/density function}} — The input to be cached.		** {{Nbt\|string}}{{Nbt\|double}}{{Nbt\|compound\|argument}}: {{json ref/density function}} — The input to be cached.
	</div>		</div>

	=== {{cd\|cache_once}} ===		=== {{cd\|cache_once}} ===
	If this density function is referenced twice, it is only computed once per block position.		Renamed to {{cd\|cache}}.{{upcoming\|JE 26.3}} If this density function is referenced twice, it is only computed once per block position.
	<div class="treeview">		<div class="treeview">
	* {{nbt\|compound}}: Root object.		* {{nbt\|compound}}: Root object.
	** {{Nbt\|string\|type}}: The ID of the density function type (in this case, <code>cache_once</code>).		** {{Nbt\|string\|type}}: The ID of the density function type (in this case, <code>cache_once</code>{{until\|JE 26.3}} / <code>cache</code>{{upcoming\|JE 26.3}}).
	** {{Nbt\|string}}{{Nbt\|double}}{{Nbt\|compound\|argument}}{{until\|JE 26.3}} / {{nbt\|double\|input}}{{upcoming\|JE 26.3}}: {{json ref/density function}} — The input to be cached.		** {{Nbt\|string}}{{Nbt\|double}}{{Nbt\|compound\|argument}}{{until\|JE 26.3}} / {{nbt\|double\|input}}{{upcoming\|JE 26.3}}: {{json ref/density function}} — The input to be cached.
	</div>		</div>

	=== {{cd\|flat_cache}} ===		=== {{cd\|flat_cache}} ===
			{{until\|JE 26.3}}
	Calculate the value per 4×4 column (Value at each block in one column is the same). And it is calculated only once per column, at Y=0. Used often in combination with <code>interpolated</code>.		Calculate the value per 4×4 column (Value at each block in one column is the same). And it is calculated only once per column, at Y=0. Used often in combination with <code>interpolated</code>.
	<div class="treeview">		<div class="treeview">
	* {{nbt\|compound}}: Root object.		* {{nbt\|compound}}: Root object.
	** {{Nbt\|string\|type}}: The ID of the density function type (in this case, <code>flat_cache</code>).		** {{Nbt\|string\|type}}: The ID of the density function type (in this case, <code>flat_cache</code>).
	** {{Nbt\|string}}{{Nbt\|double}}{{Nbt\|compound\|argument~~}}{{until\|JE 26.3}} / {{nbt\|double\|input}}{{upcoming\|JE 26.3~~}}: {{json ref/density function}} — The input to be cached.		** {{Nbt\|string}}{{Nbt\|double}}{{Nbt\|compound\|argument}}: {{json ref/density function}} — The input to be cached.
	</div>		</div>

Line 58:		Line 61:
	** {{Nbt\|string\|type}}: The ID of the density function type (in this case, <code>interpolated</code>).		** {{Nbt\|string\|type}}: The ID of the density function type (in this case, <code>interpolated</code>).
	** {{Nbt\|string}}{{Nbt\|double}}{{Nbt\|compound\|argument}}{{until\|JE 26.3}} / {{nbt\|double\|input}}{{upcoming\|JE 26.3}}: {{json ref/density function}} — The input to be interpolated.		** {{Nbt\|string}}{{Nbt\|double}}{{Nbt\|compound\|argument}}{{until\|JE 26.3}} / {{nbt\|double\|input}}{{upcoming\|JE 26.3}}: {{json ref/density function}} — The input to be interpolated.
			** {{nbt\|int\|cell_size_xz}}{{upcoming\|JE 26.3}}: Size in blocks of the interpolation grid cells on the X and Z axes. The number must not be negative.
			** {{nbt\|int\|cell_size_y}}{{upcoming\|JE 26.3}}: Size in blocks of the interpolation grid cells on the Y axis. The number must not be negative.
	</div>		</div>

Line 71:		Line 76:
	** {{Nbt\|double\|xz_scale}}: Scales the X and Z before sampling.		** {{Nbt\|double\|xz_scale}}: Scales the X and Z before sampling.
	** {{Nbt\|double\|y_scale}}: Scales the Y before sampling.		** {{Nbt\|double\|y_scale}}: Scales the Y before sampling.
			** {{nbt\|double\|shift_x}}{{upcoming\|JE 26.3}}: Optional; A domain warp to apply on X. If not specified, no warping will be applied (equivalent to 0).
			** {{nbt\|double\|shift_y}}{{upcoming\|JE 26.3}}: Optional; A domain warp to apply on Y. If not specified, no warping will be applied (equivalent to 0).
			** {{nbt\|double\|shift_z}}{{upcoming\|JE 26.3}}: Optional; A domain warp to apply on Z. If not specified, no warping will be applied (equivalent to 0).
	</div>		</div>

Line 110:		Line 118:

	=== {{cd\|shifted_noise}} ===		=== {{cd\|shifted_noise}} ===
			{{until\|JE 26.3}}
	Similar to <code>noise</code>, but first shifts the input coordinates.		Similar to <code>noise</code>, but first shifts the input coordinates.
	<div class="treeview">		<div class="treeview">
Line 488:		Line 497:
	** {{Nbt\|int\|cell_height}}: The resolution of the scan. E.g. if set to <code>4</code>, then only every 4th block is checked.		** {{Nbt\|int\|cell_height}}: The resolution of the scan. E.g. if set to <code>4</code>, then only every 4th block is checked.
	</div>		</div>

			=== {{cd\|ore_vein}} ===
			{{upcoming\|JE 26.3}}
			<div class="treeview">
			* {{nbt\|compound}}: Root object.
			** {{Nbt\|string\|type}}: The ID of the density function type (in this case, <code>ore_vein</code>).
			** {{nbt\|string\|ore_block}}: The ore block to place.
			** {{nbt\|string\|raw_ore_block}}: The raw ore block to place.
			** {{nbt\|string\|filler_block}}: The filler block to place.
			** {{nbt\|float\|raw_ore_chance}}: The probability for a raw ore block to be placed instead of an ore block. Value between 0 and 1 (inclusive).
			** {{nbt\|int\|density}}: The probability for the ore vein to replace a block. If the value is 0 or lower, no block will be replaced.
			** {{nbt\|int\|richness}}: The probability for an ore block or a raw ore block to be placed, as opposed to {{cd\|filler_block}}. If the value is 0 or lower, all blocks will be the filler block. If the value is 1 or greater, no blocks will be the filler block.
			** {{nbt\|int\|filler_gap}}: Overrides {{cd\|richness}}; if the value is positive, {{cd\|filler_block}} will always be placed.

	=== {{cd\|slice}} ===		=== {{cd\|slice}} ===
Line 607:		Line 629:
	}}		}}
	\|{{HistoryLine\|\|\|dev=snap7\|Density functions are no longer evaluated with double-precision floating point values, but instead with single-precision.}}		\|{{HistoryLine\|\|\|dev=snap7\|Density functions are no longer evaluated with double-precision floating point values, but instead with single-precision.}}
			\|{{HistoryLine\|\|\|dev=snap10\|Added the {{cd\|ore_vein}} density function.
			\|{{cd\|cache_once}} has been renamed to {{cd\|cache}}.
			\|Added the {{cd\|shift_x}}, {{cd\|shift_y}}, and {{cd\|shift_z}} fields to the {{cd\|noise}} density function.
			\|Added the {{cd\|cell_size_xz}} and {{cd\|cell_size_y}} fields to the {{cd\|interpolated}} density function.
			\|Removed the following density functions:
			* {{cd\|cache_2d}}
			* {{cd\|cache_all_in_cell}}
			* {{cd\|flat_cache}}
			* {{cd\|shifted_noise}}
			}}
	}}		}}

← Older revision		Revision as of 11:04, 2 August 2026
Line 150:		Line 150:
	** {{nbt\|string}}{{nbt\|double}}{{nbt\|compound\|input}}: Density Function to round.		** {{nbt\|string}}{{nbt\|double}}{{nbt\|compound\|input}}: Density Function to round.
	** {{nbt\|string}}{{nbt\|double}}{{nbt\|compound\|multiple}}: The output will be rounded to an integer multiple of the value returned by this Density Function. If not specified, defaults to a constant 1.		** {{nbt\|string}}{{nbt\|double}}{{nbt\|compound\|multiple}}: The output will be rounded to an integer multiple of the value returned by this Density Function. If not specified, defaults to a constant 1.
			</div>

			=== {{cd\|clamp}} ===
			Clamps the input between two values.
			<div class="treeview">
			* {{nbt\|compound}}: Root object.
			** {{Nbt\|string\|type}}: The ID of the density function type (in this case, <code>clamp</code>).
			** {{nbt\|string}}{{nbt\|double}}{{nbt\|compound\|input}}: One density function — The input to clamp.
			** {{Nbt\|double\|min}}: The lower bound. Value between −1000000.0 and 1000000.0 (both inclusive).
			** {{Nbt\|double\|max}}: The upper bound. Value between −1000000.0 and 1000000.0 (both inclusive).
	</div>		</div>

Line 307:		Line 317:
	== Mapped density functions ==		== Mapped density functions ==
	These density functions map a set of values onto another set of values.		These density functions map a set of values onto another set of values.

	~~=== {{cd\|clamp}} ===~~
	~~Clamps the input between two values.~~
	~~<div class="treeview">~~
	* {{nbt\|compound}}: Root object.
	** {{Nbt\|string\|type}}: The ID of the density function type (in this case, <code>clamp</code>).
	** {{Nbt\|double}}{{Nbt\|compound\|input}}: One '''density function''' (a new {{Nbt\|double}}{{Nbt\|compound}} density function definition, an {{Nbt\|string\|}}[[Minecraft:resource location\|ID]] is not allowed here<ref>{{cite bug\|MC\|252814\|Clamp density function takes a direct input and doesn't allow a reference\|date=June 11, 2022}}</ref>) — The input to clamp.
	** {{Nbt\|double\|min}}: The lower bound. Value between −1000000.0 and 1000000.0 (both inclusive).
	** {{Nbt\|double\|max}}: The upper bound. Value between −1000000.0 and 1000000.0 (both inclusive).
	~~</div>~~

	=== {{cd\|gradient}} ===		=== {{cd\|gradient}} ===
	[[File:Gradient tiling.png\|thumb\|Demonstration of the different tiling options for the {{cd\|gradient}} density function{{upcoming\|JE 26.3}}, using both an input and output range of -1 to 1.]]		[[File:Gradient tiling.png\|thumb\|Demonstration of the different tiling options for the {{cd\|gradient}} density function{{upcoming\|JE 26.3}}, using both an input range of -100 to 100 and an output range of -1 to 1.]]
	Clamps the given coordinate and maps the gradient to a range.{{upcoming\|JE 26.3}}		Clamps the given coordinate and maps the gradient to a range.{{upcoming\|JE 26.3}}
	<div class="treeview">		<div class="treeview">
Line 456:		Line 456:

	=== {{cd\|distance_to_point}} ===		=== {{cd\|distance_to_point}} ===
			[[File:Distance to point options.png\|thumb\|Demonstration of the different metric options for the {{cd\|distance_to_point}} density function{{upcoming\|JE 26.3}}, using the distance from the point (0, 0).]]
	Computes the distance to a fixed point using the specified distance function.{{upcoming\|JE 26.3}}		Computes the distance to a fixed point using the specified distance function.{{upcoming\|JE 26.3}}

Line 581:		Line 582:
	Added fields to {{cd\|old_blended_noise}} density function: xz_scale, y_scale, xz_factor, y_factor, and smear_scale_multiplier.}}		Added fields to {{cd\|old_blended_noise}} density function: xz_scale, y_scale, xz_factor, y_factor, and smear_scale_multiplier.}}
	\|{{HistoryLine\|\|1.21.9\|dev=25w31a\|Added density functions {{cd\|minecraft:find_top_surface}} and {{cd\|minecraft:invert}}.}}		\|{{HistoryLine\|\|1.21.9\|dev=25w31a\|Added density functions {{cd\|minecraft:find_top_surface}} and {{cd\|minecraft:invert}}.}}
	\|{{HistoryLine\|\|26.2\|dev=snap5\|Added density function {{cd\|minecraft:interval_select}}.\|Removed density function {{cd\|minecraft:weird_scale_sampler}}. Its functionality has been replaced with {{cd\|interval_select}}.}}		\|{{HistoryLine\|\|26.2\|dev=snap1\|Density function {{cd\|minecraft:clamp}} can now take a density function ID as an input.}}
			\|{{HistoryLine\|\|\|dev=snap5\|Added density function {{cd\|minecraft:interval_select}}.\|Removed density function {{cd\|minecraft:weird_scale_sampler}}. Its functionality has been replaced with {{cd\|interval_select}}.}}
	\|{{HistoryLine\|java upcoming}}		\|{{HistoryLine\|java upcoming}}
	\|{{HistoryLine\|\|26.3\|dev=snap4\|Added the following density functions:		\|{{HistoryLine\|\|26.3\|dev=snap4\|Added the following density functions: