ColonyLink

# ColonyLink v1.0.2 — Redirector Setup Rework

## Requirements
- Minecraft 1.21.1
- NeoForge 21.1.228
- MineColonies 1.1.1299+
- Applied Energistics 2 19.2.17+
- Domum Ornamentum 1.0.233+ *(optional)*
---

## What's New

### Redirector Setup — Complete Rework

The setup flow has been redesigned to be clearer and more reliable.

**New setup order:**
1. Insert the **Colony Link Wand** into a **Wireless Access Point** to link it to AE2
2. **Sneak + Right-click** a **Builder's Hut** with the wand → confirmation message
3. Place the **Colony Link Redirector** adjacent to an AE2 cable
4. **Sneak + Right-click** the **Redirector** with the wand → auto-links to the builder
5. **Right-click (air)** with the wand → opens the resource GUI
The redirector now automatically sets its target inventory to the Builder's Hut position at the moment of linking — no more manual sneak+click on the inventory face.

### AE2 Network Integration — Fixed

- The Redirector now correctly consumes **1 AE2 channel** (`REQUIRE_CHANNEL`)
- AE2 cables visually **attach to the Redirector** on all 6 faces
- Cable connected textures persist after **replacing a cable** or **reconnecting to the server**
- The fix required registering the `IN_WORLD_GRID_NODE_HOST` capability — previously the Redirector was invisible to the AE2 network despite implementing the interface
### UI Improvements

- **Wand GUI** — Redirector status now shows `Linked` / `Not Linked` / `Standby` instead of the internal `NO_CONTROLLER` state (which appeared incorrectly during network boot)
- **Redirector GUI** — Removed the `AE2: Unlinked` indicator; channel visibility on the cable is sufficient confirmation
- **Wand tooltip** — Updated to reflect the new setup order
- **Redirector item tooltip** — Updated with the correct 5-step setup guide
### Error Messages — Improved

| Situation | Message |
|---|---|
| Send without redirector linked to wand | `§c No Redirector linked to this wand!` |
| Redirector not connected to AE2 | `§c Redirector is not connected to the AE2 network!` |
| Craft fails (missing raw materials) | `§c Missing primary ingredients: [item]` *(was: "Craft failed")* |
| Sneak+click on non-builder block (wand linked) | *(silent — no spam)* |
| Sneak+click on any block (wand not linked to AE2) | `§c This is not a builder block!` |

---

## Bug Fixes

- Fixed cables not attaching to the Redirector after placement or reconnection
- Fixed `NO_CONTROLLER` displaying incorrectly in the wand GUI during AE2 network boot
- Fixed Send All failing silently when no Redirector was linked to the wand
- Fixed Redirector accepting sneak+click on adjacent inventories (removed — inventory is now set automatically at wand link time)
---

## What's Unchanged

All v1.0.1 features remain fully functional:
- Resource list with colored status buttons (Available, Craftable, No Pattern, Crafting, Missing)
- Craft / Craft All / Send / Send All
- Domum Ornamentum support (virtual craft + blockstate preservation)
- Priority Request panel (builder PNJ active request)
- Restart builder button
- 120-slot redirector buffer GUI
- Clear NBT recipes for wand and redirector
- Server tick at 40 ticks (2 seconds)
---

## Roadmap

| Version | Feature |
|---|---|
| **v1.1.0** | Multi-builder support — wand linked to multiple Builder's Huts, tabbed GUI |
| **v2.0.0** | RF energy system — wand consumes RF passively; per-craft RF cost charged to the Redirector via ME network |