Minecraft:Density function - Revision history

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

SyncBot: Sync: updated from Minecraft

2026-07-17T11:06:14Z

Sync: updated from Minecraft

Show changes

SyncBot: Sync: updated from Minecraft

2026-06-17T11:09:54Z

Sync: updated from Minecraft

@@ Line 1: / Line 1: @@
 {{Exclusive|java}}
 '''Density functions''' make up mathematical expressions to obtain a number from a position, stored as [[Minecraft:JSON]] files within a [[Minecraft:data pack]] in the path <code>data/<namespace>/worldgen/density_function</code>. They are referenced from the [[Minecraft:noise router]] in [[Minecraft:noise settings]].
@@ Line 212: / Line 213: @@
 ** {{Nbt|string|type}}: The ID of the density function type (in this case, <code>end_islands</code>).
 </div>
 === shifted_noise ===
@@ Line 387: / Line 357: @@
 ** {{Nbt|string}}{{Nbt|double}}{{Nbt|compound|weirdness}}: {{json ref/density function}}
 </div>
 == History ==
@@ Line 397: / Line 399: @@
 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||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}}.}}
 }}

← 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: