Piston Pro Plus

PistonProPlus

Make Piston Great Again.

A server-side Fabric mod for Minecraft that enhances piston behavior with configurable push limits, advanced block pushing control, and NBT data preservation.

Features

• Configurable Push Limit — Break the vanilla 12-block restriction, set any limit from 1 to 4096
• Infinite Push Mode — Set the limit to a negative value to enable virtually unlimited pushing
• Type-Based Block Control — Individually toggle whether command blocks and all other blocks can be pushed
• NBT Preservation — Block entity data (e.g. command block commands) is retained through piston pushes
• Hot-Reload — Change configuration on the fly with /pistonproplus reload, no restart needed
• Full i18n — English and Chinese built-in; easy to extend

Commands

Push Limit

| Command | Permission | Description |
|—————————————-|————–|—————————————————————|
| /pistonproplus pushlimit set <limit> | OP (level 4) | Set piston push limit (1-4096). Use -1 for infinite mode. |
| /pistonproplus pushlimit get | None | Display the current push limit and mode. |

Type Limit

| Command | Permission | Description |
|——————————————————|————–|——————————————————————————-|
| /pistonproplus typelimit commandblock [true/false] | OP (level 4) | Toggle or query command block pushing. |
| /pistonproplus typelimit all [true/false] | OP (level 4) | Toggle or query all-blocks pushing (except MOVING_PISTON and command blocks). |

Omitting the boolean argument displays the current status (ON/OFF).

Utility

| Command | Permission | Description |
|————————-|————–|————————————-|
| /pistonproplus help | None | Show the help menu. |
| /pistonproplus reload | OP (level 2) | Hot-reload configuration from disk. |

Configuration

Settings are stored in config/pistonproplus.json and can be edited directly or via commands.

{
  "maxPushLimit": 12,
  "allowInfinitePush": false,
  "allowPushCommandBlock": false,
  "allowPushAllBlocks": false
}

| Key | Type | Default | Description |
|————————-|———|———|—————————————————————-|
| maxPushLimit | int | 12 | Maximum blocks a piston can push (1-4096) |
| allowInfinitePush | boolean | false | When true, push limit becomes 4096 |
| allowPushCommandBlock | boolean | false | Allow pistons to push command blocks (NBT preserved) |
| allowPushAllBlocks | boolean | false | Allow pistons to push nearly all blocks (except MOVING_PISTON) |

Warnings

• MOVING_PISTON (block 36) can never be pushed. This is a hard safety constraint.
• Command blocks may lose NBT data in edge cases; the mod preserves NBT through capture/restore, but complex setups should be tested.
• Pushing all blocks may cause unexpected behavior. Attached blocks (redstone dust, torches, etc.) on slime blocks can behave unexpectedly during large pushes.
• Very high push limits may cause server lag. Test incrementally before deploying on production servers.

License

This project is licensed under the GNU General Public License v3.0.

Links

• GitHub

This mod is not affiliated with or endorsed by Mojang Studios. Minecraft is a trademark of Mojang Studios.