登录 立即注册
BE教程

附加包教程：29.实体

Cat_A***Lv.4 高级会员 发表于 2023-3-6 · 最后回复 2023-3-6 IP:天津 2,878 2
AI 速览2026-09-25 09:42 生成

附加包教程第29期：实体属性、排列与别名的学习指引

这是附加包系列教程的第二十九期，主题是实体。作者坦言实体组件数量庞大，无法逐一讲解，因此把重点放在引导读者自学上，推荐了官方实体文档和常用参考网站，并介绍了实体属性、排列与别名这几个特性。其中排列与别名已被弃用，作者出于理解旧版附加包的需要保留了相关段落。适合正在学习基岩版附加包、需要了解实体数据驱动写法的制作者参考。

帖内链接
  • 排列与别名功能已于1.21.10.22弃用，请勿使用该旧系统。
  • 官方实体文档尚未汉化，可借助浏览器翻译阅读。
  • 学习排列与别名前建议先掌握实体属性。
  • 实体组件数量庞大，教程未逐一讲解，需自行查阅文档。
本卡片由 AI 阅读本帖后生成，可能存在疏漏，请以帖子正文为准。
本帖最后由 Cat_Anchor 于 2024-6-6 19:57 编辑

前言

终于到了实体教程了，但我要写在前面的是：我不知道怎么写实体教程，于是就略过了。这主要是因为实体的组件太多了，无法像学习方块或物品那样。因此，需要——
自学实体。

首先，实体的组件特别特别多，因为它基本是官方的主要数据驱动对象。想要让我把所有实体的代码内容全放出来是不可能的。所以，各位附加包制作者就要学会自己写代码。打开官方实体文档，这里的内容十分详细，而且有官方性质，是学习附加包的好地方。只需要随便点开一个组件，立马就能蹦出来它的详细信息和例子等内容。虽然它还没有汉化，但是把浏览器的翻译模式打开就好了。我相信，只要玩MC的，那么对这些代码总是不会感到陌生。
另外，也可以参考一下这里，这也是一个我常用的网站，内容十分实用。
当然了，我怎么可能只教这些普通的内容？我还要教各位一个新东西——实体属性。这就是我说实体文档和方块文档相似的原因。在官方文档的英文版，你可以找到关于实体属性的描述，而且原版实体“蜜蜂”也运用了这个新特性。看到这个以后，我立刻放弃了教实体属性的打算，我要告诉各位，实体也可以有排列（Permutations）！甚至还可以有别名（Aliases）！（这两个特性现已弃用。）
实验性内容

注意：此段落所述功能已于1.21.10.22被弃用，请勿使用此系统。
然而，出于学习并理解旧版附加包的必要性，我保留了这个段落。


首先，我放一篇示例文档，这样大家就可以学会这些新特性了。值得注意的是，这两个与实体属性有很大关系，建议你先去官方文档把实体属性学了。

  2. {
  3.   "format_version": "1.19.0",
  4.   "minecraft:entity": {
  5.     "description": {
  6.       "identifier": "supplementary:container", //实体ID
  7.       "is_spawnable": false, //是否有刷怪蛋，是否可以自然生成
  8.       "is_summonable": true, //是否可以被/summon命令生成
  9.       "is_experimental": false, //是否属于实验性内容
  10.       "properties": { //指定了实体属性
  11.         "supplementary:slot_count": { //一个属性，名叫supplementary:slot_count。
  12.           "type": "int", //属性的类型
  13.           "range": [ //属性的范围，根据属性的类型决定有没有这一项
  14.             0, //最小值
  15.             256 //最大值
  16.           ],
  17.           "default": 0 //默认值
  18.         }
  19.       },
  20.       "aliases": { //指定了实体的别名
  21.         "supplementary:container.0": {}, //这里，supplementary:container.0是别名，后面没有东西代表这个别名使用默认的实体属性值（这里是0）。
  22.         "supplementary:container.1": { //这里，supplementary:container.1是别名，后面的supplementary:slot_count是实体属性名称，1代表这个属性的值
  23.           "supplementary:slot_count": 1
  24.         },
  25.         "supplementary:container.2": {
  26.           "supplementary:slot_count": 2
  27.         },
  28.         "supplementary:container.7": {
  29.           "supplementary:slot_count": 7
  30.         } //注意，这些别名可以通过/summon命令使用。在这个例子里，/summon supplementary:container和/summon supplementary:container.0的作用是一样的。
  31.       }
  32.     },
  33.     "component_groups": {吧啦吧啦一大堆，都不重要},
  34.     "components": {又吧啦吧啦一大堆，还是都不重要},
  35.     "permutations": [ //看到这个，你应该立刻就想到方块属性。没错，又是一样的格式。
  36.       {
  37.         "condition": "query.property('supplementary:slot_count') == 1", //Molang表达式，如果输出true，那么用下面的这些组件替换掉原本的组件。这里的意思是查询属性supplementary:slot_count的值是否为1。
  38.         "components": { //组件列表
  39.           "minecraft:inventory": { //实体拥有的物品栏
  40.             "container_type": "container", //物品栏类型：容器
  41.             "inventory_size": 1, //物品栏大小
  42.             "can_be_siphoned_from": false //是否可以被漏斗吸走物品或输入物品。false是不行，true是可以。
  43.           }
  44.         }
  45.       },
  46.       {
  47.         "condition": "query.property('supplementary:slot_count') == 2",
  48.         "components": {
  49.           "minecraft:inventory": {
  50.             "container_type": "container",
  51.             "inventory_size": 2,
  52.             "can_be_siphoned_from": false
  53.           }
  54.         }
  55.       },
  56.       {
  57.         "condition": "query.property('supplementary:slot_count') == 7",
  58.         "components": {
  59.           "minecraft:inventory": {
  60.             "container_type": "container",
  61.             "inventory_size": 7,
  62.             "can_be_siphoned_from": false
  63.           }
  64.         }
  65.       }
  66.     ],
  67.     "events": {
  68.       "supplementary:set_slot_count_0": {
  69.         "set_property": {
  70.           "supplementary:slot_count": 0 //这里的这个事件方法用于设置实体属性的值，这里是把supplementary:slot_count设置为0。
  71.         }
  72.       },
  73.       "supplementary:set_slot_count_1": {
  74.         "set_property": {
  75.           "supplementary:slot_count": 1
  76.         }
  77.       },
  78.       "supplementary:set_slot_count_2": {
  79.         "set_property": {
  80.           "supplementary:slot_count": 2
  81.         }
  82.       },
  83.       "supplementary:set_slot_count_7": {
  84.         "set_property": {
  85.           "supplementary:slot_count": 7
  86.         }
  87.       }
  88.     }
  89.   }
  90. }
复制代码

总结

这一期，我们学习了实体的属性（Properties）、排列（Permutations）和别名（Aliases）。属性可以控制动画效果，与排列和别名合起来就可以控制实体代码了。到这里，实体教程基本上就结束了，但这不意味着以后我们不会学习实体了。相反，以后我会用具体情景告诉各位实体代码怎么写。如果想了解更多，请持续关注本系列。下一期，我们即将学习粒子。


回复 2 最早 最新 只看楼主
返回列表
高级模式
B Color Image Link Quote Code Smilies
您需要登录后才可以回帖 登录 | 立即注册
本版积分规则