Merge branch 'main' into animation

doc/en/scripting/extensions.md

@@ -139,6 +139,12 @@ string.left_pad(str: string, size: int, char: string) -> string
 -- Adds a char to the right of the string until its size equals size.
 -- By default, char is equal to the space character.
 string.right_pad(str: string, size: int, char: string) -> string
+
+-- Encodes a string into URL format, replacing special characters with their hexadecimal representations.
+string.url_encode(str: string) -> string
+
+-- Decodes a string from URL format, replacing hexadecimal representations with their corresponding characters.
+string.url_decode(str: string) -> string
 ```
 
 ## Math extensions

doc/en/world-generator.md

@@ -284,6 +284,14 @@ A method that generates simplex noise, adding it to the existing values.
 
 The noise seed can be specified in the `map.noiseSeed` field.
 
+By default, noise octaves are mixed using addition:
+
+$noise_{out} = noise_{source} + noise_{applied} * 2^{-{octave}}$
+
+To obtain more normalized multi-octave noise, you can enable the `map.normalNoise = true` flag, which changes the scheme:
+
+$noise_{out} = noise_{source} * (1 - 2^{-{octave}}) + noise_{applied} * 2^{-{octave}}$
+
 ```lua
 map:noise(
 -- coordinate offset
@@ -313,6 +321,10 @@ The noise seed can be specified in the `map.noiseSeed` field.
 
 ![image](../images/cell-noise.gif)
 
+> [!NOTE] cell noise looks better with `map.normalNoise = true`
+
+![image](../images/normal-cell-noise.png)
+
 ### heightmap:resize(...)
 
 ```lua