我的世界中国版 Wiki

主题

实体问题排查指南 ​

本页面镜像自
BedrockWiki

根据原始项目协议授权。本文经过AI翻译处理，如有内容遗漏，可以提交PR进行补充。

TIP

本页面包含关于_实体_的疑难解答信息。在继续阅读前，请务必先查阅全局问题排查指南。

WARNING

请始终记得检查内容日志！

0.0.0 - 确认问题存在 ​

承认吧，某个地方肯定出错了。_任何_水平的开发者在_任何_阶段都可能出现这些疏漏，所以不要觉得被冒犯而想着"我当然会注意这些！"，然后跳过必要的检查步骤！

继续

1.0.0 - 确保两个包都已启用 ​

确认资源包和行为包在世界中都已激活（一个绝佳的防错方法是在两个包的manifest.json文件中互相设置依赖，这样添加或移除其中一个包时会自动同步处理）

继续

2.0.0 - 确定问题出现在资源包还是行为包 ​

通过观察实体生成蛋在创造模式物品栏中的显示状态，可以有效定位问题范围。即使您不打算为实体添加生成蛋，请暂时按照以下步骤添加以便定位问题：

在资源包中 ​

确保.entity文件包含自定义spawn_egg配置：

json
"spawn_egg":{
    "base_color": "#FF0000",
    "overlay_color": "#FFFF00"
}

（建议选择除"#000000"以外的配色以方便排查）

在行为包中 ​

确保description对象中开启is_spawnable和is_summonable，并将is_experimental设为false：

json
"description":{
    "identifier": "wiki:example_entity",
    "is_spawnable": true,
    "is_summonable": true,
    "is_experimental": false
}

现象分析 ​

完全看不到生成蛋：

能看到生成蛋但颜色全黑且无法生成实体：

生成蛋显示正常颜色但仍旧无法生成实体：

3.0.0 - 定位具体问题 ​

3.1.0 - 行为包问题 ​

即使已在行为文件中设置"is_spawnable": true，在创造模式物品栏中依然无法找到生成蛋

这通常表示游戏未能正确识别实体行为文件。常见原因包括：

  • Json语法错误
  • 文件夹命名错误

3.1.1 - 语法错误 ​

单个语法错误会导致整个json文件失效。建议使用JSON验证工具检查文件的语法完整性（注：虽然该网站会将//注释视为错误，但在Minecraft中实际允许使用注释）

3.1.2 - 文件夹误命名 ​

请确认行为包中的实体文件夹命名为"entities"（资源包对应的是"entity"，这个不一致设定确实容易引起困惑）

步骤3.2.0 - 资源包.entity文件问题 ​

能在创造模式物品栏中看到生成蛋，但显示为黑色且实体名异常（如"item.spawn_egg.entity.wiki:your_mob.name"），且无法正常生成实体

此现象说明行为文件已生效，但资源包未能正确关联对应.entity文件。常见原因包括：

  • .entity文件语法错误
  • 实体identifier不匹配
  • 资源引用路径错误
  • 资源包文件夹应命名为"entity"，行为包文件夹应命名为"entities"

步骤3.2.1 - 语法错误 ​

再次推荐使用JSON验证工具进行深度校验（注意注释标识的兼容性问题）

步骤3.2.2 - 标识符不匹配 ​

需确保资源包.entity文件与行为包的identifier字段完全一致，包括命名空间（冒号前的部分，例如minecraft:bat中的minecraft）。特别注意：

  • 除了冒号外不要使用特殊字符
  • 命名空间和ID避免以数字或大写字母开头（虽然现行版本允许，但历史版本曾存在兼容性问题）
  • 非官方实体切勿使用minecraft作为命名空间

步骤3.2.3 - 无效资源引用 ​

检查.entity文件中各项资源引用路径是否正确指向有效文件

步骤3.3.0 - 资源包资源排查（进行中） ​

生成蛋显示正常颜色但在生成/召唤时实体不可见或仅显示阴影

这说明基本功能文件已正常加载，但存在次级资源配置问题。根据现象选择排查方向：

  • 完全隐形无阴影 → 资源引用错误：
    前往
  • 隐形但显示阴影 → 几何体问题：
    前往
  • 可见但贴图异常 → 材质问题：
    前往
  • 可见但渲染异常 → 材质类型错误：
    前往

3.3.1 - 完全隐形无阴影 ​

确认实体未设置立即消失逻辑（如instant_despawn），优先检查实体基础配置。

3.3.2 - 隐形但显示阴影 ​

此类问题通常涉及模型或材质配置，排查重点：

  1. 几何体文件：检查命名正确性、文件完整性和几何偏移量设置
  2. 材质匹配：例如透明材质与普通材质的兼容性
  3. 渲染控制器：验证控制器逻辑与参数设置

3.3.3 - 可见但贴图异常 ​

（内容开发中）

3.3.4 - 可见但渲染异常 ​

（内容开发中）