---
title: Cable Relay
id: morered:cable_relay
type: block
---

Cable Relays are blocks that can be connected to each other via a [Bundled Cable Spool](@morered:bundled_cable_spool) to transmit redstone power on multiple channels across long distances.

| ![Cable Junctions](https://commoble.s3.us-east-1.amazonaws.com/images/morered/blockless_bundled_cables.png)
| ---
| Cable Junctions and Relays being used with [Red Alloy Wires](@morered:red_alloy_wire), [Colored Cables](@morered:orange_cable), and [Bundled Cables](@morered:bundled_cable) to transmit power

<table>
	<thead><tr><th>Contents</th></tr></thead>
	<tbody><tr><td>
		1. [Recipes](#recipes)
		2. [Usage](#usage)
		3. [Data](#data)
		4. [History](#history)
	</td></tr></tbody>
</table>

## Recipes
<table>
	<thead>
		<tr>
			<th>Recipe Type</th>
			<th>Ingredients</th>
			<th>Output</th>
			<th>Example</th>
		</tr>
	</thead>
	<tbody>
		<tr>
			<td>Shaped Crafting</td>
			<td style={{width: '30%'}}>
				* 1x [<ModAsset width={32} height={32} location='iron_ingot'/> Iron Ingot](https://minecraft.wiki/Iron_Ingot)
				* 1x [<ModAsset width={32} height={32} location='morered:item/bundled_cable'/> Bundled Cable](@morered:bundled_cable)
			</td>
			<td>
				* 1x Cable Relay
			</td>
			<td>
				![Shaped Crafting Recipe for Cable Relays](https://commoble.s3.us-east-1.amazonaws.com/images/morered/recipes/bundled_cable_post_recipe.png)
			</td>
		</tr>
		<tr>
			<td>[Soldering]('/en/mod/morered/docs/content/soldering_table')</td>
			<td style={{width: '30%'}}>
				* 1x [<ModAsset width={32} height={32} location='iron_ingot'/> Iron Ingot](https://minecraft.wiki/Iron_Ingot)
				* 1x [<ModAsset width={32} height={32} location='morered:item/bundled_cable'/> Bundled Cable](@morered:bundled_cable)
			</td>
			<td>
				* 1x Cable Relay
			</td>
			<td>
				![Soldering Recipe for Cable Relays](https://commoble.s3.us-east-1.amazonaws.com/images/morered/recipes/bundled_cable_post_from_gatecrafting.png)
			</td>
		</tr>
	</tbody>
</table>

## Usage

Cable Relays can be placed in 6 different orientations, on walls, floors, and ceilings. When placing the block, the flat side will be placed against the face clicked by the player.

Cable Relays can be connected to other Cable Relays or to [Cable Junctions](@morered:cable_junction) by using a [Bundled Cable Spool](@morered:bundled_cable_spool) on two such blocks. Connections can be removed by using the spool on the two connected blocks again.

Unlike Cable Junctions, Cable Relays will not connect to adjacent cables; only via the spool can they be connected to anything else.

## Data
<table>
	<thead><tr><th>Blockstate Properties</th><th>Values</th><th>Description</th></tr></thead>
	<tbody>
		<tr><td>`facing`</td><td>`{"down", "up", "north", "south", "west", "east"}`</td><td>Direction to the neighbor block the post is attached to</td></tr>
		<tr><td>`transform`</td><td>`{"identity", "rot_180_face_xz", "rot_90_y_neg", "rot_80_y_pos", "invert_x", "invert_z", "swap_xz", "swap_neg_xz"}`</td><td>Set when the block is rotated/mirrored by structure generation or similar mechanics; it ensures blockentity data is transformed accordingly. When placed by a player, this will always be `"identity"`.</td></tr>
		<tr><td>`waterlogged`</td><td>`{"false", "true"}`</td><td>Whether the block is waterlogged</td></tr>
	</tbody>
</table>

<table>
	<thead><tr><th>BlockEntity Data</th><th>Format</th><th>Description</th></tr></thead>
	<tbody>
		<tr>
			<td>`connections`</td>
			<td><ul><li>List of block positions in [X,Y,Z] format</li><li>e.g. `[[2, 5, -6], [2, 5, -9]]`</li></ul></td>
			<td>Relative distances to other blocks which this post is connected to</td>
		</tr>
	</tbody>
</table>

## History
<table>
	<thead><tr><th>Version</th><th>Changelog</th></tr></thead>
	<tbody>
		<tr>
			<td>1.21.8-8.0.0.0</td>
			<td>
				<ul>
					<li>Added `waterlogged` blockstate property</li>
				</ul>
			</td>
		</tr>
		<tr>
			<td>1.21.3-7.0.0.0</td>
			<td>
				<ul>
					<li>Rewrote how wires connect and transmit power; all wires in a network update at once instead of causing cascading block updates</li>
					<li>Renamed from Bundled Cable Post to Cable Relay (`bundled_cable_post` -> `cable_relay`</li>
					<li>No longer stores power</li>
					<li>No longer loses power over distance; instead has a maximum network size (default 1024, configurable)</li>
				</ul>
			</td>
		</tr>
		<tr>
			<td>1.20.1-4.0.0.0</td>
			<td>
				<ul>
					<li>Added `transform` blockstate property</li>
					<li>`connections` are now stored as relative positions instead of absolute positions</li>
				</ul>
			</td>
		</tr>
		<tr><td>1.16.5-2.1.0.0</td><td>Added to game</td></tr>
	</tbody>
</table>
