Package org.spongepowered.api.block

Interface BlockState

All Superinterfaces:

CopyableDataHolder, DataHolder, DataHolder.Immutable<BlockState>, DataSerializable, DirectionRelativeDataHolder, DirectionRelativeDataHolder.Immutable<BlockState>, SerializableDataHolder, SerializableDataHolder.Immutable<BlockState>, State<BlockState>, ValueContainer

public interface BlockState
extends State<BlockState>, DirectionRelativeDataHolder.Immutable<BlockState>

Represents a particular "state" that can exist at a ServerLocation with a particular BlockType and various Value.Immutables defining the information for the "block". Note that normally, there may exist only a single instance of a particular BlockState as they are immutable, a particular instance may be cached for various uses.

Nested Class Summary

Nested Classes

Modifier and Type	Interface	Description
static interface	BlockState.Builder	An DataHolderBuilder.Immutable for a BlockState.

Nested classes/interfaces inherited from interface org.spongepowered.api.data.DataHolder

DataHolder.Immutable<I extends DataHolder.Immutable<I>>, DataHolder.Mutable

Nested classes/interfaces inherited from interface org.spongepowered.api.data.DirectionRelativeDataHolder

DirectionRelativeDataHolder.Immutable<I extends DirectionRelativeDataHolder.Immutable<I>>, DirectionRelativeDataHolder.Mutable

Nested classes/interfaces inherited from interface org.spongepowered.api.data.SerializableDataHolder

SerializableDataHolder.Immutable<I extends SerializableDataHolder.Immutable<I>>, SerializableDataHolder.Mutable

Method Summary

Modifier and Type	Method	Description
java.lang.String	asString()	Gets a string representation of this block state, including the block type and the properties.
static BlockState.Builder	builder()	Creates a new BlockState.Builder for building BlockStates.
FluidState	fluidState()	Gets the associated FluidState for this block state.
static BlockState	fromString(java.lang.String id)
static StateMatcher.Builder<BlockState,BlockType>	matcher(java.util.function.Supplier<? extends BlockType> type)	Constructs a new builder to construct a StateMatcher.
static StateMatcher.Builder<BlockState,BlockType>	matcher(BlockType type)	Constructs a new builder to construct a StateMatcher.
default BlockState	mirror(java.util.function.Supplier<? extends Mirror> mirror)	Gets the appropriate BlockState for the desired Mirror.
BlockState	mirror(Mirror mirror)	Gets the appropriate BlockState for the desired Mirror.
default BlockState	rotate(java.util.function.Supplier<? extends Rotation> rotation)	Gets the appropriate BlockState for the desired Rotation.
BlockState	rotate(Rotation rotation)	Gets the appropriate BlockState for the desired Rotation.
BlockSnapshot	snapshotFor(ServerLocation location)	Creates a new BlockSnapshot with this current BlockState at the desired ServerLocation.
BlockType	type()	Gets the base type of block.

Methods inherited from interface org.spongepowered.api.data.DataHolder.Immutable

mergeWith, mergeWith, transform, transform, with, with, with, without, without, without

Methods inherited from interface org.spongepowered.api.data.persistence.DataSerializable

contentVersion, toContainer

Methods inherited from interface org.spongepowered.api.data.DirectionRelativeDataHolder

get, getDouble, getInt, getLong

Methods inherited from interface org.spongepowered.api.data.SerializableDataHolder

validateRawData

Methods inherited from interface org.spongepowered.api.data.SerializableDataHolder.Immutable

copy, withRawData

Methods inherited from interface org.spongepowered.api.state.State

cycleStateProperty, cycleStateProperty, cycleValue, cycleValue, findStateProperty, stateProperties, stateProperty, stateProperty, statePropertyMap, statePropertyValues, toString, withStateProperty, withStateProperty

Methods inherited from interface org.spongepowered.api.data.value.ValueContainer

get, getDouble, getInt, getKeys, getLong, getOrElse, getOrNull, getValue, getValues, require, requireValue, supports, supports

Method Detail

builder

static BlockState.Builder builder()

Creates a new BlockState.Builder for building BlockStates.

Returns:

The builder

fromString

static BlockState fromString(java.lang.String id)

matcher

static StateMatcher.Builder<BlockState,BlockType> matcher(java.util.function.Supplier<? extends BlockType> type)

Constructs a new builder to construct a StateMatcher.

Parameters:

type - The block type

Returns:

The builder

matcher

static StateMatcher.Builder<BlockState,BlockType> matcher(BlockType type)

Constructs a new builder to construct a StateMatcher.

Parameters:

type - The block type

Returns:

The builder

type

BlockType type()

Gets the base type of block.

The type does not include block data such as the contents of inventories.

Returns:

The type of block

fluidState

FluidState fluidState()

Gets the associated FluidState for this block state. Depending on whether this block state is considered "waterlogged" or not, and with which fluid.

Returns:

The fluid state

snapshotFor

BlockSnapshot snapshotFor(ServerLocation location)

Creates a new BlockSnapshot with this current BlockState at the desired ServerLocation. If the ServerLocation has the same BlockState, and the BlockType can house a BlockEntity, the data from the block entity may be included in the returned BlockSnapshot.

Parameters:

location - The location for the snapshot

Returns:

The newly created snapshot

rotate

BlockState rotate(Rotation rotation)

Gets the appropriate BlockState for the desired Rotation. It may return the same state, but some states may have extra logic associated with rotating on its axis, much like mirroring.

Parameters:

rotation - The rotation

Returns:

The rotated state if not this state

rotate

default BlockState rotate(java.util.function.Supplier<? extends Rotation> rotation)

Gets the appropriate BlockState for the desired Rotation. It may return the same state, but some states may have extra logic associated with rotating on its axis, much like mirroring.

Parameters:

rotation - The rotation

Returns:

The rotated state if not this state

mirror

BlockState mirror(Mirror mirror)

Gets the appropriate BlockState for the desired Mirror. It may return the same state, but some states may have extra logic associated with mirroring on its axis, much like rotation.

Parameters:

mirror - The mirror

Returns:

The mirrored state if not this state

mirror

default BlockState mirror(java.util.function.Supplier<? extends Mirror> mirror)

Gets the appropriate BlockState for the desired Mirror. It may return the same state, but some states may have extra logic associated with mirroring on its axis, much like rotation.

Parameters:

mirror - The mirror

Returns:

The mirrored state if not this state

asString

java.lang.String asString()

Gets a string representation of this block state, including the block type and the properties. Do not confuse with State.toString() which is implementation specific.

Returns:

A string representation of this block state.