Added block tinting page

Author: QuazChick

docs/blocks/block-tinting.md

@@ -0,0 +1,82 @@
+---
+title: Block Tinting
+description: Learn how to apply a color tint to your block's texture and map color.
+category: Visuals
+tags:
+    - easy
+license: true
+mentions:
+    - QuazChick
+---
+
+## Tinting Textures
+
+### Atlas Tinting
+
+In the `RP/textures/terrain_texture.json` [atlas file](/concepts/texture-atlases), the `tint_color` and `overlay_color` parameters can be used on a texture to tint it by a specified color in two different ways:
+
+-   [`tint_color`](/concepts/texture-atlases#tint-color) applies a basic multiply tint to a texture.
+-   [`overlay_color`](/concepts/texture-atlases#overlay-color) applies a tint to a texture, using the alpha channel of the texture to determine tint intensity.
+
+### Using Tint Methods
+
+[Tint methods](#list-of-tint-methods) can be used to tint the texture of a block based on the biome it is placed in.
+
+Tinting is applied by specifying the `tint_method` parameter for the [material instance](/blocks/block-components#material-instances) with the texture that should be tinted.
+
+Different material instances of a block can use different tint methods.
+
+<CodeHeader>minecraft:block > components</CodeHeader>
+
+```json
+"minecraft:material_instances": {
+    "*": {
+        "texture": "wiki:grey_texture",
+        "tint_method": "grass"
+    }
+}
+```
+
+## Tinting Map Color
+
+If your texture has tinting applied, the chances are, you'll want maps to display your block with that tint too.
+
+Tint methods can be applied to the block's map color, not just its textures!
+
+<CodeHeader>minecraft:block > components</CodeHeader>
+
+```json
+"minecraft:map_color": {
+    "color": "#ffffff",
+    "tint_method": "grass"
+}
+```
+
+## Tint Methods
+
+:::warning FORMAT VERSION `1.21.70`
+Tint methods are experimental and require Upcoming Creator Features to be enabled.
+:::
+
+Tint methods can be used to tint a block based on the biome it is placed in.
+Most tint methods use colormaps (found in the `RP/textures/colormap` folder) to determine tint color.
+
+However, an exception to this is the `water` tint method, which uses the `surface_color` defined in the `minecraft:water_appearance` component of client biome files.
+
+### List of Tint Methods
+
+<Table data="tint_methods.json" />
+
+<style>
+.color-preview {
+    display: inline-grid;
+    place-items: center;
+    margin-block: 0.5em;
+    width: 64px; 
+    height: 64px;
+    border: var(--border);
+    border-radius: var(--border-radius);
+    font-family: monospace;
+    color: #ffffff;
+}
+</style>

docs/public/assets/tables/blocks/block-tinting/tint_methods.json

@@ -0,0 +1,67 @@
+{
+  "columns": {
+    "tint_method": {
+      "name": "Tint Method",
+      "sortable": true
+    },
+    "default_color": {
+      "name": "Preview",
+      "text_align": "center"
+    },
+    "vanilla_usage": {
+      "name": "Vanilla Usage"
+    }
+  },
+  "rows": [
+    {
+      "tint_method": "`birch_foliage`",
+      "default_color": "<div style='background: #80A755' class='color-preview'>#80A755</div>",
+      "vanilla_usage": ["`minecraft:birch_leaves`"]
+    },
+    {
+      "tint_method": "`default_foliage`",
+      "default_color": "<div style='background: #77AB2F' class='color-preview'>#77AB2F</div>",
+      "vanilla_usage": [
+        "`minecraft:acacia_leaves`",
+        "`minecraft:dark_oak_leaves`",
+        "`minecraft:jungle_leaves`",
+        "`minecraft:mangrove_leaves`",
+        "`minecraft:oak_leaves`",
+        "`minecraft:vines`"
+      ]
+    },
+    {
+      "tint_method": "`dry_foliage`",
+      "default_color": "<div style='background: #A37546' class='color-preview'>#A37546</div>",
+      "vanilla_usage": ["`minecraft:leaf_litter`"]
+    },
+    {
+      "tint_method": "`evergreen_foliage`",
+      "default_color": "<div style='background: #619961' class='color-preview'>#619961</div>",
+      "vanilla_usage": ["`minecraft:spruce_leaves`"]
+    },
+    {
+      "tint_method": "`grass`",
+      "default_color": "<div style='background: #92BC58' class='color-preview'>#92BC58</div>",
+      "vanilla_usage": [
+        "`minecraft:fern`",
+        "`minecraft:grass_block` (top)",
+        "`minecraft:large_fern`",
+        "`minecraft:pink_petals` (stems)",
+        "`minecraft:reeds`",
+        "`minecraft:short_grass`",
+        "`minecraft:tall_grass`",
+        "`minecraft:wildflowers` (stems)"
+      ]
+    },
+    {
+      "tint_method": "`water`",
+      "default_color": "<div style='background: #44AFF5' class='color-preview'>#44AFF5</div>",
+      "vanilla_usage": [
+        "`minecraft:cauldron` (undyed water)",
+        "`minecraft:flowing_water`",
+        "`minecraft:water`"
+      ]
+    }
+  ]
+}