Create: Factory Controller

Dashboard

The dashboard UI appears when you interact with a factory controller block. It displays a virtual 2D board on which you can place factory gauges (and other components).

dashboard ui
Figure 1. Dashboard UI
Table 1. Basic interactions
Pan viewDrag with left mouse button
W, A, S, D
Zoom in/outMouse scroll wheel
Place componentHold a placeable item + Click on empty space
Open componentLeft/right click
Remove componentShift + Click

UI Overview

❶ Title bar
Shows the name of this factory controller. Name can be edited by clicking on it.
❷ Help button
Opens this help page.
❸ Network selector
All networks tuned to by components placed in this controller are listed here. Scroll to select a network to highlight its components. While holding a gauge, scroll to tune the gauge to a network. More Info
❹ Capacity indicator
Shows the maximum number of components that may be placed in this factory controller, as well as how much of this capacity has been taken up.
The capacity may be modified by the "Controller Capacity" server setting.
❺ Zoom indicator
Shows the current zoom level.
❻ Settings button
Opens the settings screen.
❼ Player inventory
Shows the player inventory. Only the 9 hotbar slots are shown by default. Click the "+" button to expand the other 27 slots.

Drag with the left mouse button to pan the view around the virtual board. The W, A, S, D keys can also be used to move the view in cardinal directions.

Scroll with the mouse wheel to zoom in/out.

Working with Components

dashboard place component
Figure 2. Holding a tuned factory gauge over an empty location

To place a component, grab a corresponding item from the inventory and click on an empty spot on the board. The Components page lists all items that may be placed. Notably, factory gauges need to be tuned to a network before being placed. Placed items will be stored inside the factory controller, even when the factory controller block is mined.

gauge empty
Figure 3. A just-placed factory gauge

Holding shift and clicking on a component removes it from the controller and returns the item to your inventory.

Either left- or right-clicking a component opens its configuration screen. To move a component, open its screen and click the btn relocate "relocate" button, then click on a new location for the component. Alternatively, press the Q key while hovering the component, then click a new location.

Multiple components may be selected. Hold Ctrl and drag with the left mouse button to select all components within a rectangular area. Selected components are indicated with a green outline. To add and remove individual components from the selection, hold Ctrl and left-click them.

dashboard rect select
Figure 4. Rectangle-selecting multiple components

When components are selected, drag on any of them to move all selected components. Likewise, shift-clicking on any of them removes all selected components from the board.

Creating and Modifying Connections

Components may be connected to one another. Refer to a specific component’s documentation for the functionality provided by connections.

To connect component A to B, click on B to open its UI, click on the btn add connection "add connection" button, and then click A. Alternatively, press the C key while hovering B, then click A. Some components may only act as the source or sink of a connection, in which case a valid direction is automatically chosen.

A component’s UI may allow you to remove its connections. They can also be removed using the dashboard by hovering over them and shift-clicking. When multiple connections overlap, hold shift and scroll while hovering over a spot with overlapping connections to select one of them.

dashboard select overlapping connections
Figure 5. Selecting overlapping connections

Connections automatically choose paths between their 2 ends. To customize this path, select from 4 path modes by hovering over a connection and pressing R. Keeping the mouse cursor still after changing path modes keeps the connection selected. The path modes of all connections on one component can be changed by pressing R on the component.

dashboard connection path modes
Figure 6. Path modes

Network Selector

network selector empty
Figure 7. Network selector with no network

Factory gauges need to be tuned to a network before being placed in the controller. The first gauge needs to be tuned the usual way (e.g. by interacting with a stock link with a gauge in hand). Once a tuned gauge is placed in the controller, its network appears in the network selector.

network selector selected
Figure 8. Network selector with a network selected

With an empty cursor, scrolling with the mouse wheel selects one of the tuned networks, highlighting all components tuned to that network with a blue outline. The number of components tuned to the network also appears on the network selector icon.

While holding a factory gauge item, scrolling on the network selector changes the network this item is tuned to, allowing you to quickly tune a new gauge to an existing network. Holding shift and scrolling accomplishes the same.

Additional Interactions

Some components, like the redstone link, have modes of operation that can be switched either by pressing the F key while hovering over them in the dashboard, or through their configuration UI.

Each factory gauge displays a label, providing relevant information (e.g. items in stock) at a glance. When the labels become distracting or obstruct other components, they can be hidden by pressing Alt. Then only the label of the hovered component is displayed. Press Alt again to show all labels.

Table 2. Summary
Move componentQ on component
Rectangle selectCtrl + Drag with left mouse button
Add to selectionCtrl + Click component
Remove from selection
Move selected componentsDrag on a selected component
Remove selected componentsShift + Click on a selected component
Create connectionC on component
Select overlapping connectionShift + Scroll
Remove connectionShift + Click
Change connection shapeR on component or connection
Change component modeF on component
Tune item to networkHold item + Shift + Scroll
Toggle gauge labelsAlt

Notices

When a factory gauge is tuned to a network that contains stock links in unloaded chunks, the gauge stops functioning and displays a “?” on its label. When this happens to any gauge in a factory controller, its dashboard displays a notice near the top-left corner. Hovering the notice displays a tooltip detailing the locations of the unloaded stock links they were last known at.

dashboard unloaded links
Figure 9. Notice about unloaded stock links