tweaks724/RETSTONE.md

Remote redstone

See retstone.py for usage example

Glossary

gateways - the blocks (daylight detector) that read or emit redstone with a specified power, controlled with UDP packets
packet - a bunch of bytes sent over the internet, that do something with a specified gateway

Crafting

To craft a gateway, combine:

• nether star
• ender chest
• chorus flower
• daylight detector

Usage

Each gateway has an ID assigned. To view it, shift right-click a gateway.

To destroy a gateway, use silk touch.

How it works

A packet is int / 4 bytes / 32 bits

Packet format:

[ 01 ] [ 02 03 04 05 06 07 08 09 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 ] [ 29 30 31 32 ]
action                          bits 2-28 of repeater id                                        payload

• action: 1 to write, 0 to read
• payload: power level if writing

If writing, no response
If reading, response is the power level, or 0 if not powered or no repeater with that ID (or not loaded)

Reading powers the block down of course
BUT you should power it down (or read), wait some, and then read again

WARNING the socket is not ratelimited or protected in any way.
Though it should be hard to bruteforce, because there's no feedback

Retstone

Network translates to reto in Esperanto
So retsomething means networked something (posto - mail, retposto - email, ejo - place (site), retejo - website, etc.)
And sometimes we use network instead of internet, same is in that language
Hence retstone