Package alexiil.mc.lib.multipart.api

Class AbstractPart

java.lang.Object

alexiil.mc.lib.multipart.api.AbstractPart

public abstract class AbstractPart
extends Object

The base class for every part in a multipart block.

Generally implementations will want to override (in addition to the abstract methods):

• getPickStack() (and optionally addDrops(DefaultedList)}

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static interface	AbstractPart.ItemDropTarget	A target for retrieving item drops from addDrops(ItemDropTarget, LootContext).

Field Summary

Fields

Modifier and Type	Field	Description
PartDefinition	definition
MultipartHolder	holder
static ParentNetIdSingle<AbstractPart>	NET_ID
static NetIdDataK<AbstractPart>	NET_RENDER_DATA
static NetIdSignalK<AbstractPart>	NET_SPAWN_BREAK_PARTICLES

Constructor Summary

Constructors

Constructor	Description
AbstractPart(PartDefinition definition, MultipartHolder holder)

Method Summary

Modifier and Type	Method	Description
void	addAllAttributes(AttributeList<?> list)	Offers every contained attribute to the given attribute list.
void	addDrops(AbstractPart.ItemDropTarget target, LootContext context)
void	addDrops(DefaultedList<ItemStack> to)	Deprecated. Replaced by addDrops(ItemDropTarget, LootContext)
protected void	addRequiredPart(AbstractPart required)
void	afterBreak(PlayerEntity player)	Called instead of Block.afterBreak(World, PlayerEntity, BlockPos, BlockState, BlockEntity, ItemStack), except that this shouldn't drop any items, as that's handled separately.
static float	calcBreakingDelta(PlayerEntity player, BlockState state, float hardness)	Calculates calculateBreakingDelta(PlayerEntity) as if this part was the given block state instead, but using a custom hardness value.
float	calculateBreakingDelta(PlayerEntity player)	Part version of AbstractBlock.calcBlockBreakingDelta(BlockState, PlayerEntity, BlockView, BlockPos).
float	calculateBreakingDelta(PlayerEntity player, Block block)	Calculates calculateBreakingDelta(PlayerEntity) as if this part was the given block instead.
float	calculateBreakingDelta(PlayerEntity player, BlockState state)	Calculates calculateBreakingDelta(PlayerEntity) as if this part was the given block state instead.
boolean	canOverlapWith(AbstractPart other)	Checks to see if this AbstractPart can overlap with the other part.
protected BlockState	getClosestBlockState()
VoxelShape	getCollisionShape()
VoxelShape	getCullingShape()
VoxelShape	getDynamicShape(float partialTicks)
abstract PartModelKey	getModelKey()	Called on the client for both rendering, and checking if this needs to re-render in MultipartContainer.redrawIfChanged().
VoxelShape	getOutlineShape()
ItemStack	getPickStack()	Called whenever this part is picked by the player (similar to Block.getPickStack(BlockView, BlockPos, BlockState))
abstract VoxelShape	getShape()
boolean	isBlocking(Direction searchDirection)
void	mirror(BlockMirror mirror)	Called whenever BlockEntity.applyMirror(BlockMirror) is called on the containing block.
void	onAdded(MultipartEventBus bus)	Called whenever this part was added to the MultipartContainer, either in BlockEntity.cancelRemoval() or when it is manually added by an item.
boolean	onBreak(PlayerEntity player)	Called instead of Block.onBreak(World, BlockPos, BlockState, PlayerEntity), to play the broken sound, and spawn break particles.
void	onPlacedBy(PlayerEntity player, Hand hand)	Open method, that's designed to be called from the Item that places this part into the world.
void	onRemoved()
ActionResult	onUse(PlayerEntity player, Hand hand, BlockHitResult hit)	Called whenever this part is used via AbstractBlock.onUse(BlockState, World, BlockPos, PlayerEntity, Hand, BlockHitResult).
protected void	playBreakSound()	Called by default in onBreak(PlayerEntity) to play the breaking sound.
protected void	playBreakSound(BlockState blockState)
protected void	playHitSound(BlockState blockState)
void	playHitSound(PlayerEntity player)	Called instead of Block.onBreak(World, BlockPos, BlockState, PlayerEntity), to play the broken sound, and spawn break particles.
protected static double	pos(World world, Direction side, Direction.Axis axis, double size)
void	readRenderData(NetByteBuf buffer, IMsgReadCtx ctx)
protected void	removeRequiredPart(AbstractPart required)
void	rotate(BlockRotation rotation)	Called whenever BlockEntity.applyRotation(BlockRotation) is called on the containing block.
<T> void	sendNetworkUpdate(T obj, NetIdDataK<T> netId, NetIdDataK.IMsgDataWriterK<T> writer)	Sends the given NetIdDataK to every player currently watching this multipart, with a custom NetIdDataK.IMsgDataWriterK.
<T> void	sendNetworkUpdate(T obj, NetIdTyped<T> netId)	Sends the given NetIdDataK or NetIdSignalK to every player currently watching this multipart.
<T> void	sendNetworkUpdateExcept(PlayerEntity except, T obj, NetIdDataK<T> netId, NetIdDataK.IMsgDataWriterK<T> writer)	Sends the given NetIdDataK to every player currently watching this multipart, with a custom NetIdDataK.IMsgDataWriterK, except for the given player.
<T> void	sendNetworkUpdateExcept(PlayerEntity except, T obj, NetIdTyped<T> netId)	Sends the given NetIdDataK or NetIdSignalK to every player currently watching this multipart, except for the given player.
boolean	spawnBreakingParticles(Direction side)	Deprecated. This was renamed to spawnHitParticle(Direction)
protected void	spawnBreakParticles()	Called on the client to spawn break particles.
protected void	spawnBreakParticles(BlockState state)
protected void	spawnBreakParticles(BlockState state, Sprite sprite)
protected void	spawnBreakParticles(BlockState state, Identifier spriteId)
boolean	spawnHitParticle(Direction side)	Spawns a single partial-break (hit) particle.
protected void	spawnHitParticle(Direction side, BlockState state)
protected void	spawnHitParticle(Direction side, BlockState state, Sprite sprite)
protected void	spawnHitParticle(Direction side, BlockState state, Identifier spriteId)
protected void	spawnHitParticle(Direction side, Box box, BlockState state, Sprite sprite)
CompoundTag	toTag()
void	writeCreationData(NetByteBuf buffer, IMsgWriteCtx ctx)	Writes the payload that will be passed into PartDefinition.loadFromBuffer(MultipartHolder, NetByteBuf, IMsgReadCtx) on the client.
void	writeRenderData(NetByteBuf buffer, IMsgWriteCtx ctx)

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Details

