方块实体

BlockEntities类似于绑定到某一方块的简化的Entities。 它们能用于存储动态数据、执行基于游戏刻的任务和动态渲染。 原版Minecraft中的一些例子是处理箱子的物品栏、熔炉的熔炼逻辑或信标的区域效果。 模组中存在更高级的示例，例如采石场（如BC）、分拣机（如IC2）、管道（如BC）和显示器（如OC）。（括号内容为译者注。）

注册

方块实体是动态创建和删除的，因此它们本身不是注册表对象。

为了创建BlockEntity，你需要继承BlockEntity类。这样，另一个对象被替代性地注册以方便创建和引用动态对象的类型。对于BlockEntity，这些对象被称为BlockEntityType。

BlockEntityType可以像任何其他注册表对象一样进行注册。若要构造BlockEntityType，可以通过BlockEntityType$Builder#of使用其Builder形式。这需要两个参数：BlockEntityType$BlockEntitySupplier，它接受BlockPos和BlockState来创建关联BlockEntity的新实例，以及该BlockEntity可以附加到的Block的可变参数。构建该BlockEntityType是通过调用BlockEntityType$Builder#build来完成的。其接受一个Type，表示用于引用某个DataFixer中的此注册表对象的类型安全引用。由于DataFixer是用于模组的可选系统，因此其也可用null代替。

// 对于某个类型为DeferredRegister<BlockEntityType<?>>的REGISTER
public static final RegistryObject<BlockEntityType<MyBE>> MY_BE = REGISTER.register("mybe", () -> BlockEntityType.Builder.of(MyBE::new, validBlocks).build(null));

// 在MyBE（一个BlockEntity的子类）中
public MyBE(BlockPos pos, BlockState state) {
  super(MY_BE.get(), pos, state);
}

创建一个BlockEntity

要创建BlockEntity并将其附加到Block，EntityBlock接口必须在你的Block子类上实现。方法EntityBlock#newBlockEntity(BlockPos, BlockState)必须实现并返回一个你的BlockEntity的新实例。

将数据存储到你的BlockEntity

为了保存数据，请重写以下两个方法：

BlockEntity#saveAdditional(CompoundTag tag)

BlockEntity#load(CompoundTag tag)

计时的BlockEntity

如果你需要一个计时的BlockEntity，例如为了跟踪冶炼过程中的进度，则必须在EntityBlock中实现并重写另一个方法：EntityBlock#getTicker(Level, BlockState, BlockEntityType)。这可以根据用户所处的逻辑端实现不同的计时器，或者只实现一个通用计时器。无论哪种情况，都必须返回BlockEntityTicker。由于这是一个功能性的接口，因此它可以转而采用一个表示计时器的方法：

// 在某个Block子类内
@Nullable
@Override
public <T extends BlockEntity> BlockEntityTicker<T> getTicker(Level level, BlockState state, BlockEntityType<T> type) {
  return type == MyBlockEntityTypes.MYBE.get() ? MyBlockEntity::tick : null;
}

// 在MyBlockEntity内
public static void tick(Level level, BlockPos pos, BlockState state, MyBlockEntity blockEntity) {
  // 处理一些事情
}

向客户端同步数据

有三种方法可以将数据同步到客户端：在区块加载时同步、在方块更新时同步以及使用自定义网络消息同步。

在LevelChunk加载时同步

为此你需要重写

BlockEntity#getUpdateTag()

IForgeBlockEntity#handleUpdateTag(CompoundTag tag)

在方块更新时同步

这个方法有点复杂，但同样，你只需要重写两个或三个方法。 下面是它的一个简易的实现示例：

@Override
public CompoundTag getUpdateTag() {
  CompoundTag tag = new CompoundTag();
  //将你的数据写入标签
  return tag;
}

@Override
public Packet<ClientGamePacketListener> getUpdatePacket() {
  // 将从#getUpdateTag得到标签
  return ClientboundBlockEntityDataPacket.create(this);
}

// 可以重写IForgeBlockEntity#onDataPacket。默认地，其将遵从#load。

• 该BlockEntity。
• 从该BlockEntity中获取CompoundTag的可选函数。默认情况下，其使用BlockEntity#getUpdateTag。

现在，要发送数据包，必须在服务端上发出更新通知。

Level#sendBlockUpdated(BlockPos pos, BlockState oldState, BlockState newState, int flags)

使用自定义网络消息同步

这种同步方式可能是最复杂的，但通常是最优化的，因为你可以确保只有需要同步的数据才是真正同步的。在尝试之前，你应该先查看Networking部分，尤其是SimpleImpl。一旦你创建了自定义网络消息，你就可以使用SimpleChannel#send(PacketDistributor$PacketTarget, MSG)将其发送给所有加载了该BlockEntity的用户。