Control Panel

Overview

The Control Panel is a decorative block capable of hosting functional blocks and items. Inserted items are rendered directly onto the surface of the panel while preserving their relevant functionality. See Control Panel Panels for items that have a functionality.

For example, inserting an Analog Source allows the player to configure and output a Redstone signal directly from the panel surface, including interaction with the physical knob. Indicators can also be inserted, causing the panel to visually display the supplied signal level.

The block is designed to resemble industrial control consoles and can be used to build control rooms, machinery interfaces, dashboards, and decorative automation systems.

GUI

In the top-left corner of the GUI there is a circular control element with an inventory slot in the center where the functional item is placed. Only a single item is inserted from the held stack.

The circular control element is also used to rotate the functional item. Clicking the outer ring allows the item to be rotated with a precision of 1°, while the inner ring rotates the item in steps of 15°. A red arrow indicates the current rotation of the item.

Above the player's inventory are three buttons that select the shape of the Control Panel.

Two groups of buttons are located to the left and right of these shape selection buttons. These button groups are used to configure individual Pin Marks.

The left-side button group always controls the pin marks used by Shape 1 and Shape 2, while the right-side button group is only used by Shape 3.

When using Shape 3, the meaning of the button groups depends on the current orientation:

• If the panel connects a wall with the floor or ceiling, the left-side buttons control the top or bottom pin marks, while the right-side buttons control the wall-side pin marks.
• If the panel connects two walls, then when viewed from the front of the panel, the left-side buttons configure the left-side pin marks and the right-side buttons configure the right-side pin marks.

Configuration

Shift + right-click with an empty hand will change the shape of the block.

Using a Rotation Bracket rotates the block differently depending on the currently selected shape:

• Shape 1 - Does not rotate
• Shape 2 - Rotates around its local Y-axis
• Shape 3 - Rotates around the world Y-axis

Right-clicking the block with any other item or an empty hand opens the configuration GUI.

After inserting items, changing their orientation or changing the shape, player can transfer the configuration to an Control Panel item by right-clicking the Control Panel block with Control Panel item.

When the configuration is copied:

• The item receives an enchantment glow effect.
• The item description displays the inherited configuration.

Placing the item as a block will apply the stored configuration to the newly placed Control Panel. If the configuration includes items, the items from the players inventory will be transfered to the block if the player has the required items.

Crafting

Adventure Mode

While in adventure mode, /redstonecg_adventure controls:

• /redstonecg_adventure gateGUI false - Disables GUI.
• /redstonecg_adventure valueConfig false - Blocks item right-click interaction.
• /redstonecg_adventure pinConfig false - Removes pin configuration buttons and shape configuration.

Data

Block State

Registry name: redstonecg:control_panel

Block properties:

• waterlogged(false|true): determines whether the block is waterlogged.
• orientation(0-41): encodes the model, facing and rotation of the block.

orientation

Values 0-5 are used by Shape 1. Each value determines the direction of the block's base face in order: Down, North, East, South, West, Up.

Values 6-29 are used by Shape 2. The range is divided into six groups of four values, with each group determining the direction of the block's base face:

• 6-9: Down
• 10-13: North
• 14-17: East
• 18-21: South
• 22-25: West
• 26-29: Up

Within each group, the value determines the clockwise rotation around the block's local Y-axis:

• 0°: 6, 10, 14, 18, 22, 26
• 90°: 7, 11, 15, 19, 23, 27
• 180°: 8, 12, 16, 20, 24, 28
• 270°: 9, 13, 17, 21, 25, 29

Values 30-41 are used by Shape 3. The range is divided into three groups of four values:

• 30-33: one of the base faces faces Down.
• 34-37: both base faces face walls.
• 38-41: one of the base faces faces Up.

Within each group, the value determines the clockwise rotation around the world Y-axis:

• 0°: 30, 34, 38
• 90°: 31, 35, 39
• 180°: 32, 36, 40
• 270°: 33, 37, 41

Block Entity

Structure:

• id: block entity identifier - redstonecg:control_panel
• x: X coordinate of the block entity.
• y: Y coordinate of the block entity.
• z: Z coordinate of the block entity.
• connection: sets the Pin Mark configuration.
• Items: contains the placed Control Panel Panel item. Each item also contains a Slot identifying its inventory slot. For Control Panel block there will at most be a single item at slot 0.
• slot_angles: contains the rotation of each Control Panel Panel in radians.
• schedule: contains scheduled slot events. Each event contains a relative execution time and an inventory slot. When an event is executed, the associated inventory slot is updated and the event data is removed.
  • tick: contains the relative execution times of scheduled events in game ticks. A value of 0 means that the event executes on the same game tick as the previous event.
  • slot: contains the inventory slots associated with scheduled events. For Control Panel, these values are always 0.

connection

For Shape 1 and Shape 2, the least significant four bits along with another bit of connection are used to configure connections in the local frame:

• Bit 0: forward
• Bit 1: right
• Bit 2: left
• Bit 3: back
• Bit 6: base face

For Shape 3, the entire byte is used and is divided into two groups of four bits. The left plate uses bits 7, 3, 2, 0, representing its connections to the base face, left, down and up. The right plate uses bits 6, 5, 4, 1, representing its connections to the down, right, up and base face.

Item

Structure (1.20.4 and older):

• id: item identifier - redstonecg:control_panel
• Count: the amount of items in this stack.
• tag (Optional): additional item data.
  • BlockParameterSet (Optional): set of parameters for placing a block.
    • connection (Optional): target Pin Mark configuration of the block.
    • orientation (Optional): target orientation of the block.
    • slot_angles (Optional): rotation of each placed Control Panel Panel in radians.
    • Items (Optional): placed Control Panel Panel item data.

Structure (1.20.6 and newer):

• id: item identifier - redstonecg:control_panel
• count: the amount of items in this stack.
• components (Optional): item data components.
  • minecraft:custom_data (Optional): custom item data.
    • BlockParameterSet (Optional): set of parameters for placing a block.
      • connection (Optional): target Pin Mark configuration of the block.
      • orientation (Optional): target orientation of the block.
      • slot_angles (Optional): rotation of each placed Control Panel Panel in radians.
      • Items (Optional): placed Control Panel Panel item data.

Version Log