Fill in some undocumented entries (#356)

* Add permutations description

* Adjust grammar

* Update description of "num_mip_levels"

* Update "atlas_tile" and "blend_frames" property

Some properties had completely incorrect titles as well, those were fixed in this commit too.

* Update JSON UI schema

* Update item schema

* Update terrain_texture schema

* Update animations schema

* Update go_home.json

* Update textures schemas

source/behavior/animations/animations.json

@@ -61,7 +61,7 @@
   },
   "type": "object",
   "title": "Animation",
-  "description": "Animation for behavior for.",
+  "description": "An animation definition for an entity.",
   "required": ["format_version", "animations"],
   "additionalProperties": false,
   "properties": {
@@ -74,19 +74,19 @@
       "additionalProperties": {
         "title": "Animation",
         "type": "object",
-        "description": "A single animation definition for.",
+        "description": "A single animation definition for an entity.",
         "additionalProperties": false,
         "propertyNames": { "examples": ["animation.example.foo"] },
         "properties": {
           "animation_length": { "type": "number", "description": "The time in seconds this animation will last.", "title": "Animation Length" },
           "loop": {
             "type": "boolean",
-            "description": "Whenever this animation should loop once it reaches the end, will only happen if the animation is still active.",
+            "description": "If set to true, this animation will loop (as long as it remains active).",
             "title": "Loop"
           },
           "timeline": {
             "title": "Timeline",
-            "description": "A timeline specification, property names are timestamps.",
+            "description": "A timeline specification, where property names are timestamps.",
             "type": "object",
             "propertyNames": { "pattern": "^(\\d+\\.\\d+|\\d+)$", "examples": ["0.0", "1.0"] },
             "additionalProperties": {
@@ -98,7 +98,7 @@
           },
           "anim_time_update": {
             "title": "Animation Time Update",
-            "description": "How does time pass when playing the animation. Defaults to `query.anim_time + query.delta_time` which means advance in seconds.",
+            "description": "How time passes when playing the animation. Defaults to `query.anim_time + query.delta_time` which means advance in seconds.",
             "$ref": "../../molang/number.json"
           }
         }

source/behavior/blocks/format/minecraft.block.json

@@ -136,14 +136,15 @@
     "permutations": {
       "type": "array",
       "title": "Permutations",
-      "description": "UNDOCUMENTED.",
+      "description": "An array of different versions of a block, allowing you to specify which components you want the block to have under certain conditions.",
       "$comment": "UNDOCUMENTED",
       "items": {
         "title": "Permutation",
-        "description": "UNDOCUMENTED.",
+        "description": "A permutation of a block, which will be applied given the condition is met.",
         "$comment": "UNDOCUMENTED",
         "type": "object",
         "additionalProperties": false,
+        "required": [ "condition" ],
         "properties": {
           "condition": {
             "title": "Condition",

source/behavior/entities/format/behaviors/go_home.json

@@ -10,7 +10,7 @@
     "goal_radius": {
       "type": "number",
       "default": 0.5,
-      "description": "Distance in blocks within the mob considers it has reached the goal. This is the `wiggle room` to stop the AI from bouncing back and forth trying to reach a specific spot",
+      "description": "Distance in blocks within the mob considers it has reached the goal. This is the \"wiggle room\" to stop the AI from bouncing back and forth trying to reach a specific spot",
       "title": "Goal Radius"
     },
     "interval": {

source/behavior/items/format/minecraft.item.json

@@ -3,7 +3,7 @@
   "additionalProperties": false,
   "required": ["description"],
   "type": "object",
-  "description": "UNDOCUMENTED.",
+  "description": "An item definition.",
   "$comment": "UNDOCUMENTED",
   "title": "Item",
   "properties": {
@@ -11,7 +11,7 @@
       "additionalProperties": false,
       "type": "object",
       "title": "Description",
-      "description": "The description for this item",
+      "description": "The description for this item.",
       "$comment": "UNDOCUMENTED",
       "properties": {
         "identifier": {