Piston 5.46.0

class · pocketmine\block\Piston · source

Extends Opaque
Implements AnyFacing

Piston and sticky piston (Bedrock behaviour).

• Powered from any side except its front (no quasi-connectivity in Bedrock); redstone wire next to it powers it even when it doesn't point into it.
• Starts moving one redstone tick (2 game ticks) after its power changes, and the arm takes 2 game ticks to move. Power changes during a movement are only looked at once it ends.
• Pushes up to 12 blocks (slime and honey blocks drag the blocks stuck to them), destroys blocks which break when pushed, and a sticky piston pulls the block in front of its head back when it retracts.
• Moved blocks keep their block entity data (chests, furnaces...).

The moving blocks are moving_block blocks with a MovingBlock block entity at their destination, and the PistonArm block entity of the piston carries the animation state; see TilePistonArm and TileMovingBlock.

Constants

START_DELAY_TICKS

public const START_DELAY_TICKS = \pocketmine\world\redstone\RedstoneEngine::REDSTONE_TICK

Delay between a power change and the start of the movement.

Methods

describeBlockOnlyState() protected

protected function describeBlockOnlyState(\pocketmine\data\runtime\RuntimeDataDescriber $w) : void

finishMovement()

public function finishMovement(\pocketmine\block\tile\PistonArm $arm) : void

Puts the moved blocks in place and ends the movement.

getAffectedBlocks()

public function getAffectedBlocks() : array

getArm() protected

protected function getArm() : ?\pocketmine\block\tile\PistonArm

getPistonPushReaction()

public function getPistonPushReaction() : \pocketmine\block\utils\PistonPushReaction

isExtended()

public function isExtended() : bool

Returns whether the piston's arm is out (or moving).

isReceivingPower()

public function isReceivingPower() : bool

Returns whether the piston receives power from any side except its front.

isRedstoneConductor()

public function isRedstoneConductor() : bool

isSticky()

public function isSticky() : bool

onBreak()

public function onBreak(\pocketmine\item\Item $item, ?\pocketmine\player\Player $player = null, array &$returnedItems = []) : bool

onNearbyBlockChange()

public function onNearbyBlockChange() : void

onScheduledUpdate()

public function onScheduledUpdate() : void

place()

public function place(\pocketmine\world\BlockTransaction $tx, \pocketmine\item\Item $item, \pocketmine\block\Block $blockReplace, \pocketmine\block\Block $blockClicked, int $face, \pocketmine\math\Vector3 $clickVector, ?\pocketmine\player\Player $player = null) : bool

startMovement()

public function startMovement(\pocketmine\block\tile\PistonArm $arm, bool $extending) : bool

Starts extending or retracting the arm. Returns false if the blocks in front can't be pushed.

writeStateToWorld()

public function writeStateToWorld() : void