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/resource/textures/flipbook_textures.json

@@ -12,29 +12,31 @@
     "type": "object",
     "properties": {
       "atlas_index": {
-        "description": "UNDOCUMENTED.",
+        "description": "The index of the texture array inside the definition of that shortname.",
         "$comment": "UNDOCUMENTED",
         "title": "Atlas Index",
         "type": "integer"
       },
       "atlas_tile": {
-        "description": "UNDOCUMENTED.",
+        "description": "The shortname defined in the terrain_texture JSON file.",
+        "markdownDescription": "The shortname defined in the terrain_texture.json file.",
         "$comment": "UNDOCUMENTED",
         "pattern": "^[a-z0-9_:\\-]*$",
-        "title": "Atlas Index",
+        "title": "Atlas Title",
         "type": "string"
       },
       "atlas_tile_variant": {
-        "description": "UNDOCUMENTED.",
+        "description": "The variant of the block's texture array inside the shortname's block variation.",
         "$comment": "UNDOCUMENTED",
-        "title": "Atlas Index",
+        "title": "Atlas Tile Variant",
         "type": "integer"
       },
       "blend_frames": {
-        "description": "UNDOCUMENTED.",
+        "description": "Whether or not Minecraft should interpolate between frames.",
         "$comment": "UNDOCUMENTED",
-        "title": "Atlas Index",
-        "type": "boolean"
+        "title": "Blend Frames",
+        "type": "boolean",
+        "default": true
       },
       "flipbook_texture": {
         "description": "A texture file.",
@@ -44,7 +46,7 @@
       },
       "frames": {
         "title": "Frames",
-        "description": "The collection of frame index to display.",
+        "description": "The order in which frame indices to display. Duplicate frames are allowed.",
         "items": {
           "description": "The index of the frame.",
           "minimum": 0,
@@ -54,10 +56,11 @@
         "type": "array"
       },
       "replicate": {
-        "description": "UNDOCUMENTED.",
+        "description": "Sets the size of pixels.",
         "$comment": "UNDOCUMENTED",
-        "title": "Atlas Index",
-        "type": "integer"
+        "title": "Replicate",
+        "type": "integer",
+        "default": 1
       },
       "ticks_per_frame": {
         "description": "The amount of ticks to wait between frames.",

source/resource/textures/terrain_texture.json

@@ -39,7 +39,7 @@
               "items": {
                 "type": "object",
                 "title": "Variantion",
-                "description": "One of the variantions, specified along with a possible weight.",
+                "description": "One of the variations, specified along with a possible weight.",
                 "$comment": "UNDOCUMENTED",
                 "required": ["path"],
                 "properties": {
@@ -54,22 +54,22 @@
     }
   },
   "properties": {
-    "num_mip_levels": { "type": "integer", "title": "Num Mip Levels", "description": "Sets the number of mipmap levels for better texture quality at varying distances.", "$comment": "UNDOCUMENTED" },
+    "num_mip_levels": { "minimum": 0, "maximum": 4, "default": 4, "type": "integer", "title": "Num Mip Levels", "description": "Sets the number of mipmap levels for reducing texture quality at varying distances. More mipmap levels means reduced texture quality at farther distances.", "$comment": "UNDOCUMENTED" },
     "padding": { "type": "integer", "title": "Padding", "description": "Adds buffer space to prevent textures from bleeding into each other.", "$comment": "UNDOCUMENTED" },
-    "resource_pack_name": { "type": "string", "title": "Resource Pack Name", "description": "UNDOCUMENTED.", "$comment": "UNDOCUMENTED" },
+    "resource_pack_name": { "type": "string", "title": "Resource Pack Name", "description": "The name of your resource pack, which should match the name in this pack's manifest.", "markdownDescription": "The name of your resource pack, which should match the name in `manifest.json`.", "$comment": "UNDOCUMENTED" },
     "texture_data": {
       "type": "object",
       "propertyNames": { "pattern": "^[a-z0-9_:.\\-]*$" },
       "additionalProperties": {
         "type": "object",
         "title": "Texture Data",
-        "description": "UNDOCUMENTED.",
+        "description": "Describes the texture, including properties like the path to the texture.",
         "$comment": "UNDOCUMENTED",
         "properties": {
           "textures": { "oneOf": [{ "$ref": "#/definitions/texture" }, { "type": "array", "items": { "$ref": "#/definitions/texture" } }] }
         }
       },
-      "description": "UNDOCUMENTED.",
+      "description": "A JSON object with shortnames and texture data.",
       "$comment": "UNDOCUMENTED",
       "title": "Texture Data"
     },