Piston API

### A small mod that lets mods and modpacks handle piston interactions!

API Features:

Give custom blocks advanced piston interactions

Piston API gives blocks a way to have position & world sensitive interactions with pistons! Mainly the block's pushability, and its stickiness.

[`IPushableBehavior`](https://github.com/jbredwards/Piston-API-Mod/blob/1. 12. 2/src/main/java/git/jbredwards/piston_api/api/block/IPushableBehavior.java): This interface adds one method `getPushReaction` (which takes in the block source & piston info, and returns the `EnumPushReaction`). Blocks should implement this if they have advanced push reaction logic. This interface overrides vanilla's `getPushReaction(IBlockState)` method, blocks that don't implement the interface fallback on vanilla's method. For modpack devs: Each block's push reaction can be overriden by calling [`PushReactionHanlder.overridePushReaction`](https://github.com/jbredwards/Piston-API-Mod/blob/1. 12. 2/src/main/java/git/jbredwards/piston_api/mod/asm/PushReactionHandler.java) through (https://www.curseforge.com/minecraft/mc-mods/groovyscript) during postInit (mod devs should not do this!) Grovvyscript examples: ```groovy import static git.jbredwards.piston_api.mod.asm. PushReactionHandler.overridePushReaction import net.minecraft.block.material. EnumPushReaction

//makes dirt be destroyed by pistons when pushed (like grass or leaves) overridePushReaction(block('minecraft:dirt'), EnumPushReaction. DESTROY)

//makes orange wool not pushable by pistons, while leaving the rest pushable def orangeWool = blockstate('minecraft:wool', 1) overridePushReaction(block('minecraft:wool'), {source, pistonInfo -> orangeWool == source.getBlockState() ? EnumPushReaction. BLOCK : EnumPushReaction. NORMAL}) ```

[`IStickyBehavior`](https://github.com/jbredwards/Piston-API-Mod/blob/1. 12. 2/src/main/java/git/jbredwards/piston_api/api/block/IStickyBehavior.java): This interface adds two methods: `getStickReaction` (which takes in the block source, the neighbor block to test, and piston info, and returns the [`EnumStickReaction`](https://github.com/jbredwards/Piston-API-Mod/blob/1. 12. 2/src/main/java/git/jbredwards/piston_api/api/piston/EnumStickReaction.java)), and `hasStickySide` (which takes in the block source & piston info, and returns whether the block has any potentially sticky sides). Blocks should implement this if they have advanced stickiness logic. This interface overrides forge's `isStickyBlock(IBlockState)` method, blocks that don't implement the interface fallback on forge's method. For modpack devs: Each block's stick result can be overriden by calling [`StickReactionHanlder.overrideStickReaction`](https://github.com/jbredwards/Piston-API-Mod/blob/1. 12. 2/src/main/java/git/jbredwards/piston_api/mod/asm/StickReactionHandler.java) through (https://www.curseforge.com/minecraft/mc-mods/groovyscript) during postInit (mod devs should not do this!) Groovyscript examples: ```groovy

import static git.jbredwards.piston_api.mod.asm. StickReactionHandler.overrideStickReaction import git.jbredwards.piston_api.api.piston. EnumStickReaction

//makes slime blocks not sticky overrideStickReaction(block('minecraft:slime'), EnumStickReaction. PASS)

//makes crafting tables sticky overrideStickReaction(block('minecraft:crafting_table'), EnumStickReaction. STICK)

//makes bookshelves never stick to anything overrideStickReaction(block('minecraft:bookshelf'), EnumStickReaction. NEVER)

//makes stained glass sticky, but only to the same color overrideStickReaction(block('minecraft:stained_glass'), {source, other, pistonInfo -> source.getBlockState() == other.getBlockState() ? EnumStickReaction. STICK : EnumStickReaction. PASS})

//a more complicated example, makes the open part of logs sticky import static git.jbredwards.piston_api.api.block. IStickyBehavior.getConnectingSide import net.minecraft.block. BlockLog overrideStickReaction(, {source, other, pistonInfo -> def connectingAxis = BlockLog. EnumAxis.fromFacingAxis(getConnectingSide(source, other).getAxis()) def logAxis = source.getBlockState().getValue(BlockLog. LOG_AXIS)

connectingAxis == logAxis ? EnumStickReaction. STICK : EnumStickReaction. PASS }) ```

Main Features: - Configurable piston push limit - Pistons move tile entities - Pistons don't destroy fluid states (while (https://modrinth.com/mod/fluidlogged-api) is installed) - (https://modrinth.com/mod/quark) mod compatibility

Small Features: - Override existing piston interactions - Chests stick each other when pushed - Play block breaking sounds and particles when blocks are destroyed by pistons

##### This mod will not be ported