NET_ID

public static final ParentNetIdSingle<AbstractPart> NET_ID

NET_RENDER_DATA

public static final NetIdDataK<AbstractPart> NET_RENDER_DATA

NET_SPAWN_BREAK_PARTICLES

public static final NetIdSignalK<AbstractPart> NET_SPAWN_BREAK_PARTICLES

definition

public final PartDefinition definition

holder

public final MultipartHolder holder

Constructor Details

AbstractPart

public AbstractPart(PartDefinition definition, MultipartHolder holder)

Method Details

toTag

public CompoundTag toTag()

writeCreationData

public void writeCreationData(NetByteBuf buffer, IMsgWriteCtx ctx)

Writes the payload that will be passed into PartDefinition.loadFromBuffer(MultipartHolder, NetByteBuf, IMsgReadCtx) on the client. (This is called on the server and sent to the client). Note that this will be called *instead* of write and read payload.

writeRenderData

public void writeRenderData(NetByteBuf buffer, IMsgWriteCtx ctx)

readRenderData

public void readRenderData(NetByteBuf buffer, IMsgReadCtx ctx) throws InvalidInputDataException

Throws:

InvalidInputDataException

sendNetworkUpdate

public final <T> void sendNetworkUpdate(T obj, NetIdTyped<T> netId)

Sends the given NetIdDataK or NetIdSignalK to every player currently watching this multipart.

sendNetworkUpdate

public final <T> void sendNetworkUpdate(T obj, NetIdDataK<T> netId, NetIdDataK.IMsgDataWriterK<T> writer)

Sends the given NetIdDataK to every player currently watching this multipart, with a custom NetIdDataK.IMsgDataWriterK.

sendNetworkUpdateExcept

public final <T> void sendNetworkUpdateExcept(@Nullable PlayerEntity except, T obj, NetIdTyped<T> netId)

Sends the given NetIdDataK or NetIdSignalK to every player currently watching this multipart, except for the given player.

