tweaks724/docs/RETSTONE.md

## Remote redstone

See [retstone.py](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