Minecraft:Placed feature - Revision history

SyncBot: Sync: updated from Minecraft

2026-09-23T11:23:55Z

Sync: updated from Minecraft

← Older revision		Revision as of 11:23, 23 September 2026
Line 66:		Line 66:
	<div class="treeview" id="fixed_placement" style="margin-top: 1em;">		<div class="treeview" id="fixed_placement" style="margin-top: 1em;">
	* '''fixed_placement''' — Returns all specified positions, if they are in the current chunk.		* '''fixed_placement''' — Returns all specified positions, if they are in the current chunk.
	** {{nbt\|list\|positions}}: A list of all placement positions		** {{nbt\|list\|positions}}: A list of all placement positions. Requires at least one element.{{upcoming\|JE 26.4}}
	*** {{nbt\|list}}: A position		*** {{nbt\|list}}: A position
	**** {{nbt\|int}}: x coordinate		**** {{nbt\|int}}: x coordinate
Line 149:		Line 149:
	\|{{HistoryLine\|\|\|dev=snap3\|Added {{cd\|cuboid}} and {{cd\|random_chance}} placement modifiers.}}		\|{{HistoryLine\|\|\|dev=snap3\|Added {{cd\|cuboid}} and {{cd\|random_chance}} placement modifiers.}}
	\|{{HistoryLine\|\|\|dev=snap8\|Added the {{cd\|randomly_selected}} placement modifier.}}		\|{{HistoryLine\|\|\|dev=snap8\|Added the {{cd\|randomly_selected}} placement modifier.}}
			\|{{HistoryLine\|java upcoming}}
			\|{{HistoryLine\|\|26.4\|dev=snap1\|The {{cd\|xz_size}} and {{cd\|y_size}} fields in {{cd\|cuboid}} have been adjusted to represent the actual size of the cuboid, instead of implicitly being 1 block larger.
			\|The {{cd\|positions}} field in {{cd\|fixed_placement}} now requires at least one element.}}
	}}		}}

SyncBot: Sync: updated from Minecraft

2026-09-17T11:19:17Z

Sync: updated from Minecraft

← Older revision		Revision as of 11:19, 17 September 2026
Line 102:		Line 102:
	</div>		</div>

	<div class="treeview" id="~~random_chance~~" style="margin-top: 1em;">		<div class="treeview" id="offset" style="margin-top: 1em;">
	* ~~'''random_chance''' — Gates the feature being placed behind a random chance.~~		* '''offset''' — Applies an offset to the current position.
	** {{nbt\|float}}{{nbt\|compound\|chance}}: Value between 0 and 1 representing the chance that the feature gets placed.
	~~</div>~~

	~~<div class="treeview" id="random_offset" style="margin-top: 1em;">~~
	* '''random_offset'''{{until\|JE 26.3}} / '''offset''' — Applies an offset to the current position. Contrary to its name, the applied offset is only random if the specified integer provider isn't a constant. In other words, a y_spread of -12 will always offset the placed feature downwards by 12 blocks. Also note that the even though the x and z axes share the same integer provider, they are sampled individually, so, for example, if a <code>uniform</code> type integer provider is used for the xz_spread with a min of 4 and a max of 16, the x offset could be 12 while the z offset could be 5. Specifying unique X and Z values isn't possible.
	** {{nbt\|int}}{{nbt\|compound\|xz_spread}}{{until\|JE 26.3}}: Value between -16 and 16 (inclusive).
	*** {{nbt inherit/int_provider}}
	** {{nbt\|int}}{{nbt\|compound\|y_spread}}{{until\|JE 26.3}}: Value between -16 and 16 (inclusive).
	*** {{nbt inherit/int_provider}}
	** {{nbt\|int}}{{nbt\|compound\|x}}: Value between -16 and 16 (inclusive).		** {{nbt\|int}}{{nbt\|compound\|x}}: Value between -16 and 16 (inclusive).
	** {{nbt\|int}}{{nbt\|compound\|y}}: Value between -16 and 16 (inclusive).		** {{nbt\|int}}{{nbt\|compound\|y}}: Value between -16 and 16 (inclusive).
	** {{nbt\|int}}{{nbt\|compound\|z}}: Value between -16 and 16 (inclusive).		** {{nbt\|int}}{{nbt\|compound\|z}}: Value between -16 and 16 (inclusive).
	*** {{nbt inherit/int_provider}}		*** {{nbt inherit/int_provider}}
			</div>

			<div class="treeview" id="random_chance" style="margin-top: 1em;">
			* '''random_chance''' — Gates the feature being placed behind a random chance.
			** {{nbt\|float}}{{nbt\|compound\|chance}}: Value between 0 and 1 representing the chance that the feature gets placed.
	</div>		</div>

