CC: Relative Routing

CC: Relative Routing adds two ComputerCraft peripherals that lets you interact with the world using relative coordinates instead of peripheral IDs, making your programs portable and replicable.

---

Blocks

Redstone Router

Send wireless redstone signals to relative coordinates and block faces.

Connect a CC computer to the Redstone Router, then use the redstone_router peripheral:

local router = peripheral.find("redstone_router")

-- Power the north face of the block 3 east, 0 up, 2 north of the router
router.setRedstone(3, 0, -2, "north", 15)

-- Read back the stored value
print(router.getRedstone(3, 0, -2, "north"))  -- 15

-- Remove all active signals
router.clearAll()

API

Method	Description
setRedstone(x, y, z, side, power)	Sets a redstone signal (power 0–15) on the given face of the target block. Power 0 removes the signal.
getRedstone(x, y, z, side)	Returns the currently stored power for that offset + face.
clearAll()	Removes all active signals from this router.

side is one of: north south east west up down

---

Peripheral Router

Wrap any CC-compatible peripheral nearby using relative coordinates instead of a peripheral name or side. The peripheral can be used as if it was connected to the computer.

local router = peripheral.find("peripheral_router")

-- Wrap a monitor at offset (3, 0, 0)
local mon = router.wrap(3, 0, 0)
mon.setTextScale(1)
mon.clear()
mon.setCursorPos(1, 1)
mon.write("Hello from relative routing!")

-- Check what's at an offset before wrapping
if router.isPresent(0, 2, 0) then
    print(router.getType(0, 2, 0))        -- e.g. "monitor"
    print(router.getMethods(0, 2, 0))     -- list all methods
end

-- Call a single method without wrapping
router.call(3, 0, 0, "write", "Hello")

API

Method	Description
wrap(x, y, z)	Returns a proxy object with all the target peripheral's methods. Prefer this for interacting with peripherals.
isPresent(x, y, z)	Returns true if a peripheral exists at the offset.
getType(x, y, z)	Returns the peripheral type string, or nil if none.
getMethods(x, y, z)	Returns a table of all method names on the peripheral.
call(x, y, z, method, ...)	Calls a single named method. Note: may return nil for value-returning methods — use wrap() when you need return values.

Coordinates are relative to the Peripheral Router block itself. Works with any CC:Tweaked peripheral: monitors, speakers, disk drives, modems, and peripherals added by other mods.

---

Target Wand

The Target Wand is a helper item that prints the correct relative coordinates for any block relative to a router, so you never have to count blocks manually.

Usage:

1. Right-click a Redstone Router or Peripheral Router to select it as the controller.
2. Right-click any other block to print the relative coordinates and a ready-to-use Lua snippet in chat.

For Peripheral Router targets, it also detects what peripheral (if any) is at that position.

---

Configuration

The config file is at config/ccrelativerouting-common.toml.

Option	Default	Description
maxRange	128	Maximum distance for Redstone Router offsets
peripheralMaxRange	128	Maximum distance for Peripheral Router offsets