User Tools

Site Tools


zh_cn:tutorial:waterloggable

让方块可含水

要让方块可含水,实现 Waterloggable 接口并覆盖一些方法。

public class VerticalSlabBlock extends HorizontalFacingBlock implements Waterloggable {
    [...]
}

在本例中,我们将 Properties.WATERLOGGED 存储为类中的静态字段,然后你可以直接使用 WATERLOGGED 来访问这个字段。(虽然不必要,但是大多数 Minecraft 原版的方块类都是这么做的,所以我们也这么做。当然你也可以不这么做,然后每次使用 Properties.WATERLOGGED 来访问,或者直接导入静态字段。)我们需要手动让方块认识这个属性,因为 Waterloggable 接口并没有自动为你完成这些。

    // 注意 ''Properties'' 是 net.minecraft.state.property.Properties,别导入错了。
    public static final BooleanProperty WATERLOGGED = Properties.WATERLOGGED;
 
    // 将 WATERLOGGED 属性的默认值设为 ``false``
    public VerticalSlabBlock(Settings settings) {
        super(settings);
        setDefaultState(getDefaultState()
            .with(Properties.HORIZONTAL_FACING, Direction.NORTH)
            .with(WATERLOGGED, false));
    }
 
    // 让方块认识这个属性,否则设置该属性将会抛出异常。
    @Override
    protected void appendProperties(StateManager.Builder<Block, BlockState> builder) {
        builder.add(Properties.HORIZONTAL_FACING, WATERLOGGED);
    }

我们还需要覆盖 getPlacementState,这样放在水中的方块就会一开始就含水。

    @Override
    public BlockState getPlacementState(ItemPlacementContext ctx) {
        return this.getDefaultState()
            .with(Properties.HORIZONTAL_FACING, ctx.getHorizontalPlayerFacing().getOpposite())
            .with(WATERLOGGED, ctx.getWorld().getFluidState(ctx.getBlockPos()).getFluid() == Fluids.WATER);
    }

覆盖 getFluidState,这样方块含水后就会显示水。

    @Override
    public FluidState getFluidState(BlockState state) {
        return state.get(WATERLOGGED) ? Fluids.WATER.getStill(false) : super.getFluidState(state);
    }

覆盖 getStateForNeighborUpdate,以正确地处理水流。

1.21.2 之前的版本,请这么写:

    @Override
    public BlockState getStateForNeighborUpdate(BlockState state, Direction direction, BlockState neighborState, WorldAccess world, BlockPos pos, BlockPos neighborPos) {
        if (state.get(WATERLOGGED)) {
            // 对于 1.17 以及更低的版本:
            // world.getFluidTickScheduler().schedule(pos, Fluids.WATER, Fluids.WATER.getTickRate(world));
            // 对于 1.18 之后、1.21.2 之前的版本:
            world.scheduleFluidTick(pos, Fluids.WATER, Fluids.WATER.getTickRate(world));
        }
 
        return super.getStateForNeighborUpdate(state, direction, neighborState, world, pos, neighborPos);
    }

1.21.2 以及更高的版本,请这么写:

    @Override
    public BlockState getStateForNeighborUpdate(BlockState state, WorldView world, ScheduledTickView tickView, BlockPos pos, Direction direction, BlockPos neighborPos, BlockState neighborState, Random random) {
        if (state.get(WATERLOGGED)) {
            // For versions since 1.21.2:
            tickView.scheduleFluidTick(pos, Fluids.WATER, Fluids.WATER.getTickRate(world));
        }
 
        return super.getStateForNeighborUpdate(state, world, tickView, pos, direction, neighborPos, neighborState, random);
    }

现在方块可含水了,并且与水有关的功能都能正常运作。

zh_cn/tutorial/waterloggable.txt · Last modified: 2024/10/27 14:59 by solidblock