sendNetworkUpdateExcept

public final <T> void sendNetworkUpdateExcept(@Nullable PlayerEntity except, T obj, NetIdDataK<T> netId, NetIdDataK.IMsgDataWriterK<T> writer)

Sends the given NetIdDataK to every player currently watching this multipart, with a custom NetIdDataK.IMsgDataWriterK, except for the given player.

onAdded

public void onAdded(MultipartEventBus bus)

Called whenever this part was added to the MultipartContainer, either in BlockEntity.cancelRemoval() or when it is manually added by an item.

Register event handlers (as methods) with MultipartEventBus.addListener(Object, Class, EventListener).

Parameters:

bus - The event bus to register with. This is shorthand for holder.getContainer().getEventBus()

onRemoved

public void onRemoved()

onPlacedBy

public void onPlacedBy(PlayerEntity player, Hand hand)

Open method, that's designed to be called from the Item that places this part into the world.

(Nothing calls this by default, as all parts are placed from a custom item).

onBreak

public boolean onBreak(PlayerEntity player)

Called instead of Block.onBreak(World, BlockPos, BlockState, PlayerEntity), to play the broken sound, and spawn break particles.

Returns:

True if this should prevent Block.onBreak(World, BlockPos, BlockState, PlayerEntity) from being called afterwards, false otherwise.

getClosestBlockState

protected BlockState getClosestBlockState()

Returns:

The BlockState to use for playBreakSound(), playHitSound(PlayerEntity), spawnBreakParticles(), spawnHitParticle(Direction), and calculateBreakingDelta(PlayerEntity).

playHitSound

@Environment(CLIENT) public void playHitSound(PlayerEntity player)

Called instead of Block.onBreak(World, BlockPos, BlockState, PlayerEntity), to play the broken sound, and spawn break particles.

playBreakSound

protected void playBreakSound()

Called by default in onBreak(PlayerEntity) to play the breaking sound. The default implementation calls playBreakSound(BlockState) with getClosestBlockState().

playBreakSound

protected final void playBreakSound(BlockState blockState)

playHitSound

@Environment(CLIENT) protected final void playHitSound(BlockState blockState)

spawnBreakingParticles

@Environment(CLIENT) @Deprecated public boolean spawnBreakingParticles(Direction side)

Deprecated.

This was renamed to spawnHitParticle(Direction)

Spawns a single breaking particle.

Parameters:

side - The side that was hit

Returns:

True to cancel the default breaking particle from spawning, false otherwise.

spawnHitParticle

@Environment(CLIENT) public boolean spawnHitParticle(Direction side)

Spawns a single partial-break (hit) particle.

Parameters:

side - The side that was hit

Returns:

True to cancel the default breaking particle from spawning, false otherwise.

spawnHitParticle

@Environment(CLIENT) protected final void spawnHitParticle(Direction side, BlockState state)

spawnHitParticle

@Environment(CLIENT) protected final void spawnHitParticle(Direction side, BlockState state, @Nullable Identifier spriteId)

spawnHitParticle

@Environment(CLIENT) protected final void spawnHitParticle(Direction side, BlockState state, @Nullable Sprite sprite)

spawnHitParticle

@Environment(CLIENT) protected final void spawnHitParticle(Direction side, Box box, BlockState state, @Nullable Sprite sprite)

pos

protected static final double pos(World world, Direction side, Direction.Axis axis, double size)

spawnBreakParticles

@Environment(CLIENT) protected void spawnBreakParticles()

Called on the client to spawn break particles. This calls spawnBreakParticles(BlockState) with getClosestBlockState() by default.

spawnBreakParticles

@Environment(CLIENT) protected final void spawnBreakParticles(BlockState state)

spawnBreakParticles

@Environment(CLIENT) protected final void spawnBreakParticles(BlockState state, @Nullable Identifier spriteId)

spawnBreakParticles

@Environment(CLIENT) protected final void spawnBreakParticles(BlockState state, @Nullable Sprite sprite)

addRequiredPart

protected final void addRequiredPart(AbstractPart required)

removeRequiredPart

protected final void removeRequiredPart(AbstractPart required)

getShape

public abstract VoxelShape getShape()

Returns:

The VoxelShape to use for calculating if this pluggable overlaps with another pluggable.

canOverlapWith

