Add the player-use peripheral for CC:Tweaked #9

BlakeRain · 2023-11-27T16:13:16Z

BlakeRain commented

2023-11-27 16:13:16 +00:00

In reference to #8, this PR adds the ability to create peripherals for CC:Tweaked turtles. It also includes a peripheral that emulates a player, and adds a use() method that will attempt to use the block in-front of the turtle (up to four blocks away).

Crating the Upgrade

The upgrade can be crafted by combining four gold ingots, four redstone and an eye of ender.

The upgrade can be combined with a normal or advanced turtle in the usual way of throwing them into a crating interface to combine them. Currently the upgrade will sit in the left socket. It might be possible to use the Lua turtle API to mount the peripheral on the right.

Using the Upgrade

Once the upgrade is added to a turtle, the peripheral can be wrapped in the usual way using the peripheral API. This peripheral yields a single method, called use, which takes no arguments and performs the use operation. The method will return either nil if used incorrectly or a string representation of the InteractionResult enumeration (e.g. "CONSUME" or "SUCCESS"). I don't know what all the enumerators mean.

In reference to #8, this PR adds the ability to create peripherals for CC:Tweaked turtles. It also includes a peripheral that emulates a player, and adds a `use()` method that will attempt to use the block in-front of the turtle (up to four blocks away). # Crating the Upgrade The upgrade can be crafted by combining four gold ingots, four redstone and an eye of ender. The upgrade can be combined with a normal or advanced turtle in the usual way of throwing them into a crating interface to combine them. Currently the upgrade will sit in the left socket. It might be possible to use the Lua `turtle` API to mount the peripheral on the right. # Using the Upgrade Once the upgrade is added to a turtle, the peripheral can be wrapped in the usual way using the `peripheral` API. This peripheral yields a single method, called `use`, which takes no arguments and performs the use operation. The method will return either `nil` if used incorrectly or a string representation of the [`InteractionResult`](https://nekoyue.github.io/ForgeJavaDocs-NG/javadoc/1.19.3/net/minecraft/world/InteractionResult.html) enumeration (e.g. `"CONSUME"` or `"SUCCESS"`). I don't know what all the enumerators mean.

CleanShot_2023-11-27_at_12.57.58.png

26 KiB