SyncBot: Sync: updated from Minecraft

2026-08-05T11:20:25Z

Sync: updated from Minecraft

← Older revision		Revision as of 11:20, 5 August 2026
Line 37:		Line 37:
	* {{cd\|octave_count}}		* {{cd\|octave_count}}
	}}		}}
			\|{{HistoryLine\|\|\|dev=snap7\|Noises are no longer evaluated with double-precision floating point values, but instead with single-precision.}}
	}}		}}

SyncBot: Sync: new page from Minecraft

2026-07-29T11:15:26Z

Sync: new page from Minecraft

New page

{{for|sounds that make noise|Sound}}
{{Exclusive|java}}
[[File:Continentalness noise map.png|thumb|An example sample of the minecraft:continentalness noise]]

A '''noise''' is a technical [[Minecraft:JSON]] file that can be referenced by a [[Minecraft:density function]] and [[Minecraft:surface rule]]. They are stored within a [[Minecraft:data pack]] in the folder {{cd|data/<''namespace''>/worldgen/noise}}.

In addition to being called by density functions and surface rules, there are also some noises with hard-coded usage:
* {{code|minecraft:surface}}: Affects the surface layer thickness in surface rules.
* {{code|minecraft:surface_secondary}}: Used as the thickness of additional surface layer in surface rules.
* {{code|minecraft:clay_bands_offset}}: Used to generate badland terracotta bands in {{code|bandlands}} surface rules.
* {{code|minecraft:badlands_pillar}}, {{code|minecraft:badlands_pillar_roof}}, {{code|minecraft:badlands_surface}}: Used when generating badland [[Minecraft:Terrain_features#Hoodoo|hoodoo]]s in {{cd|minecraft:eroded_badlands}} biome.
* {{code|minecraft:iceberg_pillar}}, {{code|minecraft:iceberg_pillar_roof}}, {{code|minecraft:iceberg_surface}}: Used when generating iceberg [[Minecraft:terrain feature]] in {{cd|minecraft:frozen_ocean}} and {{cd|minecraft:deep_frozen_ocean}} biomes.

== JSON format ==

<div class="treeview">
* {{nbt|compound}}: Root object.
** {{Nbt|int|firstOctave}}{{until|JE 26.3}} / {{nbt|int|base_octave}}{{upcoming|JE 26.3}}: First octave. If {{nbt|bool|legacy_random_source}} in the noise settings is true, it must be an integer less than or equal to 1, otherwise the value range is not unlimited.
** {{Nbt|list|amplitudes}}{{until|JE 26.3}} / {{nbt|list|amplitude_modifiers}} (optional){{upcoming|JE 26.3}}: A scaling factor to apply to each octave. The number of elements in the list must match {{cd|octave_count}}. If not specified, it defaults to 1.0.{{upcoming|JE 26.3}} Amplitudes of sub-noise. The frequency of a sub-noise at <code>index</code> (from 0) in the list is <code>2^(- firstOctave + index)</code>, and the amplitude (the value of the sub-noise ranges from <code>-amplitude</code> to <code>+amplitude</code>) of this sub-noise is about <code>1.04 * doubleValueAtIndex * 2^(sizeOfThisList - index - 1) / (2^sizeOfThisList - 1)</code> (assuming the range of 3D Improved Perlin Noise is ±1.04). For each sub-noise, two 3D improved perlin noises are created and their average is taken. The final range of this noise value is <code>± 10 * sumOfSubNoises / ( 3 * ( 1 + 1 / m ) )</code>, where m is the number of elements in the list after removing the leading and trailing zero elements. If {{nbt|bool|legacy_random_source}} in the noise settings is true, the length must be less than or equal to <code>1-firstOctave</code>. If false, the length is unlimited.{{until|JE 26.3}}
*** {{Nbt|double}}: A double value for a sub-noise.
** {{nbt|float|base_amplitude}}{{upcoming|JE 26.3}}: A scale factor to apply to the noise output. It must not be negative.
** {{nbt|int|octave_count}}{{upcoming|JE 26.3}}: The number of octaves to sample. Value between 1 and 32 (inclusive).
** {{nbt|boolean|normalize}}{{upcoming|JE 26.3}}: Controls how the output amplitude should be normalized. If {{cd|true}}, {{cd|base_amplitude}} is the expected amplitude of the output (i.e., 99.7% of all samples in {{cd|[-base.amplitude; base.amplitude]}}). If {{cd|false}}, the base amplitude is instead the amplitude of the first octave. If {{cd|"legacy"}}, it inherits the same normalization behavior as expressed by the previous format. If not specified, it defaults to {{cd|true}}.
</div>

== History ==
{{info needed section|when it was added.}}
{{HistoryTable
|{{HistoryLine|java upcoming}}
|{{HistoryLine||26.3|dev=snap6|Noises now define a fractal Brownian motion (fBm) configuration, producing approximate output vales fitting a normal distribution.
|Renamed the following fields:
* {{cd|amplitudes}} to {{cd|amplitude_modifiers}}
* {{cd|firstOctave}} to {{cd|base_octave}}
|Added the following fields:
* {{cd|base_amplitude}}
* {{cd|normalize}}
* {{cd|octave_count}}
}}
}}

== External links ==
* [https://misode.github.io/worldgen/noise/ Noise Generator on misode.github.io]

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

[[Minecraft:de:Rauschdefinition]]
[[Minecraft:fr:Bruit]]
[[Minecraft:pt:Ruído]]
[[Minecraft:zh:噪声]]

Minecraft:Noise - Revision history

SyncBot: Sync: updated from Minecraft

SyncBot: Sync: new page from Minecraft