CluckNet

CluckNet v0.1.0 — First release

An implementation of RFC 1149 "A Standard for the Transmission of IP Datagrams on Avian Carriers" for Minecraft. Packets are physically carried between blocks by chickens. Packet loss, latency and routing follies are reproduced by the chickens themselves.

What's in this release

• Packet Sender and Packet Receiver blocks (sneak-click pairing, GUI, crafting recipes)
• Packet Chicken entity with biased random-walk AI
• 16-byte MTU chunking + XOR parity recovery for single-chunk loss
• NACK return chickens + automatic retransmission of missing chunks
• Drop-on-death: lost chunks materialise as labelled paper items
• /clucknet send | link | fire | message | stats commands
• TCP-style eager delivery semantics

Requirements

• Minecraft 1.20.6
• Minecraft Forge 50.1.x
• Java 21

Install

Drop clucknet-0.1.0.jar into your mods/ folder.

Known limitations

• Parity chunk count fixed at 1 per message (configurable in a future release)
• HUD overlay deferred — /clucknet stats exposes the same counters via chat (Forge 1.20.6 LayeredDraw migration is missing the registration hook)
• 1.20.6 / Forge only — port PRs welcome (see README)

See the README for the full walkthrough and protocol notes.