教程:制作附加包/实体

实体

系列教程

所属系列

制作附加包

难度

中级

前置知识

• 开始之前
• 包的构建
• 运行、调试与导出

适用版本

国际版

≥ 1.16.100.59

实践设备

所需软件

◄◄ 战利品表

◄ 方块置换

模型 ►

地物 ►►

  本页面介绍的是自定义实体教程。关于实体开发信息，请见“实体”。

本教程版本为基岩版1.16及以上版本。在浏览完本教程之后，你将学会如何创建一个全新的自定义实体。

添加实体

实体行为定义文件

实体的服务端部分由行为包定义。

组件

关于实体行为定义文件的组件（实体服务端文档），请点此查看。

实体材质资源定义文件

实体的客户端部分由资源包定义。

文件

首先，在资源包内创建一个文件夹，并将其命名为“entity”，然后在entity文件夹中创建一个JSON文件并为其命名。实体定义文件需要格式版本（Format version）和 minecraft:client_entity 信息。

minecraft:client_entity部分包含了对该实体的描述。您可以为实体设置许多内容。通常，此文件定义了实体需要哪些资源，并为每个定义都提供了友好的名称，以使其他定义文件可以使用该资源。

猪的客户端实体定义json示例：

"format_version": "1.8.0",
  "minecraft:client_entity": {
     "description": {
       "identifier": "minecraft:pig",
       "min_engine_version": "1.8.0",
       "materials": { "default": "pig" },
       "textures": {
         "default": "textures/entity/pig/pig",
         "saddled": "textures/entity/pig/pig_saddle"
       },
       "geometry": {
         "default": "geometry.pig.v1.8"
       },
       "animations": {
         "setup": "animation.pig.setup",
         "walk": "animation.quadruped.walk",
         "look_at_target": "animation.common.look_at_target",
         "baby_transform": "animation.pig.baby_transform"
       },
       "animation_controllers": [
         { "setup": "controller.animation.pig.setup" },
         { "move": "controller.animation.pig.move" },
         { "baby": "controller.animation.pig.baby" }
       ],
       "render_controllers": [ "controller.render.pig" ],
       "locators": {
         "lead": { "head": [ 0.0, 14.0, -6.0 ] }
       },
       "spawn_egg": {
         "texture": "spawn_egg",
         "texture_index": 2
       }
     }
   }

组件

关于实体材质资源定义文件的组件（实体客户端文档），请点此查看。

恭喜！您现在了解了自定义实体的基本框架

接下来，您可以尝试制作属于您的第一个自定义实体了。

点击此处进入自定义第一个实体的教程。