Entity JSON Errors in Bedrock Samples – axolotl.json and bee.json Issues

Entity JSON Errors in Bedrock Samples – axolotl.json and bee.json Issues

Quick Answer: The behavior_pack/entities/axolotl.json and bee.json files in Mojang/bedrock-samples contain component errors and outdated syntax (Issue #6). These are among the oldest reported issues (2022) and remain unfixed. Use vanilla entity exports instead of these samples.

Details: Issue #6 reports specific errors in axolotl.json and bee.json entity definitions. Common problems include: deprecated component names, missing required components, incorrect component group syntax, and behaviors that don’t match current vanilla entities.

Common Entity JSON Issues in Samples

• Deprecated components: Old component names like minecraft:breathable → minecraft:breathable (renamed), minecraft:navigation.generic → minecraft:navigation.walk
• Missing components: Modern entities require minecraft:collision_box, minecraft:movement, minecraft:navigation.*
• Component group errors: add/remove vs component_groups syntax confusion
• Event formatting: Old "event": "minecraft:entity_born" vs new "trigger": "minecraft:entity_born"
• Spawn egg: Missing minecraft:spawn_egg component

Correct Entity Template Structure (Modern)

{
  "format_version": "1.21.0",
  "minecraft:entity": {
    "description": {
      "identifier": "my_pack:custom_entity",
      "is_spawnable": true,
      "is_summonable": true,
      "is_experimental": false,
      "scripts": { "animate": ["controller.general"] },
      "animations": {
        "controller.general": "controller.animation.custom_entity.general"
      }
    },
    "component_groups": {
      "my_pack:baby": { "minecraft:is_baby": {} },
      "my_pack:adult": { "minecraft:is_baby": {} }
    },
    "components": {
      "minecraft:type_family": { "family": ["custom_entity", "mob"] },
      "minecraft:collision_box": { "width": 0.6, "height": 1.8 },
      "minecraft:movement": { "value": 0.25 },
      "minecraft:navigation.walk": { "can_path_over_water": true },
      "minecraft:health": { "value": 20, "max": 20 },
      "minecraft:nameable": { "allow_name_tag_renaming": true },
      "minecraft:spawn_egg": { "texture": "custom_entity" }
    },
    "events": {
      "minecraft:entity_spawned": {
        "randomize": [
          { "weight": 90, "add": { "component_groups": ["my_pack:adult"] } },
          { "weight": 10, "add": { "component_groups": ["my_pack:baby"] } }
        ]
      },
      "minecraft:ageable_grow_up": {
        "remove": { "component_groups": ["my_pack:baby"] },
        "add": { "component_groups": ["my_pack:adult"] }
      }
    }
  }
}

Best Practice: Use Vanilla Entity Export

Always reference the exported vanilla behavior pack entities (Settings → Storage → Export Vanilla Behavior Pack → entities/) for accurate, version-correct definitions. The samples repo is not maintained for entity accuracy.

Last updated: 2026-07-14