Automation

Piston Crusher

Make every piston work harder.

Crush whitelisted blocks with pistons, a configurable target block, and adjustable drops.

  • Spigot / Paper
  • Minecraft 1.20.4
  • Java 17+
  • MIT

What it does

Only whitelisted materials are crushed. Configure the target material and drop multiplier with live commands; other blocks in the piston line keep normal pushing behaviour.

  • Whitelist-Driven Crushing
  • Multiplier Control
  • Custom Crusher Block
  • Runtime Administration

Features

  • Whitelist-Driven Crushing

    Only materials on the plugin whitelist are eligible for crushing

  • Multiplier Control

    Set a global drop multiplier (minimum 1.0) via command

  • Custom Crusher Block

    Choose the block that acts as the crusher target in the piston line

  • Runtime Administration

    Manage whitelist, multiplier, and crusher block without restart

  • Persistent Settings

    Whitelist and crusher block are saved in plugin data files

  • Tab Completion

    Subcommands and material names are suggested automatically

Installation

  1. 1

    Check your server

    Run Spigot / Paper with Java 17 or newer, built for Minecraft 1.20.4. No other plugins are required.

  2. 2

    Add the JAR

    Stop the server, download Piston-Crusher-1.0.2.jar, and place it in plugins/. When upgrading, replace the previous JAR.

  3. 3

    Start and configure

    Start the server and check the console. Review the generated configuration with the release documentation.

First command
/pistoncrusher

Inspect the whitelist and crusher target, then build a piston line with an eligible block against that target.

Commands8

CommandDescription
/pistoncrusherShow command usage
/pistoncrusher whitelist add <material>Add a material to the crush whitelist
/pistoncrusher whitelist remove <material>Remove a material from the crush whitelist
/pistoncrusher whitelist listDisplay all currently whitelisted materials
/pistoncrusher multiplier <value>Set the drop multiplier (values below 1 are clamped to 1)
/pistoncrusher multiplierDisplay the current output multiplier
/pistoncrusher crusherblock <material>Set the designated crusher block type
/pistoncrusher crusherblockDisplay the current crusher block material

Permissions1

PermissionDescriptionDefault
pistoncrusher.adminAccess to all /pistoncrusher commandsop

Configuration2

FileKeyDefaultDescription
plugins/PistonCrusher/whitelist.ymlwhitelist[COBBLESTONE]Materials eligible for crushing
plugins/PistonCrusher/crusherblock.ymlcrusherblockWAXED_CHISELED_COPPERBlock material that acts as crusher target

Release notes

Piston Crusher v1.0.2

Piston Crusher v1.0.2 corrects packaged version metadata and standardizes the build.

Questions or an issue?

Bug reports, questions, and contributions go to this plugin’s GitHub repository.

Open an issue