Updated documentation with the microsoft documentation

2021-07-02 13:00:02 +02:00
parent f9ecdb79e8
commit dd28b6a467
29 changed files with 152 additions and 127 deletions
--- a/source/behavior/entities/1.10.0/events.json
+++ b/source/behavior/entities/1.10.0/events.json
@@ -26,19 +26,28 @@
        "remove": { "$ref": "#/definitions/addremove", "description": "What gets removed when  the event gets triggered", "title": "Remove" },
        "randomize": {
          "type": "array",
+          "description": "Randomly selects one of the following items based upon their weight and the total weights",
+          "$comment": "UNDOCUMENTED",
+          "title": "Randomize",
          "items": {
+            "description": "A single randomized item",
+            "$comment": "UNDOCUMENTED",
+            "title": "Randomize",
+            "type": "object",
            "required": ["weight"],
+            "examples": [{ "weight": 1 }],
            "properties": {
              "add": { "$ref": "#/definitions/addremove", "description": "What gets added when the event gets triggered", "title": "Add" },
              "remove": { "$ref": "#/definitions/addremove", "description": "What gets removed when the event gets triggered", "title": "Remove" },
-              "trigger": { "type": "string", "description": "UNDOCUMENTED", "$comment": "UNDOCUMENTED", "title": "Trigger" },
-              "weight": { "type": "number", "description": "UNDOCUMENTATED: weight", "title": "Weight" }
-            },
-            "description": "UNDOCUMENTATED: randomize",
-            "title": "Randomize"
-          },
-          "description": "UNDOCUMENTATED: randomize",
-          "title": "Randomize"
+              "trigger": { "type": "string", "description": "Triggers additional events", "$comment": "UNDOCUMENTED", "title": "Trigger" },
+              "weight": {
+                "type": "number",
+                "description": "The weight on how likely this section is to trigger",
+                "$comment": "UNDOCUMENTED",
+                "title": "Weight"
+              }
+            }
+          }
        },
        "sequence": {
          "type": "array",
@@ -56,7 +65,7 @@
          "title": "Sequences"
        },
        "filters": { "$ref": "./../filters/filters.json" },
-        "trigger": { "type": "string", "description": "UNDOCUMENTED", "$comment": "UNDOCUMENTED", "title": "Trigger" }
+        "trigger": { "type": "string", "description": "Triggers additional events", "$comment": "UNDOCUMENTED", "title": "Trigger" }
      }
    }
  },
--- a/source/behavior/entities/1.8.0/components/minecraft.ageable.json
+++ b/source/behavior/entities/1.8.0/components/minecraft.ageable.json
@@ -12,13 +12,13 @@
      "description": "Amount of time before the entity grows up, -1 for always a baby.",
      "title": "Duration"
    },
