Updated comments

source/behavior/entities/1.16.0/behaviors/minecraft.behavior.drink_potion.json

@@ -8,7 +8,7 @@
   "properties": {
     "priority": { "$ref": "./types/priority.json" },
     "speed_multiplier": { "$ref": "./types/speed_multiplier.json" },
-    "speed_modifier": { "default": 0.0, "description": "UNDOCUMENTED: speed modifier", "title": "Speed Modifier" },
+    "speed_modifier": { "default": 0.0, "description": "Movement speed modifier of the mob when using this AI Goal", "title": "Speed Modifier" },
     "potions": {
       "type": "array",
       "description": "A list of potions that this entity can drink.",
@@ -17,7 +17,7 @@
         "required": ["id", "chance", "filters"],
         "additionalProperties": false,
         "type": "object",
-        "description": "UNDOCUMENTED: potions",
+        "description": "A potions that this entity can drink.",
         "title": "Potions",
         "properties": {
           "id": { "type": "integer", "default": -1, "description": "The registry ID of the potion to use", "title": "Id" },

source/behavior/entities/1.16.0/behaviors/minecraft.behavior.equip_item.json

@@ -2,8 +2,7 @@
   "$id": "blockception.minecraft.behavior.entities.1.16.0.minecraft.behavior.equip_item",
   "type": "object",
   "title": "Equip Item 1.16.0",
-  "description": "UNDOCUMENTED",
-  "$comment": "UNDOCUMENTED",
+  "description": "Allows the entity to equip desired equipment.",
   "additionalProperties": false,
   "properties": { "priority": { "$ref": "types/priority.json" } }
 }

source/behavior/entities/1.16.0/behaviors/minecraft.behavior.go_home.json

@@ -4,25 +4,6 @@
   "description": "Allows the mob to move back to the position they were spawned.",
   "title": "Go Home",
   "type": "object",
-  "definitions": {
-    "on_home_spec": {
-      "additionalProperties": false,
-      "type": "object",
-      "title": "On Home Event",
-      "description": "UNDOCUMENTED",
-      "$comment": "UNDOCUMENTED",
-      "properties": {
-        "event": { "type": "string", "pattern": "^[a-zA-Z0-9_\\-:]+$", "description": "The event to fire", "title": "Event" },
-        "target": {
-          "type": "string",
-          "description": "The target of the event",
-          "title": "Target",
-          "enum": ["baby", "block", "damager", "other", "parent", "player", "self", "target"]
-        },
-        "filters": { "$ref": "../../filters/filters.json" }
-      }
-    }
-  },
   "properties": {
     "priority": { "$ref": "types/priority.json" },
     "speed_multiplier": { "$ref": "types/speed_multiplier.json" },
@@ -41,11 +22,7 @@
     "on_home": {
       "description": "Event to run when this mob gets home.",
       "title": "On Home",
-      "oneOf": [
-        { "type": "string", "pattern": "^[a-zA-Z0-9_\\-:]+$" },
-        { "type": "object", "$ref": "#/definitions/on_home_spec" },
-        { "type": "array", "items": { "$ref": "#/definitions/on_home_spec" } }
-      ]
+      "$ref": "../types/trigger.json"
     },
     "on_failed": {
       "$ref": "../types/event.json",

source/behavior/entities/1.16.0/behaviors/minecraft.behavior.knockback_roar.json

@@ -28,14 +28,20 @@
       "title": "Knockback Range"
     },
     "knockback_strength": { "type": "integer", "default": 4, "description": "The strength of the knockback.", "title": "Knockback Strength" },
-    "Trigger": { "$ref": "../types/trigger.json", "description": "On_roar_end", "title": "Trigger" },
     "knockback_filters": {
       "$ref": "../../filters/filters.json",
-      "description": "UNDOCUMENTED",
-      "$comment": "UNDOCUMENTED",
+      "description": "filters to use to decide what is affected by knockback roar.",
       "title": "Knockback Filters"
     },
-    "damage_filters": { "$ref": "../../filters/filters.json", "description": "UNDOCUMENTED", "$comment": "UNDOCUMENTED", "title": "Damage Filters" },
-    "on_roar_end": { "$ref": "../types/event.json", "description": "UNDOCUMENTED", "$comment": "UNDOCUMENTED", "title": "On Roar End" }
+    "damage_filters": {
+      "$ref": "../../filters/filters.json",
+      "description": "filters to use to decide what is damaged by knockback roar.",
+      "title": "Damage Filters"
+    },
+    "on_roar_end": {
+      "$ref": "../types/event.json",
+      "description": "Event to run when knockback roar has finished.",
+      "title": "On Roar End"
+    }
   }
 }

source/behavior/entities/1.16.0/behaviors/minecraft.behavior.rise_to_liquid_level.json

@@ -10,10 +10,17 @@
     "liquid_y_offset": {
       "type": "number",
       "title": "Liquid Y Offset",
-      "description": "UNDOCUMENTED",
-      "$comment": "UNDOCUMENTED"
+      "description": "Vertical offset from the liquid"
     },
-    "rise_delta": { "type": "number", "title": "Rise Delta", "description": "UNDOCUMENTED", "$comment": "UNDOCUMENTED" },
-    "sink_delta": { "type": "number", "title": "Sink Delta", "description": "UNDOCUMENTED", "$comment": "UNDOCUMENTED" }
+    "rise_delta": {
+      "type": "number",
+      "title": "Rise Delta",
+      "description": "Displacement for how much the entity will move up in the vertical axis"
+    },
+    "sink_delta": {
+      "type": "number",
+      "title": "Sink Delta",
+      "description": "Displacement for how much the entity will move down in the vertical axis"
+    }
   }
 }