mc.js原生不包含动物实体，需通过启用creatures配置、调用enableentities或手动创建实例来添加；支持牛、羊、猪等8种生物；行为依赖update周期、生命值、饥饿值和恐慌距离等参数驱动。
如果您在使用 mc.js 模拟环境时发现生物实体未正常生成或行为异常，可能是由于配置参数未启用生物群系、实体渲染开关被禁用，或脚本版本不支持默认生物加载。以下是关于 mc.js 中动物（即生物实体）存在性、种类范围及基础行为逻辑的详细说明：
一、mc.js 是否包含动物实体
mc.js 是一个基于 JavaScript 的轻量级 Minecraft 风格渲染与交互模拟库，其核心设计聚焦于方块世界建模与基础物理反馈。原生版本 默认不内置动物实体，所有生物（包括被动型如牛、羊、鸡，中立型如狼，敌对型如僵尸、骷髅）均需通过扩展模块或手动实例化添加。若未引入 entities.js 或启用 enableCreatures: true 配置项，则场景中不会自动出现任何可移动、有AI响应的动物。
二、支持加载的生物种类范围
当启用生物支持后，mc.js 兼容一组预定义的生物模板，这些模板基于 Minecraft Java 版 1.12 生物数据结构进行简化映射。可用生物严格限定在白名单内，超出列表的实体将无法初始化。当前稳定支持的动物类生物包括：
1、牛（Cow）
2、羊（Sheep）
3、猪（Pig）
4、鸡（Chicken）
5、兔子（Rabbit）
6、马（Horse）
7、豹猫（Ocelot）
8、鹦鹉（Parrot）
三、动物行为逻辑实现方式
mc.js 中的动物行为并非硬编码于主引擎，而是依托事件驱动模型与状态机组合实现。每个生物实例绑定独立的 update() 周期函数，每帧检查环境条件并触发对应动作。行为响应依赖三项关键参数：生命值、饥饿值、恐慌距离。例如，当玩家进入某只羊的 3.5 格检测半径 内且未手持小麦时，该羊将启动逃避逻辑，朝远离玩家的方向移动一格。
1、所有动物均具备基础移动能力，速度由 speed 属性控制，取值范围为 0.05–0.3
2、被动型动物在被攻击后会播放受击动画并后退，但不会反击
3、繁殖行为需同时满足：两只同种动物均处于“就绪”状态、玩家在场、周围有至少 9 格空地
4、死亡后掉落对应物品（如牛掉落牛肉和皮革），掉落逻辑由 dropTable 字段定义
四、启用动物显示的三种配置方法
要使动物在 mc.js 场景中可见并具备行为，必须完成至少一种激活操作。不同方法适用于不同集成场景，互不冲突可叠加使用：
1、在初始化 world 实例时传入 { creatures: true } 选项
2、调用全局方法 MC.enableEntities(['cow', 'sheep', 'chicken']) 显式注册所需生物类型
3、手动创建生物实例并添加至场景： const cow = new MC.Cow({ x: 10, y: 64, z: 15 }); world.addEntity(cow);
五、常见动物不显示的原因排查
若已执行启用操作但动物仍未出现，需逐项验证以下运行时条件是否满足。任一条件失败都将导致生物不可见或静止不动：
1、确认当前加载的 mc.js 版本 ≥ v2.4.1，低于此版本无生物系统接口
2、检查浏览器控制台是否存在 "EntityRegistry not found" 报错，表示 entities 扩展未载入
3、验证世界坐标系中动物被放置的位置 y 值是否 ≥ 63，低于该值将因地形遮挡而不可见
4、确认未启用 renderEntities: false 或 disableAI: true 等屏蔽选项