SyncBot: Sync: updated from Minecraft

2026-09-16T11:31:39Z

Sync: updated from Minecraft

SyncBot: Sync: updated from Minecraft

2026-08-13T11:12:42Z

Sync: updated from Minecraft

← Older revision		Revision as of 11:12, 13 August 2026
Line 117:		Line 117:
	** {{nbt\|int}}{{nbt\|compound\|z}}{{upcoming\|JE 26.3}}: Value between -16 and 16 (inclusive).		** {{nbt\|int}}{{nbt\|compound\|z}}{{upcoming\|JE 26.3}}: Value between -16 and 16 (inclusive).
	*** {{nbt inherit/int_provider}}		*** {{nbt inherit/int_provider}}
			</div>

			<div class="treeview" id="randomly_selected" style="margin-top: 1em;">
			* '''randomly_selected'''{{upcoming\|JE 26.3}} — Randomly selects a placement modifier from a list and delegates placement to it.
			** {{nbt\|list\|placements}}: Non-empty list of placements modifiers to pick from.
	</div>		</div>

Line 148:		Line 153:
	\|Added {{cd\|offset}} fields {{cd\|x}}, {{cd\|y}} and {{cd\|z}}.}}		\|Added {{cd\|offset}} fields {{cd\|x}}, {{cd\|y}} and {{cd\|z}}.}}
	\|{{HistoryLine\|\|\|dev=snap3\|Added {{cd\|cuboid}} and {{cd\|random_chance}} placement modifiers.}}		\|{{HistoryLine\|\|\|dev=snap3\|Added {{cd\|cuboid}} and {{cd\|random_chance}} placement modifiers.}}
			\|{{HistoryLine\|\|\|dev=snap8\|Added the {{cd\|randomly_selected}} placement modifier.}}
	}}		}}

SyncBot: Sync: updated from Minecraft

2026-07-08T11:14:33Z

Sync: updated from Minecraft

← Older revision		Revision as of 11:14, 8 July 2026
Line 43:		Line 43:
	** {{nbt\|int}}{{nbt\|compound\|count}}：Count on each layer. Value between 0 and 256 (inclusive).		** {{nbt\|int}}{{nbt\|compound\|count}}：Count on each layer. Value between 0 and 256 (inclusive).
	*** {{nbt inherit/int_provider}}		*** {{nbt inherit/int_provider}}
			</div>

			<div class="treeview" id="cuboid" style="margin-top: 1em;">
			* '''cuboid'''{{upcoming\|JE 26.3}} — Repeats a feature in a cuboid shape.
			** {{nbt\|int}}{{nbt\|compound\|xz_size}}: The size of the cuboid along the x and z axes. Value between 1 and 16 (inclusive).
			** {{nbt\|int}}{{nbt\|compound\|y_size}}: The size of the cuboid along the y axis. Value between 1 and 16 (inclusive).
			*** {{nbt inherit/int_provider}}
			** {{nbt\|boolean}}{{nbt\|compound\|include_interior}}: Optional; Whether to place interior blocks of the cuboid. Defaults to {{cd\|true}}.
			** {{nbt\|boolean}}{{nbt\|compound\|include_edges}}: Optional; Whether to place edge blocks of the cuboid. Defaults to {{cd\|true}}. If set to {{cd\|false}}, the cuboid is generated as "somewhat rounded".<ref>{{mcnet\|minecraft-26-3-snapshot-3\|Minecraft 26.3 Snapshot 3\|July 7, 2026\|Java Team}}</ref>
	</div>		</div>

