Add Render-Mask wiki page

Author: TBlueF

wiki/customization/Markers.md

@@ -3,7 +3,7 @@ layout: page
 title: Markers
 parent: Advanced Customization
 grand_parent: Wiki
-nav_order: 1
+nav_order: 2
 ---
 
 # Markers

wiki/customization/Masks.md

@@ -0,0 +1,143 @@
+---
+layout: page
+title: Render-Masks
+parent: Advanced Customization
+grand_parent: Wiki
+nav_order: 1
+---
+
+# Render-Masks
+{: .no_toc }
+
+BlueMap supports **render masks** that allow you to control which parts of your Minecraft world are rendered to the map.  
+By default, BlueMap renders the entire (generated) world. With masks, you can define custom mask shapes to **include** or **exclude** specific areas.
+
+This can be useful to make sure the map only renders **inside** your world-border, or if you want to hide a specific area from the map.  
+In the nether the default config uses masks to remove the nethers ceiling so you can see below the top bedrock-layer.
+
+Render masks are configured in the **map config file**:
+
+```hocon
+render-mask: [
+  // mask definitions go here
+]
+```
+
+## How Render Masks Work
+
+* The `render-mask` setting is a **list** of one or more **mask objects**.
+* Each mask defines a shape in the world that will either be:
+  * **Included** in the rendered map (default).
+  * **Excluded** using the `subtract: true` property.
+* Masks are applied in **top-to-bottom order**.
+
+BlueMap automatically updates the rendered map when masks are changed, and deletes tiles outside the defined area.  
+To fix any potential issues after changing masks, you can use: `/bluemap fix-edges <map>`
+
+## Available Mask Types
+
+### Box Mask
+
+Defines a rectangular 3D area (Axis-Aligned Bounding Box).  
+You can **omit** properties like `min-x`, `max-y`, etc., to make masks **unbounded** in that axis.
+
+```hocon
+{
+  type: box
+  subtract: false
+  
+  # Optional:
+  min-x: -4000
+  max-x: 4000
+  min-z: -4000
+  max-z: 4000
+  min-y: 50
+  max-y: 100
+}
+```
+
+### Circle Mask
+
+Defines a **circular** area in the XZ plane. Optionally limited in height with `min-y` and `max-y`.
+
+```hocon
+{
+  type: circle
+  subtract: false
+  center-x: 0
+  center-y: 0
+  radius: 4000
+  
+  # Optional:
+  min-y: 50
+  max-y: 100
+}
+```
+
+### Ellipse Mask
+
+Like the circle mask, but allows different radii for X and Z axes.
+
+```hocon
+{
+  type: ellipse
+  subtract: false
+  center-x: 0
+  center-y: 0
+  radius-x: 4000
+  radius-z: 2000
+  
+  # Optional:
+  min-y: 50
+  max-y: 100
+}
+```
+
+### Polygon Mask
+
+Defines a custom polygon shape with 3 or more points. Optionally limited in height with `min-y` and `max-y`.
+
+```hocon
+{
+  type: polygon
+  subtract: false
+  shape: [
+    { x: 1, z: -23 },
+    { x: 1, z: -24 },
+    { x: 1, z: -25 },
+    { x: 2, z: -25 },
+    { x: 3, z: -25 }
+  ]
+
+  # Optional:
+  min-y: 50
+  max-y: 100
+}
+```
+
+## Combining Multiple Masks
+
+You can combine multiple masks together by adding more mask objects in the `render-mask` list.  
+Each mask can be **additive** (default) or **subtractive** by setting `subtract: true`.
+
+Example: Render everything inside a box, except a smaller circle in the center.
+
+```hocon
+render-mask: [
+  {
+    type: box
+    subtract: false
+    min-x: -1000
+    max-x: 1000
+    min-z: -1000
+    max-z: 1000
+  }
+  {
+    type: circle
+    subtract: true
+    center-x: 0
+    center-y: 0
+    radius: 200
+  }
+]
+```

wiki/customization/Mods.md

@@ -3,7 +3,7 @@ layout: page
 title: Configuring Mods
 parent: Advanced Customization
 grand_parent: Wiki
-nav_order: 4
+nav_order: 5
 ---
 
 # Configuring Mods

wiki/customization/ResourcePacks.md

@@ -3,7 +3,7 @@ layout: page
 title: Resource/Data-packs
 parent: Advanced Customization
 grand_parent: Wiki
-nav_order: 3
+nav_order: 4
 ---
 
 # Installing Resourcepacks or Datapacks

wiki/customization/Storages.md

@@ -3,7 +3,7 @@ layout: page
 title: Storages
 parent: Advanced Customization
 grand_parent: Wiki
-nav_order: 2
+nav_order: 3
 ---
 
 # Storages