Files
netease-modsdk-wiki/docs/mconline/10-addon教程/第13章:更强大的方块/课程01.自定义方块实体.md
boybook 760c2dd9ad 2.6
2025-12-01 20:59:16 +08:00

57 lines
2.3 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
---
front: https://mc.res.netease.com/pc/zt/20201109161633/mc-dev/assets/img/1_1.be3fdadc.jpg
hard: 进阶
time: 15分钟
---
# 自定义方块实体
#### 作者:境界
自定义方块实体是一种可以保存复杂数据结构的方块类型。与方块状态不同的概念是,方块状态更多是保存一种单一的属性。以基岩版的铁砧为例,它带有一个方块状态:"damaged"来代表铁砧的损坏程度它接受四个值broken损坏的、slightly_damaged轻微受损的、undamaged完好的、very_damaged严重受损的。而方块实体则可以保存更复杂的数据内容如一个箱子方块里保存了一个物品数据。因此方块实体就是方块的内容方块状态更多看作是方块的属性。注意自定义方块实体功能为中国版特供所以开发者无法用同样的格式在国际板上自定义方块实体。
#### 如何自定义方块实体
![](./images/1_1.jpg)
```
{
"format_version": "1.16.0",
"minecraft:block": {
"description": {
},
"components": {
"netease:block_entity": {
"tick": true,
"movable": false
}
}
}
}
```
在自定义方块的components下开发者添加一个"netease:block_entity"的组件,其中有两个键对,"tick"设置为true时当玩家进入方块tick范围时该方块每秒会发送20次ServerBlockEntityTickEvent事件设置为false时则不会像脚本层发送事件。
"movable"用来设置该自定义方块实体是否可以被活塞推动。由于基岩版的设定,所有原版方块实体都可以被活塞推动,这里也为自定义方块实体提供了这一项功能。
#### tick与不tick
在需要方块保存数据而不需要实时更新方块内的数据时可以选择将tick设置为false。
例如玩家右键交互一个自定义方块实体每20下会随机掉落一个战利品。这里的方块实体保存数据只是为了记录玩家点击自己的次数因此可以将tick设置为false。
而当需要设置tick为true时往往该自定义方块实体需要不断更新自身的数据例如自定义一个熔炉方块当方块内有燃料并且正在烧东西时方块实体自身需要维护一个不断更新的燃烧物品时间则可以将该方块实体的tick设置为true。