Line 91:		Line 100:
	** {{nbt\|int\|below_noise}}: The count when the noise is below the threshold. Value lower than 0 is treated as 0.		** {{nbt\|int\|below_noise}}: The count when the noise is below the threshold. Value lower than 0 is treated as 0.
	** {{nbt\|int\|above_noise}}: The count when the noise is above the threshold. Value lower than 0 is treated as 0.		** {{nbt\|int\|above_noise}}: The count when the noise is above the threshold. Value lower than 0 is treated as 0.
			</div>

			<div class="treeview" id="random_chance" style="margin-top: 1em;">
			* '''random_chance'''{{upcoming\|JE 26.3}} — Gates the feature being placed behind a random chance.
			** {{nbt\|float}}{{nbt\|compound\|chance}}: Value between 0 and 1 representing the chance that the feature gets placed.
	</div>		</div>

Line 133:		Line 147:
	\|Removed {{cd\|offset}} fields {{cd\|xz_spread}} and {{cd\|y_spread}}.		\|Removed {{cd\|offset}} fields {{cd\|xz_spread}} and {{cd\|y_spread}}.
	\|Added {{cd\|offset}} fields {{cd\|x}}, {{cd\|y}} and {{cd\|z}}.}}		\|Added {{cd\|offset}} fields {{cd\|x}}, {{cd\|y}} and {{cd\|z}}.}}
			\|{{HistoryLine\|\|\|dev=snap3\|Added {{cd\|cuboid}} and {{cd\|random_chance}} placement modifiers.}}
	}}		}}

Line 142:		Line 157:
	** {{nbt\|string\|step}}: The carving step. Either <code>air</code> or <code>liquid</code>. 'Liquid'-type carvers are not used in vanilla.		** {{nbt\|string\|step}}: The carving step. Either <code>air</code> or <code>liquid</code>. 'Liquid'-type carvers are not used in vanilla.
	</div>		</div>

			== References ==
			{{reflist}}

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

SyncBot: Sync: updated from Minecraft

2026-07-05T11:11:07Z

Sync: updated from Minecraft

Show changes

SyncBot: Sync: updated from Minecraft

2026-04-30T11:13:29Z

Sync: updated from Minecraft

← Older revision		Revision as of 11:13, 30 April 2026
Line 126:		Line 126:
	{{HistoryTable		{{HistoryTable
	\|{{HistoryLine\|java}}		\|{{HistoryLine\|java}}
	\|{{HistoryLine\|\|1.18\|dev=pre1\|Introduced placed features, stored in {{cd\|worldgen/placed_feature}} directory}}		\|{{HistoryLine\|\|1.18\|dev=pre1\|Introduced placed features, stored in {{cd\|worldgen/placed_feature}} directory.}}
	\|{{HistoryLine\|\|1.21\|dev=pre2\|Added ~~{{cd\|~~fixed_placement}} placement modifier}}		\|{{HistoryLine\|\|1.21\|dev=pre2\|Added '''fixed_placement''' placement modifier.}}
	\|{{HistoryLine\|\|1.21.2\|dev=24w33a\|Removed ~~{{cd\|~~carving_mask}} placement modifier}}\|{{HistoryLine\|\|26.1\|dev=pre3\|Changed the maximum value of {{cd\|~~count~~}} ~~field from~~ {{cd\|count}} placement modifier to 4096}}}}		\|{{HistoryLine\|\|1.21.2\|dev=24w33a\|Removed '''carving_mask''' placement modifier.}}
			\|{{HistoryLine\|\|26.1\|dev=pre3\|Changed the maximum value of {{nbt\|int}}{{nbt\|compound\|count}} field from '''count''' placement modifier to 4096.}}
			}}

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

SyncBot: Sync: updated from Minecraft

2026-04-27T11:14:42Z

Sync: updated from Minecraft

