Initial Release

Minecraft datapack: Rename a carrot on a stick to "Wrench" and right click on blocks to rotate them.

WrenchModes.md

@@ -0,0 +1,62 @@
+# Wrench modes
+
+The Wrench's mode can be changed by right clicking while the Wrench is held in the player's off hand.
+Various modes can make this wrench easier/quicker to use.
+
+Rotatable blocks are divided into 5 categories:
+* *Terracotta*: All 16 colors of glazed terracotta
+* *Rails*: All 4 types of rails
+* *Redstone*: dispensers, droppers, pistons, sticky pistons, observers, hoppers, repeaters, and comparators
+* *Pillars*: All logs, stripped logs, bark, stripped bark, quartz pillars, purpur pillars, hay bales, and bone blocks
+* *Slabs*: All Slabs including waterlogged
+* *Stairs*: All Stairs including waterlogged
+* *Rods*: End rods
+
+## Default
+* Works on all rotatable blocks
+  * End rods can only be flipped.
+* Cycles through all rotations.
+
+## Flip
+* Works on *Redstone*, *Rods*, *Slabs* and *Stairs*.
+* Flips the block to the opposite rotation.
+* Moves slabs between the top and bottom slab position.
+
+## Face player
+* Works on *Rails*, *Redstone*, *Pillars* and *Stairs*.
+* Rotates the block based on player's rotation.
+  * similar to default placement of most *Redstone*.
+  * e.g. if player is facing "east" a piston will face "west".
+* Stairs will change to top/bottom stairs when clicking on the top/bottom half.
+* If block already facing the player, Wrench will flip it instead if possible.
+
+## Face click
+* Works on *Rails*, *Redstone*, *Pillars* and *Stairs*.
+* Rotates the block to face the side of the block aimed at.
+  * similar to default placement of *Pillars*.
+  * e.g. if player clicks the top surface of a piston, the piston will face "up".
+* Wrench will also flip the block if it's already facing the side the player clicked, if possible.
+* Stairs will change to top/bottom stairs when clicking on the top/bottom half of the block.
+* Due to a quirk, clicking on the edges where faces of a block meet (see image) can rotate the block to face one of its sides.  
+  ![](https://i.imgur.com/3NYmwIe.png)
+* Special cases:
+  * In general, if "Face click" cannot be used, the Wrench will default to "Face Player".
+  * Hoppers will only use "Face player" if the top full-width section is clicked. Otherwise it will default to "Face Player" mode.
+  * Repeaters and comparators will default to "Face Player" mode if the top side is clicked.
+  * *Rails* behave the same as if in "Face Player" mode.
+
+## Terracotta mode
+* Only works on *Terracotta*.
+* Aids creation of 2x2 glazed terracotta patterns by making each subsequent rotation based on the previous one.
+  * Upon switching to this mode, the Wrench is set to "North" by default.
+  * Clicking on a terracotta block will rotate it to face north, and then the Wrench will set its mode to "East".
+  * Clicking the next terracotta block will rotate it to face east, and the Wrench will set its mode to "South".
+  * The cycle repeats in this pattern: North, East, South, West, North... etc.
+
+## Additional notes
+* If the current Wrench mode does not work with the aimed block, it will fall back onto Default mode.
+* There is no defined order for conflicting operations.
+  * e.g. clicking edges of a block with "Face Click".
+  * The Wrench will go with whatever rotation succeeds first.
+
+Version 1.0