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 reproducible.

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 redstone
print(router.getRedstone(3, 0, -2, "north"))  -- 15

-- Remove all active signals
router.clearAll()

API

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

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.