← Older revision		Revision as of 11:14, 27 April 2026
Line 25:		Line 25:
	<div class="treeview" id="biome" style="margin-top: 1em;">		<div class="treeview" id="biome" style="margin-top: 1em;">
	* '''biome'''—Returns the current position if the biome at that position includes this placed feature, otherwise returns empty. No additional field. In effect, this predicate restricts features from being placed outside the edges of any biome that generates the feature. This modifier type cannot be used in placed features that are referenced from other configured features (for example, from entries in a random_selector type feature). Minecraft does not catch this type of error automatically on trying to load the world; instead the game runs normally until it tries to generate the feature, which causes the game to crash.		* '''biome'''—Returns the current position if the biome at that position includes this placed feature, otherwise returns empty. No additional field. In effect, this predicate restricts features from being placed outside the edges of any biome that generates the feature. This modifier type cannot be used in placed features that are referenced from other configured features (for example, from entries in a random_selector type feature). Minecraft does not catch this type of error automatically on trying to load the world; instead the game runs normally until it tries to generate the feature, which causes the game to crash.
			</div>

			<div class="treeview" id="block_predicate_filter" style="margin-top: 1em;">
	* '''block_predicate_filter'''—Returns the current position when the predicate is passed, otherwise return empty.		* '''block_predicate_filter'''—Returns the current position when the predicate is passed, otherwise return empty.
	** {{nbt\|compound\|predicate}}: The [[Minecraft:block predicate]] to test.		** {{nbt\|compound\|predicate}}: The [[Minecraft:block predicate]] to test.

SyncBot: Sync: updated from Minecraft

2026-04-21T11:09:06Z

Sync: updated from Minecraft

← Older revision		Revision as of 11:09, 21 April 2026
Line 36:		Line 36:

	<div class="treeview" id="count" style="margin-top: 1em;">		<div class="treeview" id="count" style="margin-top: 1em;">
	* '''count'''—Returns multiple copies of the current block position. Although the count is limited to ~~256~~, multiple count predicates can be used, allowing them to be stacked multiplicatively to achieve much higher values.		* '''count'''—Returns multiple copies of the current block position. Although the count is limited to 4096, multiple count predicates can be used, allowing them to be stacked multiplicatively to achieve much higher values.
	** {{nbt\|int}}{{nbt\|compound\|count}}: Value between 0 and ~~256~~ (inclusive).		** {{nbt\|int}}{{nbt\|compound\|count}}: Value between 0 and 4096 (inclusive).
	*** {{nbt inherit/int_provider}}		*** {{nbt inherit/int_provider}}
	</div>		</div>

SyncBot: Sync: updated from Minecraft

2026-04-15T11:14:09Z

Sync: updated from Minecraft

← Older revision		Revision as of 11:14, 15 April 2026
Line 121:		Line 121:

	== History ==		== History ==
	~~{{Expand section}}~~
	{{HistoryTable		{{HistoryTable
	\|{{HistoryLine\|java}}		\|{{HistoryLine\|java}}
	\|{{HistoryLine\|\|?\|Introduced placed features}}		\|{{HistoryLine\|\|1.18\|dev=pre1\|Introduced placed features, stored in {{cd\|worldgen/placed_feature}} directory}}
	\|{{HistoryLine\|\|1.21\|dev=pre2\|Added {{cd\|fixed_placement}} placement modifier}}		\|{{HistoryLine\|\|1.21\|dev=pre2\|Added {{cd\|fixed_placement}} placement modifier}}
	}}		\|{{HistoryLine\|\|1.21.2\|dev=24w33a\|Removed {{cd\|carving_mask}} placement modifier}}\|{{HistoryLine\|\|26.1\|dev=pre3\|Changed the maximum value of {{cd\|count}} field from {{cd\|count}} placement modifier to 4096}}}}

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

