跳转至

方块管理器

方块管理器允许你与 Nova 的方块交互. 你可以放置/破坏/捡起掉落物等.

你可以使用之前获取的 Nova 实例来获得 BlockManager.

val blockManager = Nova.blockManager

BlockManager blockManager = nova.getBlockManager(); // (1)!
  1. "nova" 是之前获取的 Nova 实例, 默认存储在一个字段或变量中.
    你也可以调用 Nova.getNova().getMaterialRegistry()

获取一个方块的状态

你还可以使用方块管理器来获得某一位置的方块状态.

val blockState = blockManager.getBlock(location) ?: return

NovaBlockState blockState = blockManager.getBlock(location);
if (blockState == null)
    return;

你还可以通过 BlockManager.hasBlock(Location) 来检测某一位置的方块是否是 Nova 的方块。

Block Type

NovaBlock 是一种方块类型, 类似 Bukkit 中的 Material, 但是只能用于方块.
要检索特定位置的方块类型，可以执行以下操作：

val blockState = blockManager.getBlock(location) ?: return
val block = blockState.block

NovaBlockState blockState = blockManager.getBlock(location);
if (blockState == null)
    return;
NovaBlock block = blockState.getBlock();

Tile Entity

方块实体 使用 NovaTileEntityState 类，通过使用该类来获取方块的方块实体实例.

val blockState = blockManager.getBlock(location) ?: return
if (blockState is NovaTileEntityState) {
    val tileEntity = blockState.tileEntity
}

NovaBlockState blockState = blockManager.getBlock(location);
if (blockState == null)
    return;
if (blockState instanceof NovaTileEntityState tileEntityState) {
    TileEntity tileEntity = tileEntityState.getTileEntity();
}

放置方块

通过使用 NovaBlock 来在指定位置放置 nova 方块.

val block = blockRegistry.get("machines:pulverizer")
blockManager.placeBlock(
    location, // (1)!
    block, // (2)!
    player, // (3)!
    true // (4)!
)
  1. 放置方块的位置.
  2. 放置的方块类型.
  3. 放置方块的目标. 目标不一定是玩家, 也可以是方块实体或其它类似实体.
  4. 是否播放方块放置音效.
NovaBlock block = blockRegistry.get("machines:pulverizer");
blockManager.placeBlock(
    location, // (1)!
    block, // (2)!
    player, // (3)!
    true // (4)!
);
  1. 放置方块的位置.
  2. 放置的方块类型.
  3. 放置方块的目标. 目标不一定是玩家, 也可以是方块实体或其它类似实体.
  4. 是否播放方块放置音效.

提示

BlockManager.placeBlock 函数有一些需要更少实参的覆盖.

获取一个方块的掉落物

要获取一个方块的掉落物, 可以使用 BlockManager.getDrops 函数. 该函数同样有一些需要更少实参的覆盖.

注意

如果所给的位置没有 Nova 方块此函数将返回 null.

val drops = blockManager.getDrops(
    location, // (1)!
    player, // (2)!
    tool // (3)!
)
  1. 方块的位置.
  2. 目标实体, 目标不一定是玩家, 也可以是方块实体或其它类似实体.
  3. 破坏方块所用的工具.
List<ItemStack> drops = blockManager.getDrops(
    location, // (1)!
    player, // (2)!
    tool // (3)!
);
  1. 方块的位置.
  2. 目标实体, 目标不一定是玩家, 也可以是方块实体或其它类似实体.
  3. 破坏方块所用的工具.

移除一个方块

你可以使用 BlockManager.removeBlock 函数来移除某个位置的方块. 该函数将会返回一个 boolean, 该布尔值代表所给位置是否有方块或是所给位置的方块是否成功移除.

blockManager.removeBlock(
    location, // (1)!
    player, // (2)!
    true, // (3)!
    true // (4)!
)
  1. 方块的位置.
  2. 目标实体, 目标不一定是玩家, 也可以是方块实体或其它类似实体.
  3. 方块移除时是否播放音效.
  4. 是否显示方块破坏的粒子效果.
blockManager.removeBlock(
    location, // (1)!
    player, // (2)!
    true, // (3)!
    true // (4)!
);
  1. 方块的位置.
  2. 目标实体, 目标不一定是玩家, 也可以是方块实体或其它类似实体.
  3. 方块移除时是否播放音效.
  4. 是否显示方块破坏的粒子效果.