Minecraft:Noise: Difference between revisions

Latest revision as of 11:18, 17 September 2026

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 Template:Cd.

In addition to being called by density functions and surface rules, there are also some noises with hard-coded usage:

Template:Code: Affects the surface layer thickness in surface rules.
Template:Code: Used as the thickness of additional surface layer in surface rules.
Template:Code: Used to generate badland terracotta bands in Template:Code surface rules.
Template:Code, Template:Code, Template:Code: Used when generating badland hoodoos in Template:Cd biome.
Template:Code, Template:Code, Template:Code: Used when generating iceberg Minecraft:terrain feature in Template:Cd and Template:Cd biomes.

JSON format

Template:Nbt: Root object.
- Template:Nbt: First octave. If Template:Nbt in the noise settings is true, it must be an integer less than or equal to 1, otherwise the value range is not unlimited.
- Template:Nbt (optional): A scaling factor to apply to each octave. The number of elements in the list must match Template:Cd. If not specified, it defaults to 1.0.
  - Template:Nbt: A double value for a sub-noise.
- Template:Nbt: A scale factor to apply to the noise output. It must not be negative.
- Template:Nbt: The number of octaves to sample. Value between 1 and 32 (inclusive).
- Template:Nbt: Controls how the output amplitude should be normalized. If Template:Cd, Template:Cd is the expected amplitude of the output (i.e., 99.7% of all samples in Template:Cd). If Template:Cd, the base amplitude is instead the amplitude of the first octave. If Template:Cd, it inherits the same normalization behavior as expressed by the previous format. If not specified, it defaults to Template:Cd.

History

Template:Info needed section Template:HistoryTable

External links

Noise Generator on misode.github.io

Navigation

Template:Navbox Java Edition technical

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

@@ Line 17: / Line 17: @@
 * {{nbt|compound}}: Root object.
 ** {{nbt|int|base_octave}}: 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|amplitude_modifiers}} (optional): 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. 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|list|amplitude_modifiers}} (optional): 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.
 *** {{Nbt|double}}: A double value for a sub-noise.
 ** {{nbt|float|base_amplitude}}: A scale factor to apply to the noise output. It must not be negative.