GT Interface

Editor's note: As of 2023/05/19 (yyyy/mm/dd), I (user "hallucinogender") am working on creating this page. For the sake of allowing me enough time to format the page and assemble a coherent guide, I would appreciate if other editors refrain from making major edits to this page prior to 2023/06/01 (yyyy/mm/dd).

Introduction
Gregtech is a large mod which adds a lot of complexity to the game; the learning curve is steep, but. This article covers the basic ways of interacting with the core functionality of blocks added by Gregtech. This includes configuring the way machines and pipes interact with things around them, applying and manipulating covers (as well as what covers actually do to the blocks you put them on), and understanding and using the graphical user interfaces (GUIs) of Gregtech machines (editor's note: if the GUI section gets too big, which it might, then it may be beneficial to split off into its own article). For practical use cases of pipes and covers, see GT Logistics (editor's note: I'm working on the GT logistics guide in tandem with this guide).

In-World Interactions
Editor's note: this section will describe: what different faces of GT blocks do and how to tell which face is which; how pipes and wires connect to each other and to blocks (and what kinds of blocks they can and can't connect to); how to access block faces with the wireframe visualization; how to apply and remove covers; in-world functions of GT tools; how to access different kinds of GUIs.

Gregtech Machines & Devices
One of the most common things in any Gregtech base will be singleblock machines: blocks which, when properly powered, will allow you to turn item and/or fluid ingredients into item and/or fluid outputs. These, along with other Gregtech blocks that have a wide variety of functions (e.g. transformers, item filters, hatches), are all capable of interacting with surrounding blocks in very similar ways and can be configured by the player in similar ways.

All Gregtech machines and devices can be safely mined using a Gregtech wrench.

Block Faces
For anyone unfamiliar with geometric terminology, a cube (in this case, a Minecraft block) has a surface composed of six squares called "faces". Most blocks in Gregtech (those with a function, anyway) have one unique face that is different than the rest. Singleblock machines actually have two unique faces. When you place a block, the unique face will usually be facing towards you.

The Wireframe
Certain Gregtech tools (the screwdriver, wirecutter, wrench, and electric or multitool variants of these) as well as Gregtech covers allow you to configure specific faces of functional blocks. When you hold any of these items and look at any Gregtech machine, functional block (like a transformer), pipe, or wire (or certain vanilla blocks, such as hoppers) at close enough proximity to interact with that block, you will see a wireframe overlay on the block face you are looking at. This overlay allows you to use the right-click interaction of the tool or cover you are holding to affect any face of the block without having to right-click the desired face directly. The face you interact with is determined by where you click on the wireframe. The image labelled "The Wireframe" is an example of how the wireframe overlay looks: it divides the block face into nine sections without obscuring your view of the block. The numbers are not present in-game; the screenshot has been annotated for the purpose of this guide. Right-clicking in the middle section (labelled "1" in the screenshot) interacts with the block face you are looking at, while right-clicking any of the corners (labelled "6" in the screenshot) will interact with the face opposite the one you are looking at. Right-clicking any of the edge sections (labelled "2" through "5" in the screenshot) interacts with the face immediately adjacent to the section that you click. For example, in the case of the screenshot, right-clicking on any of the sections labelled "6" interacts with the back face of the machine (since the player is looking at the front face in this case), right-clicking on the section labelled "3" interacts with the right face of the machine, and right-clicking on the section labelled "5" interacts with the bottom face of the machine; the latter is true even though the bottom face is completely blocked off in this case, and is therefore not directly accessible without breaking blocks.

The only interaction specific to a particular block face that does not use the wireframe overlay is the crowbar (Gregtech or Railcraft crowbars both work the same), which is used to remove covers. With the crowbar, you have to click on the face that has the cover directly in order to remove it.

Singleblock Machines
Singleblock machines have a front face (which has an identifying texture indicating the type of machine) and an output face (which has a dark grey square texture in the middle) (Editor's note: add screenshots). When you place a singleblock machine, the front face will be horizontally facing you and the output face will be opposite the front. The category of "singleblock machines" excludes things like generators and steam boilers, which are covered separately.

The front face can only be repositioned by breaking the machine and re-placing it. Covers cannot be attached to the front of a singleblock machine, and nothing can be transferred in or out of the machine via the front face by any method.

The output face can be repositioned to any other face (aside from the front face, which cannot coincide with the output) by right-clicking on the appropriate section of the wireframe layout using a Gregtech wrench. Gregtech singleblock machines can be set to auto-output items and/or fluids with a button in the GUI (see GUI section of this article), and this type of built-in auto-output occurs via the output face. By default, items and fluids cannot be inserted into a machine via the output face; this behaviour can be changed by right-clicking the output face with a Gregtech screwdriver to allow input via the output face (you can change this back to the default by simply right-clicking again on the output face with a screwdriver).

On steam machines, the "output" face instead serves as the steam vent; this means that the face must not be obstructed (i.e. the block space immediately adjacent to the steam vent face must be empty) in order for the machine to function.

Covers Overview
Editor's note: this section will describe all forms of covers and what they do to blocks they are placed on.

Graphical User Interfaces
Editor's note: this section will describe how to understand and interact with all Gregtech GUIs as well as the multiblock recipe display in NEI (since that is different than actual multiblock GUIs).