From db1ea662b305c19e886461ce9fd48fe8d9ee7329 Mon Sep 17 00:00:00 2001
From: Micah <micah@uplift.games>
Date: Mon, 20 May 2024 10:05:20 -0700
Subject: [PATCH] Add MaterialColors property format to docs (#140)

Co-authored-by: boatbomber <zack@boatbomber.com>
---
 docs/properties.md | 28 +++++++++++++++++++++++++++-
 1 file changed, 27 insertions(+), 1 deletion(-)

diff --git a/docs/properties.md b/docs/properties.md
index e854efc9..fa5c7576 100644
--- a/docs/properties.md
+++ b/docs/properties.md
@@ -13,7 +13,7 @@ Rojo supports most Roblox properties. This page documents all of the properties
 |:----------------------------------------------------|:--------------------------------|:--:|:--:|:--:|
 | [Attributes](#attributes)                           | `Instance.Attributes`           | ✔ | ✔ | ✔ |
 | [Axes](#axes)                                       | `ArcHandles.Axes`               | ✔ | ✔ | ✔ |
-| [BinaryString](#binarystring)                       | `Terrain.MaterialColors`        | ✔ | ❌ | ✔ |
+| [BinaryString](#binarystring)                       | `BinaryStringValue.Value`       | ✔ | ❌ | ✔ |
 | [Bool](#bool)                                       | `Part.Anchored`                 | ✔ | ✔ | ✔ |
 | [BrickColor](#brickcolor)                           | `Part.BrickColor`               | ✔ | ✔ | ✔ |
 | [CFrame](#cframe)                                   | `Camera.CFrame`                 | ✔ | ✔ | ✔ |
@@ -28,6 +28,7 @@ Rojo supports most Roblox properties. This page documents all of the properties
 | [Font](#font)                                       | `TextLabel.FontFace`        	| ✔ | ✔ | ✔ |
 | [Int32](#int32)                                     | `Frame.ZIndex`                  | ✔ | ✔ | ✔ |
 | [Int64](#int64)                                     | `Player.UserId`                 | ✔ | ✔ | ✔ |
+| [MaterialColors](#materialcolors)					  | `Terrain.MaterialColors`        | ✔ | ✔ | ✔ |
 | [NumberRange](#numberrange)                         | `ParticleEmitter.Lifetime`      | ✔ | ✔ | ✔ |
 | [NumberSequence](#numbersequence)                   | `Beam.Transparency`             | ✔ | ✔ | ✔ |
 | [OptionalCoordinateFrame](#optionalcoordinateframe) | `Model.WorldPivotData`          | ✔ | ❌ | ✔ |
@@ -352,6 +353,31 @@ For both implicit and explicit values, the format is an integer.
 }
 ```
 
+### MaterialColors
+
+For both implicit and explicit values, the type is an object that looks like this:
+
+```json
+{
+	"$properties": {
+		"ImplicitExample": {
+			"Grass": [10, 20, 30],
+			"Asphalt": [40, 50, 60],
+			"LeafyGrass": [255, 155, 55]
+		},
+		"ExplicitExample": {
+			"MaterialColors": {
+				"Grass": [10, 20, 30],
+				"Asphalt": [40, 50, 60],
+				"LeafyGrass": [255, 155, 55]
+			}
+		}
+	}
+}
+```
+
+The key-value pairs within the object should be [Material](https://create.roblox.com/docs/reference/engine/enums/Material) enum items mapped to arrays of 3 integers representing the RGB of the specified color. Only the values you wish to change the defaults of need to be specified.
+
 ### NumberRange
 The NumberRange type cannot be specified implicitly. For explicit values, the format is a list of Min and Max components, respectively. Each component is a float.