概念
特性
All blocks are of a base type. Examples of base types include redstone dust, brick stairs, and chest. However, to further differentiate these base types, each block has set of different properties, of which each can take a limited set of values (i.e. activated redstone, corner brick stairs, double chest). A block can have multiple properties (such as corner,*upsidedown* stairs).
方块属性的例子:
minecraft:dirt[snowy=false,variant=default] minecraft:dirt[snowy=true,variant=default] minecraft:dirt[snowy=false,variant=grassless] minecraft:dirt[snowy=true,variant=grassless] minecraft:redstone_wire[east=up,north=up,power=0,south=up,west=up] minecraft:redstone_wire[east=side,north=up,power=0,south=up,west=up] minecraft:redstone_wire[east=none,north=up,power=0,south=up,west=up] minecraft:redstone_wire[east=up,north=side,power=0,south=up,west=up]
然而,有些属性是临时的——它们只在游戏运行的时候才存在。它们的值不会被写入到存档文件中,因为它们的值可以被自动检测到。例如,就红石线来说,它们的被充能与否可以通过环境被检测到 (在这里有一个打开的拉杆么?) 。按照这种标准,minecraft:redstone_wire
的 power
属性,就是一个临时属性。
Each property will have a finite number of valid values that can be assigned to the property. Exampeles would be that redstone power can only be a value between 0 and 15. This means that Minecraft knows each possible state of a block prior to fully booting the server. This is required knowledge as sending blocks over the network are compressed to a number.
Block Entity Data
With block properties having a known preset of possible values, these cannot be used when attempting to store data whereby there is a infinite amount of possibilities. Examples include sign text and block inventories.
Minecraft’s solution to this is block entities, which are Java objects that store additional data on a Location the block is at in NBT format. Examples of block entities are Chest
Example use would be to receive the inventory of a chest. This can be done as follows
import org.spongepowered.api.world.server.ServerLocation;
import org.spongepowered.api.block.entity.BlockEntity;
import org.spongepowered.api.block.entity.carrier.chest.Chest;
import org.spongepowered.api.item.inventory.type.BlockEntityInventory;
public Optional<BlockEntityInventory<Chest>> getChestInventory(ServerLocation location){
Optional<BlockEntity> optionalBlockEntity = location.blockEntity();
if(optionalBlockEntity.isPresent()){
BlockEntity blockEntity = optionalBlockEntity.get();
if(blockEntity instanceof Chest){
Chest chest = (Chest) blockEntity;
return Optional.of(chest.inventory());
}
}
return Optional.empty();
}
小訣竅
一些东西,比如说挂画,实际上是实体(Entity)。
不过,Tile Entity也可以覆写渲染方法使其看起来不太像一个正常的方块,尽管这往往效率低下而且会造成客户端的帧率下降。