-    "feedItems": {
+    "feed_items": {
      "description": "List of items that can be fed to the entity. Includes `item` for the item name and `growth` to define how much time it grows up by",
      "title": "Feed Items",
      "type": "array",
      "items": {
-        "title": "Feed Items",
-        "description": "UNDOCUMENTATED: feedItems",
+        "title": "Feed Item",
+        "description": "An item that can be fed to the entity. Includes 'item' for the item name and 'growth' to define how much time it grows up by",
        "oneOf": [
          {
            "type": "object",
--- a/source/behavior/entities/1.8.0/components/minecraft.angry.json
+++ b/source/behavior/entities/1.8.0/components/minecraft.angry.json
@@ -6,8 +6,6 @@
  "additionalProperties": false,
  "required": [],
  "properties": {
-    "broadcastAnger": { "type": "boolean", "description": "UNDOCUMENTED", "$comment": "UNDOCUMENTED", "title": "Broadcast Anger" },
-    "broadcastRange": { "type": "integer", "description": "UNDOCUMENTED", "$comment": "UNDOCUMENTED", "title": "Broadcast Range" },
    "broadcast_anger": {
      "type": "boolean",
      "default": false,
@@ -73,16 +71,16 @@
          "type": "array",
          "default": [0, 0],
          "items": [
-            { "type": "integer", "minimum": 0, "description": "UNDOCUMENTED", "$comment": "UNDOCUMENTED", "title": "Minimum" },
-            { "type": "integer", "minimum": 0, "description": "UNDOCUMENTED", "$comment": "UNDOCUMENTED", "title": "Maximum" }
+            { "type": "integer", "minimum": 0, "description": "The minimum interval", "$comment": "UNDOCUMENTED", "title": "Minimum" },
+            { "type": "integer", "minimum": 0, "description": "The maximum interval", "$comment": "UNDOCUMENTED", "title": "Maximum" }
          ]
        },
        {
          "type": "object",
          "additionalProperties": false,
          "properties": {
-            "range_min": { "type": "number", "description": "UNDOCUMENTED", "$comment": "UNDOCUMENTED", "title": "Range Minimum" },
-            "range_max": { "type": "number", "description": "UNDOCUMENTED", "$comment": "UNDOCUMENTED", "title": "Range Maximum" }
+            "range_min": { "type": "number", "description": "The minimum interval", "$comment": "UNDOCUMENTED", "title": "Range Minimum" },
+            "range_max": { "type": "number", "description": "The maximum interval", "$comment": "UNDOCUMENTED", "title": "Range Maximum" }
          }
        }
      ]
--- a/source/behavior/entities/1.8.0/components/minecraft.area_attack.json
+++ b/source/behavior/entities/1.8.0/components/minecraft.area_attack.json
@@ -17,11 +17,14 @@
      "description": "How close a hostile entity must be to have the damage applied.",
      "title": "Damage Range"
    },
-    "entity_filter": { "$ref": "../../filters/filters.json", "description": "Entity_filter", "title": "Filter" },
+    "entity_filter": {
+      "$ref": "../../filters/filters.json",
+      "description": "Filter to see which entities can be affected by the attack",
+      "title": "Entity Filter"
+    },
    "cause": {
      "type": "string",
-      "description": "UNDOCUMENTED",
-      "$comment": "UNDOCUMENTED",
+      "description": "what causes the attack to occur",
      "title": "Cause",
      "$ref": "../../../../general/entity/damage_source.json"
    }
--- a/source/behavior/entities/1.8.0/components/minecraft.block_sensor.json
+++ b/source/behavior/entities/1.8.0/components/minecraft.block_sensor.json
@@ -5,10 +5,16 @@
  "description": "Fires off a specified event when a block in the block list is broken within the sensor range.",
  "additionalProperties": false,
  "properties": {
-    "sensor_radius": { "type": "integer", "description": "UNDOCUMENTED", "$comment": "UNDOCUMENTED", "title": "Sensor Radius", "minimum": 0 },
+    "sensor_radius": {
+      "type": "integer",
+      "description": "radius from entity in order to check for when block is broken",
+      "title": "Sensor Radius",
+      "minimum": 0
+    },
    "on_break": {
      "type": "array",
      "title": "On Break",
+      "description": "blocks that will trigger the component when broken and what event will trigger.",
      "items": {
        "type": "object",
        "title": "On Block Broken",
@@ -17,15 +23,17 @@
          "block_list": {
            "type": "array",
            "title": "Block List",
-            "description": "UNDOCUMENTED",
-            "$comment": "UNDOCUMENTED",
-            "items": { "type": "string", "title": "Block ID" }
+            "description": "list of blocks that will trigger the senor.",
+            "items": {
+              "type": "string",
+              "title": "Block ID",
+              "description": "A block that will trigger the senor.",
+              "$ref": "../../../../general/block/identifier.json"
+            }
          },
-          "on_block_broken": { "type": "string", "title": "On Block Broken", "description": "On block broken" }
+          "on_block_broken": { "type": "string", "title": "On Block Broken", "description": "Event to run when a block breaks" }
        }
-      },
-      "description": "UNDOCUMENTED",
-      "$comment": "UNDOCUMENTED"
+      }
    }
  }
 }
--- a/source/behavior/entities/1.8.0/components/minecraft.boostable.json
+++ b/source/behavior/entities/1.8.0/components/minecraft.boostable.json
@@ -15,12 +15,12 @@
    },
    "boost_items": {
      "type": "array",
-      "description": "UNDOCUMENTED",
-      "$comment": "UNDOCUMENTED",
+      "description": "List of items that can be used to boost while riding this entity.",
      "title": "Boost Items",
      "items": {
        "type": "object",
        "description": "List of items that can be used to boost while riding this entity.",
+        "title": "Boost Item",
        "properties": {
          "damage": { "type": "integer", "default": 1, "description": "This is the damage that the item will take each time it is used" },
          "item": {
@@ -28,7 +28,7 @@
            "$ref": "../../../../general/item/identifier.json",
            "description": "Name of the item that can be used to boost"
          },
-          "replaceItem": {
+          "replace_item": {
            "type": "string",
            "$ref": "../../../../general/item/identifier.json",
            "description": "The item used to boost will become this item once it is used up"
--- a/source/behavior/entities/1.8.0/components/minecraft.buoyant.json
+++ b/source/behavior/entities/1.8.0/components/minecraft.buoyant.json
@@ -2,14 +2,13 @@
  "$id": "blockception.minecraft.behavior.entities.1.8.0.minecraft.buoyant",
  "type": "object",
  "title": "Buoyant 1.8.0",
-  "description": "Enables an entity to float on the specified liquid blocks.",
+  "description": "Allows an entity to float on the specified liquid blocks.",
  "additionalProperties": false,
  "properties": {
    "base_buoyancy": {
      "type": "number",
      "default": 0,
-      "description": "UNDOCUMENTED",
-      "$comment": "UNDOCUMENTED",
+      "description": "Base buoyancy used to calculate how much will a mob float.",
      "title": "Base Buoyancy"
    },
    "apply_gravity": {
@@ -46,7 +45,12 @@
      "type": "array",
      "description": "List of blocks this entity can float on. Must be a liquid block.",
      "title": "Liquid Blocks",
-      "items": { "type": "string", "title": "Block ID" }
+      "items": {
+        "type": "string",
+        "title": "Block ID",
+        "description": "A block this entity can float on. Must be a liquid block.",
+        "$ref": "../../../../general/block/identifier.json"
+      }
    },
    "simulate_waves": {
      "type": "boolean",
--- a/source/behavior/entities/1.8.0/components/minecraft.can_fly.json
+++ b/source/behavior/entities/1.8.0/components/minecraft.can_fly.json
@@ -5,5 +5,12 @@
  "additionalProperties": false,
  "description": "Marks the entity as being able to fly, the pathfinder won't be restricted to paths where a solid block is required underneath it.",
  "required": [],
-  "properties": { "value": { "type": "boolean", "default": true, "description": "UNDOCUMENTATED: value", "title": "Value" } }
+  "properties": {
+    "value": {
+      "type": "boolean",
+      "default": true,
+      "description": "Marks the entity as being able to fly, the pathfinder won't be restricted to paths where a solid block is required underneath it.",
+      "title": "Value"
+    }
+  }
 }
--- a/source/behavior/entities/1.8.0/components/minecraft.custom_hit_test.json
+++ b/source/behavior/entities/1.8.0/components/minecraft.custom_hit_test.json
@@ -2,29 +2,39 @@
  "$id": "blockception.minecraft.behavior.entities.1.8.0.minecraft.custom_hit_test",
  "type": "object",
  "title": "Custom Hit Test 1.8.0",
-  "description": "List of hitboxes for melee and ranged hits against the entity.",
+  "description": "Defines a list of hitboxes for melee and ranged hits against the entity.",
  "additionalProperties": false,
  "properties": {
    "hitboxes": {
      "type": "array",
      "title": "Hitboxes",
-      "description": "UNDOCUMENTED",
-      "$comment": "UNDOCUMENTED",
+      "description": "Defines a hitbox size and pivot to test against.",
      "items": {
        "type": "object",
        "title": "Hitbox",
-        "description": "UNDOCUMENTED",
-        "$comment": "UNDOCUMENTED",
+        "description": "Defines a hitbox size and pivot to test against.",
        "additionalProperties": false,
+        "required": ["width", "height", "pivot"],
        "properties": {
-          "width": { "type": "number", "title": "Width", "description": "UNDOCUMENTED", "$comment": "UNDOCUMENTED" },
-          "height": { "type": "number", "title": "Height", "description": "UNDOCUMENTED", "$comment": "UNDOCUMENTED" },
+          "width": {
+            "type": "number",
+            "title": "Width",
+            "description": "Width and Depth of the hitbox in blocks. A negative value will be assumed to be 0."
+          },
+          "height": {
+            "type": "number",
+            "title": "Height",
+            "description": "Height of the hitbox in blocks. A negative value will be assumed to be 0."
+          },
          "pivot": {
            "type": "array",
            "title": "Pivot",
-            "description": "UNDOCUMENTED",
-            "$comment": "UNDOCUMENTED",
-            "items": [{ "type": "number" }, { "type": "number" }, { "type": "number" }]
+            "description": "The offset from the entity's anchor where the hitbox will spawn",
+            "items": [
+              { "type": "number", "title": "X" },
+              { "type": "number", "title": "Y" },
+              { "type": "number", "title": "Z" }
+            ]
          }
        }
      }
--- a/source/behavior/entities/1.8.0/components/minecraft.damage_sensor.json
+++ b/source/behavior/entities/1.8.0/components/minecraft.damage_sensor.json
@@ -3,11 +3,13 @@
  "title": "Damage Sensor 1.8.0",
  "additionalProperties": false,
  "description": "Defines what events to call when this entity is damaged by specific entities or items.",
+  "type": "object",
  "definitions": {
    "damagespec": {
      "type": "object",
      "description": "A trigger with the events to call when taking specific kinds of damage.",
      "additionalProperties": false,
+      "title": "Damage Trigger",
      "properties": {
        "cause": {
          "type": "string",
@@ -25,16 +27,11 @@
        "on_damage": {
          "additionalProperties": false,
          "type": "object",
-          "properties": {
-            "filters": { "$ref": "../../filters/filters.json" },
-            "event": { "type": "string", "pattern": "^.*$", "description": "UNDOCUMENTATED: event", "title": "Event" },
-            "target": { "$ref": "../../filters/filters/types/subject.json", "description": "UNDOCUMENTATED: target", "title": "Target" }
-          },
          "description": "Specifies filters for entity definitions and events.",
-          "title": "On Damage"
+          "title": "On Damage",
+          "$ref": "../types/trigger.json"
        }
-      },
-      "title": "Damagespec"
+      }
    }
  },
  "required": [],
--- a/source/behavior/entities/1.8.0/components/minecraft.economy_trade_table.json
+++ b/source/behavior/entities/1.8.0/components/minecraft.economy_trade_table.json
@@ -18,8 +18,8 @@
      "description": "How much should the discount be modified by when the player has cured the Zombie Villager. Can be specified as a pair of numbers (low-tier trade discount and high-tier trade discount)",
      "title": "Cured Discount",
      "items": [
-        { "type": "integer", "title": "A", "description": "UNDOCUMENTED", "$comment": "UNDOCUMENTED" },
-        { "type": "integer", "title": "B", "description": "UNDOCUMENTED", "$comment": "UNDOCUMENTED" }
+        { "type": "integer", "title": "A", "description": "Minimum" },
+        { "type": "integer", "title": "B", "description": "Maximum" }
      ]
    },
    "display_name": {
@@ -40,8 +40,8 @@
      "description": "The Maximum the discount can be modified by when the player has cured the Zombie Villager. Can be specified as a pair of numbers (low-tier trade discount and high-tier trade discount)",
      "title": "Maximum Cured Discount",
      "items": [
-        { "type": "integer", "title": "A", "description": "UNDOCUMENTED", "$comment": "UNDOCUMENTED" },
-        { "type": "integer", "title": "B", "description": "UNDOCUMENTED", "$comment": "UNDOCUMENTED" }
+        { "type": "integer", "title": "A", "description": "Minimum" },
+        { "type": "integer", "title": "B", "description": "Maximum" }
      ]
    },
    "max_nearby_cured_discount": {
--- a/source/behavior/entities/1.8.0/components/minecraft.environment_sensor.json
+++ b/source/behavior/entities/1.8.0/components/minecraft.environment_sensor.json
@@ -3,11 +3,12 @@
  "title": "Environment Sensor 1.8.0",
  "additionalProperties": false,
  "description": "Allows the entity to power jump like the horse does in vanilla.",
+  "type": "object",
  "definitions": {
    "on_environement": {
      "type": "object",
      "additionalProperties": false,
-      "description": "UNDOCUMENTATED: on environement",
+      "description": "Allows the entity to power jump like the horse does in vanilla.",
      "title": "On Environement",
      "properties": {
        "filters": { "$ref": "../../filters/filters.json", "description": "The filters to evualate for this environment sensor", "title": "Filters" },
--- a/source/behavior/entities/1.8.0/components/minecraft.equipment.json
+++ b/source/behavior/entities/1.8.0/components/minecraft.equipment.json
@@ -2,10 +2,15 @@
  "$id": "blockception.minecraft.behavior.entities.1.8.0.minecraft.equipment",
  "type": "object",
  "title": "Equipment 1.8.0",
+  "description": "Sets the equipment table to use for the entity.",
  "additionalProperties": false,
  "required": [],
  "properties": {
-    "table": { "type": "string", "pattern": ".*\\.json$", "description": "UNDOCUMENTATED: table", "title": "Table" },
+    "table": {
+      "title": "Table",
+      "description": "The file path to the equipment table, relative to the behavior pack's root.",
+      "$ref": "../../../../general/loot_table/identifier.json"
+    },
    "slot_drop_chance": {
      "type": "array",
      "title": "Slot Drop Chance",
@@ -22,6 +27,5 @@
        }
      }
    }
-  },
-  "description": "UNDOCUMENTATED: "
+  }
 }
--- a/source/behavior/entities/1.8.0/components/minecraft.experience_reward.json
+++ b/source/behavior/entities/1.8.0/components/minecraft.experience_reward.json
@@ -2,21 +2,21 @@
  "$id": "blockception.minecraft.behavior.entities.1.8.0.minecraft.experience_reward",
  "type": "object",
  "title": "Experience Reward 1.8.0",
-  "description": "UNDOCUMENTED",
-  "$comment": "UNDOCUMENTED",
+  "description": "Defines the amount of experience rewarded when the entity dies or is successfully bred.",
  "additionalProperties": false,
  "properties": {
    "on_bred": {
-      "type": "string",
      "default": 0,
      "description": "A molang expression defining the amount of experience rewarded when this entity is successfully bred. An array of expressions adds each expression's result together for a final total.",
-      "title": "On Bred"
+      "title": "On Bred",
+      "$ref": "../../../../molang/number.json"
    },
    "on_death": {
      "type": "string",
      "default": 0,
      "description": "A molang expression defining the amount of experience rewarded when this entity dies. An array of expressions adds each expression's result together for a final total.",
-      "title": "On Death"
+      "title": "On Death",
+      "$ref": "../../../../molang/number.json"
    }
  }
 }
--- a/source/behavior/entities/1.8.0/components/minecraft.health.json
+++ b/source/behavior/entities/1.8.0/components/minecraft.health.json
@@ -20,13 +20,13 @@
          "required": ["range_min", "range_max"],
          "properties": {
            "range_min": {
-              "title": "Range minimum",
+              "title": "Range Minimum",
              "description": "UNDOCUMENTED",
              "$comment": "UNDOCUMENTED",
              "type": "number"
            },
            "range_max": {
-              "title": "Range maximum",
+              "title": "Range Maximum",
              "description": "UNDOCUMENTED",
              "$comment": "UNDOCUMENTED",
              "type": "number"
--- a/source/behavior/entities/1.8.0/components/minecraft.hurt_on_condition.json
+++ b/source/behavior/entities/1.8.0/components/minecraft.hurt_on_condition.json
@@ -8,13 +8,11 @@
    "damage_conditions": {
      "type": "array",
      "title": "Damage Conditions",
-      "description": "UNDOCUMENTED",
-      "$comment": "UNDOCUMENTED",
+      "description": "An array of conditions used to compare the event to.",
      "items": {
        "type": "object",
        "title": "Damage Condition",
-        "description": "UNDOCUMENTED",
-        "$comment": "UNDOCUMENTED",
+        "description": "A condition used to compare the event to.",
        "additionalProperties": false,
        "properties": {
          "filters": { "$ref": "../../filters/filters.json" },
@@ -22,8 +20,7 @@
          "damage_per_tick": {
            "type": "integer",
            "title": "Damage Per Tick",
-            "description": "UNDOCUMENTED",
-            "$comment": "UNDOCUMENTED"
+            "description": "Amount of damage done each tick that the conditions are met."
          }
        }
      }
--- a/source/behavior/entities/1.8.0/components/minecraft.inside_block_notifier.json
+++ b/source/behavior/entities/1.8.0/components/minecraft.inside_block_notifier.json
@@ -12,8 +12,7 @@
      "type": "array",
      "items": {
        "title": "Block",
-        "description": "UNDOCUMENTED",
-        "$comment": "UNDOCUMENTED",
+        "description": "A of block, with certain block states, that we are monitoring to see if the entity is inside.",
        "type": "object",
        "additionalProperties": false,
        "properties": {
--- a/source/behavior/entities/1.8.0/components/minecraft.mob_effect.json
+++ b/source/behavior/entities/1.8.0/components/minecraft.mob_effect.json
@@ -2,7 +2,7 @@
  "$id": "blockception.minecraft.behavior.entities.1.8.0.minecraft.mob_effect",
  "type": "object",
  "title": "Mob Effect 1.8.0",
-  "description": "A component that applies a mob effect to entities that get within range.",
+  "description": "Applies a mob effect to entities that get within range.",
  "additionalProperties": false,
  "properties": {
    "effect_range": {
@@ -21,8 +21,7 @@
    "entity_filter": {
      "$ref": "../../filters/filters.json",
      "title": "Entity Filter",
-      "description": "UNDOCUMENTED",
-      "$comment": "UNDOCUMENTED"
+      "description": "Filter to use for conditions"
    }
  }
 }
--- a/source/behavior/entities/1.8.0/components/minecraft.movement.sway.json
+++ b/source/behavior/entities/1.8.0/components/minecraft.movement.sway.json
@@ -1,6 +1,6 @@
 {
  "$id": "blockception.minecraft.behavior.entities.1.8.0.minecraft.movement.sway",
-  "description": "This move control causes the mob to sway side to side giving the impression it is swimming.",
+  "description": "Causes the mob to sway side to side giving the impression it is swimming.",
  "type": "object",
  "title": "Movement.sway 1.8.0",
  "additionalProperties": false,
@@ -12,6 +12,10 @@
      "description": "The maximum number in degrees the mob can turn per tick.",
      "title": "Maximum Turn"
    },
-    "sway_amplitude": { "type": "number", "description": "UNDOCUMENTED", "$comment": "UNDOCUMENTED", "title": "Sway Amplitude" }
+    "sway_amplitude": {
+      "type": "number",
+      "description": "The amount of sway that is allowed for movement.",
+      "title": "Sway Amplitude"
+    }
  }
 }
--- a/source/behavior/entities/1.8.0/components/minecraft.navigation.float.json
+++ b/source/behavior/entities/1.8.0/components/minecraft.navigation.float.json
@@ -36,12 +36,8 @@
      "title": "Blocks To Avoid",
      "items": {
        "title": "Block",
-        "description": "UNDOCUMENTED",
-        "$comment": "UNDOCUMENTED",
-        "oneOf": [
-          { "type": "string", "$ref": "../../../../general/block/identifier.json" },
-          { "type": "object", "properties": { "name": { "$ref": "../../../../general/block/identifier.json", "title": "Name" } } }
-        ]
+        "description": "Tells the pathfinder which blocks to avoid when creating a path",
+        "$ref": "../../../../general/block/identifier.json"
      }
    },
    "can_breach": {
--- a/source/behavior/entities/1.8.0/components/minecraft.navigation.fly.json
+++ b/source/behavior/entities/1.8.0/components/minecraft.navigation.fly.json
@@ -36,12 +36,8 @@
      "title": "Blocks To Avoid",
      "items": {
        "title": "Block",
-        "description": "UNDOCUMENTED",
-        "$comment": "UNDOCUMENTED",
-        "oneOf": [
-          { "type": "string", "$ref": "../../../../general/block/identifier.json" },
-          { "type": "object", "properties": { "name": { "$ref": "../../../../general/block/identifier.json", "title": "Name" } } }
-        ]
+        "description": "Tells the pathfinder which blocks to avoid when creating a path",
+        "$ref": "../../../../general/block/identifier.json"
      }
    },
    "can_breach": {
--- a/source/behavior/entities/1.8.0/components/minecraft.navigation.generic.json
+++ b/source/behavior/entities/1.8.0/components/minecraft.navigation.generic.json
@@ -36,12 +36,8 @@
      "title": "Blocks To Avoid",
      "items": {
        "title": "Block",
-        "description": "UNDOCUMENTED",
-        "$comment": "UNDOCUMENTED",
-        "oneOf": [
-          { "type": "string", "$ref": "../../../../general/block/identifier.json" },
-          { "type": "object", "properties": { "name": { "$ref": "../../../../general/block/identifier.json", "title": "Name" } } }
-        ]
+        "description": "Tells the pathfinder which blocks to avoid when creating a path",
+        "$ref": "../../../../general/block/identifier.json"
      }
    },
    "can_breach": {
--- a/source/behavior/entities/1.8.0/components/minecraft.navigation.hover.json
+++ b/source/behavior/entities/1.8.0/components/minecraft.navigation.hover.json
@@ -35,12 +35,8 @@
      "title": "Blocks To Avoid",
      "items": {
        "title": "Block",
-        "description": "UNDOCUMENTED",
-        "$comment": "UNDOCUMENTED",
-        "oneOf": [
-          { "type": "string", "$ref": "../../../../general/block/identifier.json" },
-          { "type": "object", "properties": { "name": { "$ref": "../../../../general/block/identifier.json", "title": "Name" } } }
-        ]
+        "description": "Tells the pathfinder which blocks to avoid when creating a path",
+        "$ref": "../../../../general/block/identifier.json"
      }
    },
    "can_breach": {
--- a/source/behavior/entities/1.8.0/components/minecraft.navigation.swim.json
+++ b/source/behavior/entities/1.8.0/components/minecraft.navigation.swim.json
@@ -36,12 +36,8 @@
      "title": "Blocks To Avoid",
      "items": {
        "title": "Block",
-        "description": "UNDOCUMENTED",
-        "$comment": "UNDOCUMENTED",
-        "oneOf": [
-          { "type": "string", "$ref": "../../../../general/block/identifier.json" },
-          { "type": "object", "properties": { "name": { "$ref": "../../../../general/block/identifier.json", "title": "Name" } } }
-        ]
+        "description": "Tells the pathfinder which blocks to avoid when creating a path",
+        "$ref": "../../../../general/block/identifier.json"
      }
    },
    "can_breach": {
--- a/source/behavior/entities/1.8.0/components/minecraft.navigation.walk.json
+++ b/source/behavior/entities/1.8.0/components/minecraft.navigation.walk.json
@@ -36,12 +36,8 @@
      "title": "Blocks To Avoid",
      "items": {
        "title": "Block",
-        "description": "UNDOCUMENTED",
-        "$comment": "UNDOCUMENTED",
-        "oneOf": [
-          { "type": "string", "$ref": "../../../../general/block/identifier.json" },
-          { "type": "object", "properties": { "name": { "$ref": "../../../../general/block/identifier.json", "title": "Name" } } }
-        ]
+        "description": "Tells the pathfinder which blocks to avoid when creating a path",
+        "$ref": "../../../../general/block/identifier.json"
      }
    },
    "can_breach": {
--- a/source/behavior/entities/1.8.0/components/minecraft.shooter.json
+++ b/source/behavior/entities/1.8.0/components/minecraft.shooter.json
@@ -10,7 +10,7 @@
    "def": {
      "title": "Def",
      "type": "string",
-      "description": "Actor definition to use as projectile for the ranged attack. The actor definition must have the projectile component to be able to be shot as a projectile"
+      "description": "Actor definition to use as projectile for the ranged attack. The actor definition must have the projectile component to be able to be shot as a projectil"
    },
    "type": { "title": "Type", "type": "string", "description": "UNDOCUMENTED", "$comment": "UNDOCUMENTED" }
  }
--- a/source/behavior/entities/1.8.0/components/minecraft.timer.json
+++ b/source/behavior/entities/1.8.0/components/minecraft.timer.json
@@ -37,15 +37,17 @@
      "type": "array",
      "default": [],
      "description": "This is a list of objects, representing one value in seconds that can be picked before firing the event and an optional weight. Incompatible with time.",
+      "title": "Random Time Choices",
      "items": {
+        "title": "Random Time Choices",
+        "description": "representing one value in seconds that can be picked before firing the event and an optional weight. Incompatible with time.",
+        "type": "object",
+        "additionalProperties": false,
        "properties": {
          "weight": { "type": "integer", "description": "UNDOCUMENTATED: weight", "title": "Weight" },
          "value": { "type": "integer", "description": "UNDOCUMENTATED: value", "title": "Value" }
-        },
-        "description": "UNDOCUMENTATED: random time choices",
-        "title": "Random Time Choices"
-      },
-      "title": "Random Time Choices"
+        }
+      }
    }
  }
 }
--- a/source/behavior/entities/1.8.0/components/minecraft.water_movement.json
+++ b/source/behavior/entities/1.8.0/components/minecraft.water_movement.json
@@ -1,7 +1,6 @@
 {
  "$id": "blockception.minecraft.behavior.entities.1.8.0.minecraft.water_movement",
-  "description": "UNDOCUMENTED",
-  "$comment": "UNDOCUMENTED",
+  "description": "Defines the speed with which an entity can move through water.",
  "type": "object",
  "title": "Water Movement 1.8.0",
  "additionalProperties": false,
--- a/source/general/loot_table/identifier.json
+++ b/source/general/loot_table/identifier.json
@@ -0,0 +1,8 @@
+{
+  "$id": "blockception.minecraft.loot_table.identifier",
+  "type": "string",
+  "title": "Loot Table Identifier",
+  "description": "A minecraft loot_table identifier",
+  "pattern": "^loot_tables/.*\\.json$",
+  "examples": ["loot_tables/"]
+}