← Older revision		Revision as of 11:23, 23 September 2026
Line 66:		Line 66:
	<div class="treeview" id="fixed_placement" style="margin-top: 1em;">		<div class="treeview" id="fixed_placement" style="margin-top: 1em;">
	* '''fixed_placement''' — Returns all specified positions, if they are in the current chunk.		* '''fixed_placement''' — Returns all specified positions, if they are in the current chunk.
	** {{nbt\|list\|positions}}: A list of all placement positions		** {{nbt\|list\|positions}}: A list of all placement positions. Requires at least one element.{{upcoming\|JE 26.4}}
	*** {{nbt\|list}}: A position		*** {{nbt\|list}}: A position
	**** {{nbt\|int}}: x coordinate		**** {{nbt\|int}}: x coordinate
Line 149:		Line 149:
	\|{{HistoryLine\|\|\|dev=snap3\|Added {{cd\|cuboid}} and {{cd\|random_chance}} placement modifiers.}}		\|{{HistoryLine\|\|\|dev=snap3\|Added {{cd\|cuboid}} and {{cd\|random_chance}} placement modifiers.}}
	\|{{HistoryLine\|\|\|dev=snap8\|Added the {{cd\|randomly_selected}} placement modifier.}}		\|{{HistoryLine\|\|\|dev=snap8\|Added the {{cd\|randomly_selected}} placement modifier.}}
			\|{{HistoryLine\|java upcoming}}
			\|{{HistoryLine\|\|26.4\|dev=snap1\|The {{cd\|xz_size}} and {{cd\|y_size}} fields in {{cd\|cuboid}} have been adjusted to represent the actual size of the cuboid, instead of implicitly being 1 block larger.
			\|The {{cd\|positions}} field in {{cd\|fixed_placement}} now requires at least one element.}}
	}}		}}

← Older revision		Revision as of 11:31, 16 September 2026
Line 46:		Line 46:

	<div class="treeview" id="cuboid" style="margin-top: 1em;">		<div class="treeview" id="cuboid" style="margin-top: 1em;">
	* '''cuboid'''~~{{upcoming\|JE 26.3}}~~ — Repeats a feature in a cuboid shape.		* '''cuboid''' — Repeats a feature in a cuboid shape.
	** {{nbt\|int}}{{nbt\|compound\|xz_size}}: The size of the cuboid along the x and z axes. Value between 1 and 16 (inclusive).		** {{nbt\|int}}{{nbt\|compound\|xz_size}}: The size of the cuboid along the x and z axes. Value between 1 and 16 (inclusive).
	** {{nbt\|int}}{{nbt\|compound\|y_size}}: The size of the cuboid along the y axis. Value between 1 and 16 (inclusive).		** {{nbt\|int}}{{nbt\|compound\|y_size}}: The size of the cuboid along the y axis. Value between 1 and 16 (inclusive).
