Hanging RedCu Wire Connector

Overview

The Hanging RedCu Wire Connector is a special RedCu component designed to connect two distant redstone-compatible components using a suspended RedCu Wire. It allows signal transmission through air without requiring intermediate support blocks.

Unlike most RedstoneCG blocks such as gates, wires, and indicators, the Hanging RedCu Wire Connector can float in mid-air. It also provides a solid mounting surface at its base, enabling decorative or structural redstone builds where components must hang from ceilings or remain suspended.

Crafting

Functionality

To connect two components using Hanging RedCu Wire Connectors:

1. Place a Hanging RedCu Wire Connector block so it connects to a redstone-compatible component.
2. Right-click the placed block using a Hanging RedCu Wire Connector item. The item will store the position of the clicked block.

When the position is stored:

• The item gains an enchantment glow effect.
• The item description displays the stored coordinates.
• The stored position can be cleared by right-clicking in air

After storing a position, place another Hanging RedCu Wire Connector block using the same item at the desired location.

• If the distance between the two blocks is less than or equal to 16 blocks, they will automatically connect with a Hanging RedCu Wire.
• The amount of RedCu Wire items consumed equals the calculated distance.
• If the player does not have enough RedCu Wire in inventory, the connection will not be established.

The maximum connection length can be modified using command:

/redstonecg_gameplay maxHangingRedCuWireLength <value>

The distance between the two connectors is calculated as the real spatial distance between them and then rounded down using a mathematical floor operation. So if the actual distance is 13.56, the used distance is 13.

Signal propagation through the Hanging RedCu Wire behaves identically to a standard RedCu Wire.

Connection

Unlike most gates, the Hanging RedCu Wire Connector uses a RedCu Pin Mark. This indicates that the block behaves as a RedCu Wire connection rather than a standard redstone block.

Right-clicking the block with any item or an empty hand except Hanging RedCu Wire Connector item will cycle through available pin configurations.

Every 16th click toggles the base connection state, shown by the RecCu Pinmarks in the corners. When enabled, the block can both read and output signal from its base.

Moving

Moving a Hanging RedCu Wire Connector is generally discouraged, as the block stores information about the connector it is attached to. However Hanging RedCu Wire Connectors include a recovery mechanism that attempts to restore connections whenever possible.

Consider a setup where two connectors, A and B, are connected. Connector A is placed first and connector B is placed second.

Whenever either connector is updated, a connection check procedure is executed for each connection.

Each connector primarily stores the relative position of the connector it is attached to and also maintains a precomputed absolute position. During recovery, the connector first attempts to verify or restore the connection using the relative position. If that fails, it falls back to the stored absolute position. If the absolute position successfully locates a valid connector, the relative position is updated accordingly.

Based on this behavior, the following outcomes can be expected:

• If both A and B remain stationary, the connection remains fully functional.
• If B is moved and neither connector receives an update, a visual glitch may appear where one end of the Hanging RedCu Wire remains attached to A or B while the other end appears to float in space.
• If A is updated and no Hanging RedCu Wire Connector exists at B's expected position, A removes the connection.
• If A is updated and another Hanging RedCu Wire Connector exists at B's expected position, A assumes that connector is the intended target and connects to it.
• If B is updated and another Hanging RedCu Wire Connector exists at the predicted position of A, B connects to that connector.
• If B is updated and connector A is within the configured maxHangingRedCuWireLength distance, B can recreate the connection to A. This recovery path specifically requires B's Block Entity to have been moved rather than unloaded and reloaded, because only the relative position is preserved when the Block Entity is saved and loaded.
• The same behavior applies if A is moved while B remains stationary.
• If both connectors are moved at the same time, the connection is preserved and can continue functioning normally.

Version Log