Better Pistons

BetterPistons is a mechanic that allows many more things to be done with pistons.

There are currently 4 piston mechanics:

  • Crush
  • Bounce
  • SuperSticky
  • SuperPush

A blacklist can be configured in the configuration to prevent certain blocks from interacting with each piston mechanic.

Crush

The crush mechanism breaks blocks that the piston head is pushed into.

It requires a sign attached to the piston, with the second line being [Crush]. Upon being powered, the block into which the piston extends is the block that will be destroyed.

Bounce

The bounce mechanism propels blocks and entities.

It requires a sign attached to the piston, with the second line being [Bounce], and the third being the velocity of the bounce. The maximum bounce velocity is 10 (this is a Minecraft limitation). The block that the piston extends over is the one from which any entities or blocks that are directly above it will be propelled.

SuperSticky

The SuperSticky mechanism allows blocks to be pulled that are farther than 1 block away.

It requires a sign attached to the piston, with the second line being [SuperSticky], and the third being the number of blocks to pull. The maximum amount is 10.

The third line can also allow it to pull back a distance farther than 1 in a single pulse. To do so, enter it in this format: maxdistance-pullperpulse. For example, 10-2 would pull blocks up to 10 blocks away at a rate of 2 blocks per pulse.

If AIR is on the last line, it gains the ability to pull AIR as if it were a solid block.

SuperPush

The SuperPush mechanism also allows air to be pushed by pistons.

It requires a sign attached to the piston, with the second line being [SuperPush], and the third being the amount of blocks to push. The maximum amount is 10.

The third line can also allow it to push forward a distance farther than 1 in a single pulse. To do so, enter it in this format: maxdistance-pushperpulse. For example, 10-2 would push blocks up to 10 blocks away at a rate of 2 blocks per pulse.

Permissions

Permission Node Effect
craftbook.mech.pistons.bounce Allows creation of the ‘Bounce’ BetterPiston.
craftbook.mech.pistons.crush Allows creation of the ‘Crush’ BetterPiston.
craftbook.mech.pistons.supersticky Allows creation of the ‘SuperSticky’ BetterPiston.
craftbook.mech.pistons.superpush Allows creation of the ‘SuperPush’ BetterPiston.

Configuration

Node Comment Default
mechanics.BetterPistons.crushers Enables BetterPistons Crusher Mechanic. true
mechanics.BetterPistons.crushers-kill-mobs Causes crushers to kill mobs as well as break blocks. This includes players. false
mechanics.BetterPistons.crusher-blacklist A list of blocks that the Crusher piston can not break. [minecraft:obsidian, minecraft:bedrock, minecraft:nether_portal, minecraft:end_portal, minecraft:end_portal_frame, minecraft:end_gateway]
mechanics.BetterPistons.super-sticky Enables BetterPistons SuperSticky Mechanic. true
mechanics.BetterPistons.super-push Enables BetterPistons SuperPush Mechanic. true
mechanics.BetterPistons.movement-blacklist A list of blocks that the movement related BetterPistons can not interact with. [minecraft:obsidian, minecraft:bedrock, minecraft:nether_portal, minecraft:end_portal, minecraft:end_portal_frame, minecraft:end_gateway]
mechanics.BetterPistons.bounce Enables BetterPistons Bounce Mechanic. true
mechanics.BetterPistons.bounce-blacklist A list of blocks that the Bounce piston can not bounce. [minecraft:obsidian, minecraft:bedrock, minecraft:nether_portal, minecraft:end_portal, minecraft:end_portal_frame, minecraft:end_gateway]
mechanics.BetterPistons.max-distance The maximum distance a BetterPiston can interact with blocks from. 12
mechanics.BetterPistons.bounce-max-velocity The maximum velocity bounce pistons can provide. 5.0