redstone_relay

The redstone relay is a peripheral that allows reading and outputting redstone signals. While this is not very useful on its own (as computers have the same functionality built-in), this can be used with wired modems to interact with multiple redstone signals from the same computer.

The peripheral provides largely identical methods to a computer's built-in redstone API, allowing setting signals on all six sides of the block ("top", "bottom", "left", "right", "front" and "back").

Recipe

Redstone Relay

Usage

• Toggle the redstone signal above the computer every 0.5 seconds.

  local relay = peripheral.find("redstone_relay")
  while true do
    relay.setOutput("top", not relay.getOutput("top"))
    sleep(0.5)
  end

Changes

• New in version 1.114.0

setOutput(side, on)Source

Turn the redstone signal of a specific side on or off.

Parameters

1. side string The side to set.
2. on boolean Whether the redstone signal should be on or off. When on, a signal strength of 15 is emitted.

getOutput(side)Source

Get the current redstone output of a specific side.

Parameters

1. side string The side to get.

Returns

1. boolean Whether the redstone output is on or off.

See also

• setOutput

getInput(side)Source

Get the current redstone input of a specific side.

Parameters

1. side string The side to get.

Returns

1. boolean Whether the redstone input is on or off.

setAnalogOutput(side, value)Source

Set the redstone signal strength for a specific side.

Parameters

1. side string The side to set.
2. value number The signal strength between 0 and 15.

Throws

• If value is not between 0 and 15.

Changes

• New in version 1.51

setAnalogueOutput(side, value)Source

Set the redstone signal strength for a specific side.

Parameters

1. side string The side to set.
2. value number The signal strength between 0 and 15.

Throws

• If value is not between 0 and 15.

Changes

• New in version 1.51

getAnalogOutput(side)Source

Get the redstone output signal strength for a specific side.

Parameters

1. side string The side to get.

Returns

1. number The output signal strength, between 0 and 15.

See also

• setAnalogOutput

Changes

• New in version 1.51

getAnalogueOutput(side)Source

Get the redstone output signal strength for a specific side.

Parameters

1. side string The side to get.

Returns

1. number The output signal strength, between 0 and 15.

See also

• setAnalogOutput

Changes

• New in version 1.51

getAnalogInput(side)Source

Get the redstone input signal strength for a specific side.

Parameters

1. side string The side to get.

Returns

1. number The input signal strength, between 0 and 15.

Changes

• New in version 1.51

getAnalogueInput(side)Source

Get the redstone input signal strength for a specific side.

Parameters

1. side string The side to get.

Returns

1. number The input signal strength, between 0 and 15.

Changes

• New in version 1.51

setBundledOutput(side, output)Source

Set the bundled cable output for a specific side.

Parameters

1. side string The side to set.
2. output number The colour bitmask to set.

See also

• colors.subtract For removing a colour from the bitmask.
• colors.combine For adding a color to the bitmask.

getBundledOutput(side)Source

Get the bundled cable output for a specific side.

Parameters

1. side string The side to get.

Returns

1. number The bundle cable's output.

getBundledInput(side)Source

Get the bundled cable input for a specific side.

Parameters

1. side string The side to get.

Returns

1. number The bundle cable's input.

See also

• testBundledInput To determine if a specific colour is set.

testBundledInput(side, mask)Source

Determine if a specific combination of colours are on for the given side.

Parameters

1. side string The side to test.
2. mask number The mask to test.

Returns

1. boolean If the colours are on.

Usage

• Check if colors.white and colors.black are on above this block.

  print(redstone.testBundledInput("top", colors.combine(colors.white, colors.black)))

See also

• getBundledInput