跳转至

自定义实体系列教程

自定义实体通常需要行为包和资源包同时配合。行为包负责服务端定义，例如组件、AI意向、碰撞箱、生命值、战利品和是否可召唤；资源包负责客户端定义，例如模型、纹理、渲染控制器、动画、粒子、声音和刷怪蛋颜色。

文件关系

  • demo_BP
    • entities
      • robot.json
  • demo_RP
    • entity
      • robot.entity.json
    • models
      • entity
        • robot.geo.json
    • textures
      • entity
        • robot.png
    • texts
      • en_US.lang

这些文件通过同一个标识符demo:robot关联。文件名本身不是最关键的，但统一命名能让项目更容易维护。

推荐顺序

  1. 先做最小实体，只让/summon demo:robot能生成。
  2. 再添加客户端实体、模型和纹理，让它不再隐形。
  3. 添加本地化和刷怪蛋。
  4. 添加组件、事件和AI意向。
  5. 最后再加入动画、粒子、声音、战利品和生成规则。
  6. 需要为实体存储自定义状态时，参考实体属性，了解如何用原生属性系统替代哑组件。

调试原则

如果实体无法生成，先看行为包；如果能生成但看不见，先看资源包。实体问题很容易同时出现在两边，因此建议每一步都进游戏测试，不要一次写完所有文件再排错。

进阶专题

掌握基础之后，可以继续探索以下专题：