public boolean canOverlapWith(AbstractPart other)

Checks to see if this AbstractPart can overlap with the other part. Note that this is only called if the getShape() of this part intersects with the getShape() of the other part. However this is never called if the shape of one of the parts is completely contained by the shape of the other part.

This is called once for each part currently contained in a MultipartContainer in MultipartContainer.offerNewPart(MultipartCreator, boolean).

getCollisionShape

public VoxelShape getCollisionShape()

Returns:

The shape to use when solidity logic, collisions with entities, ray tracing, etc. This should always encompass getShape().

getCullingShape

public VoxelShape getCullingShape()

Returns:

The shape to use when calculating lighting and checking for opacity. This may be empty, although it should always be contained by getCollisionShape(). Generally anything that's not opaque should override this and return VoxelShapes.empty().

getOutlineShape

public VoxelShape getOutlineShape()

Returns:

The shape for rendering bounding boxes and ray tracing.

getDynamicShape

public VoxelShape getDynamicShape(float partialTicks)

Returns:

The (potentially dynamic) shape for rendering bounding boxes and ray tracing. Unlike getOutlineShape() this is only called when rendering the box for this specific part.

isBlocking

public boolean isBlocking(Direction searchDirection)

Returns:

True if this pluggable should be an obstacle for attributes with it's getShape() when searching in this particular direction.

addAllAttributes

public void addAllAttributes(AttributeList<?> list)

Offers every contained attribute to the given attribute list. NOTE: This must always use AttributeList.offer(Object, VoxelShape) with getShape() as the VoxelShape argument!

The default implementation will AttributeList.obstruct(VoxelShape) the getShape() if isBlocking(Direction) returns true, and the search direction is not null.

getPickStack

public ItemStack getPickStack()

Called whenever this part is picked by the player (similar to Block.getPickStack(BlockView, BlockPos, BlockState))

Returns:

The stack that should be picked, or ItemStack.EMPTY if no stack can be picked from this part.

addDrops

public void addDrops(AbstractPart.ItemDropTarget target, LootContext context)

addDrops

@Deprecated public void addDrops(DefaultedList<ItemStack> to)

Deprecated.

Replaced by addDrops(ItemDropTarget, LootContext)

afterBreak

public void afterBreak(PlayerEntity player)

Called instead of Block.afterBreak(World, PlayerEntity, BlockPos, BlockState, BlockEntity, ItemStack), except that this shouldn't drop any items, as that's handled separately.

calculateBreakingDelta

public float calculateBreakingDelta(PlayerEntity player)

Part version of AbstractBlock.calcBlockBreakingDelta(BlockState, PlayerEntity, BlockView, BlockPos).

The default implementation treats parts as equal to getClosestBlockState().

calculateBreakingDelta

public final float calculateBreakingDelta(PlayerEntity player, Block block)

Calculates calculateBreakingDelta(PlayerEntity) as if this part was the given block instead.

calculateBreakingDelta

public final float calculateBreakingDelta(PlayerEntity player, BlockState state)

Calculates calculateBreakingDelta(PlayerEntity) as if this part was the given block state instead.

calcBreakingDelta

public static float calcBreakingDelta(PlayerEntity player, BlockState state, float hardness)

Calculates calculateBreakingDelta(PlayerEntity) as if this part was the given block state instead, but using a custom hardness value.

onUse

public ActionResult onUse(PlayerEntity player, Hand hand, BlockHitResult hit)

Called whenever this part is used via AbstractBlock.onUse(BlockState, World, BlockPos, PlayerEntity, Hand, BlockHitResult).

rotate

public void rotate(BlockRotation rotation)

Called whenever BlockEntity.applyRotation(BlockRotation) is called on the containing block.

Parameters:

rotation - A rotation. LMP never calls this with BlockRotation.NONE

mirror

public void mirror(BlockMirror mirror)

Called whenever BlockEntity.applyMirror(BlockMirror) is called on the containing block.

Parameters:

mirror - A mirror. LMP never calls this with BlockMirror.NONE

getModelKey

@Nullable public abstract PartModelKey getModelKey()

Called on the client for both rendering, and checking if this needs to re-render in MultipartContainer.redrawIfChanged().

This is no longer called on the server.

Returns:

The PartModelKey for the PartModelBaker to use to emit a static model. Returning null will bake nothing.