Line 103:		Line 103:

	<div class="treeview" id="random_chance" style="margin-top: 1em;">		<div class="treeview" id="random_chance" style="margin-top: 1em;">
	* '''random_chance'''~~{{upcoming\|JE 26.3}}~~ — Gates the feature being placed behind a random chance.		* '''random_chance''' — Gates the feature being placed behind a random chance.
	** {{nbt\|float}}{{nbt\|compound\|chance}}: Value between 0 and 1 representing the chance that the feature gets placed.		** {{nbt\|float}}{{nbt\|compound\|chance}}: Value between 0 and 1 representing the chance that the feature gets placed.
	</div>		</div>

	<div class="treeview" id="random_offset" style="margin-top: 1em;">		<div class="treeview" id="random_offset" style="margin-top: 1em;">
	* '''random_offset'''{{until\|JE 26.3}} / '''offset'''~~{{upcoming\|JE 26.3}}~~ — Applies an offset to the current position. Contrary to its name, the applied offset is only random if the specified integer provider isn't a constant. In other words, a y_spread of -12 will always offset the placed feature downwards by 12 blocks. Also note that the even though the x and z axes share the same integer provider, they are sampled individually, so, for example, if a <code>uniform</code> type integer provider is used for the xz_spread with a min of 4 and a max of 16, the x offset could be 12 while the z offset could be 5. Specifying unique X and Z values isn't possible.		* '''random_offset'''{{until\|JE 26.3}} / '''offset''' — Applies an offset to the current position. Contrary to its name, the applied offset is only random if the specified integer provider isn't a constant. In other words, a y_spread of -12 will always offset the placed feature downwards by 12 blocks. Also note that the even though the x and z axes share the same integer provider, they are sampled individually, so, for example, if a <code>uniform</code> type integer provider is used for the xz_spread with a min of 4 and a max of 16, the x offset could be 12 while the z offset could be 5. Specifying unique X and Z values isn't possible.
	** {{nbt\|int}}{{nbt\|compound\|xz_spread}}{{until\|JE 26.3}}: Value between -16 and 16 (inclusive).		** {{nbt\|int}}{{nbt\|compound\|xz_spread}}{{until\|JE 26.3}}: Value between -16 and 16 (inclusive).
	*** {{nbt inherit/int_provider}}		*** {{nbt inherit/int_provider}}
	** {{nbt\|int}}{{nbt\|compound\|y_spread}}{{until\|JE 26.3}}: Value between -16 and 16 (inclusive).		** {{nbt\|int}}{{nbt\|compound\|y_spread}}{{until\|JE 26.3}}: Value between -16 and 16 (inclusive).
	*** {{nbt inherit/int_provider}}		*** {{nbt inherit/int_provider}}
	** {{nbt\|int}}{{nbt\|compound\|x~~}}{{upcoming\|JE 26.3~~}}: Value between -16 and 16 (inclusive).		** {{nbt\|int}}{{nbt\|compound\|x}}: Value between -16 and 16 (inclusive).
	** {{nbt\|int}}{{nbt\|compound\|y~~}}{{upcoming\|JE 26.3~~}}: Value between -16 and 16 (inclusive).		** {{nbt\|int}}{{nbt\|compound\|y}}: Value between -16 and 16 (inclusive).
	** {{nbt\|int}}{{nbt\|compound\|z~~}}{{upcoming\|JE 26.3~~}}: Value between -16 and 16 (inclusive).		** {{nbt\|int}}{{nbt\|compound\|z}}: Value between -16 and 16 (inclusive).
	*** {{nbt inherit/int_provider}}		*** {{nbt inherit/int_provider}}
	</div>		</div>

	<div class="treeview" id="randomly_selected" style="margin-top: 1em;">		<div class="treeview" id="randomly_selected" style="margin-top: 1em;">
	* '''randomly_selected'''~~{{upcoming\|JE 26.3}}~~ — Randomly selects a placement modifier from a list and delegates placement to it.		* '''randomly_selected''' — Randomly selects a placement modifier from a list and delegates placement to it.
	** {{nbt\|list\|placements}}: Non-empty list of placements modifiers to pick from.		** {{nbt\|list\|placements}}: Non-empty list of placements modifiers to pick from.
	</div>		</div>
Line 148:		Line 148:
	\|{{HistoryLine\|\|1.21.2\|dev=24w33a\|Removed {{cd\|carving_mask}} placement modifier.}}		\|{{HistoryLine\|\|1.21.2\|dev=24w33a\|Removed {{cd\|carving_mask}} placement modifier.}}
	\|{{HistoryLine\|\|26.1\|dev=pre3\|Changed the maximum value of {{nbt\|int}}{{nbt\|compound\|count}} field from {{cd\|count}} placement modifier to 4096.}}		\|{{HistoryLine\|\|26.1\|dev=pre3\|Changed the maximum value of {{nbt\|int}}{{nbt\|compound\|count}} field from {{cd\|count}} placement modifier to 4096.}}
	~~\|{{HistoryLine\|java upcoming}}~~
	\|{{HistoryLine\|\|26.3\|dev=snap2\|Renamed {{cd\|random_offset}} to {{cd\|offset}}.		\|{{HistoryLine\|\|26.3\|dev=snap2\|Renamed {{cd\|random_offset}} to {{cd\|offset}}.
	\|Removed {{cd\|offset}} fields {{cd\|xz_spread}} and {{cd\|y_spread}}.		\|Removed {{cd\|offset}} fields {{cd\|xz_spread}} and {{cd\|y_spread}}.