Multi-Block Structure Export Tool User Guide / Design Bureau Staff Operating Manual
As everyone has seen, one of the defining features of the GTO modpack is its diverse array of custom multi-block structures. When it comes to multi-block design, the development team warmly encourages players to create their own multi-block structures and integrate them into the modpack in a meaningful way—whether that means crafting entirely new machines or refurbishing existing structures that may not look quite right. To facilitate this process, the modpack includes a highly convenient multi-block structure export tool that requires no coding knowledge whatsoever. Below, we’ll walk you through how to use the multi-block structure export tool.
Enable Developer Mode
Before use, please ensure that the modpack is in Developer Mode; otherwise, the Multi-Block Structure Export Tool will not load. To enable Developer Mode: Open the configuration interface for GTOCore and toggle “Developer Mode” to ON, then restart the game. Do not play normal gameplay while in Developer Mode, as many recipes will be missing.
After enabling Developer Mode and launching the game, simply search for “Multi‑Block Structure Export Tool” in EMI to obtain this mysterious little wand.
Introduction to Export Tool Features and How to Use It
Interface
Right‑click on the air with the handheld export tool to open the export tool UI.
- The first line indicates the scale of the selected target.
- The second line specifies the export order; you don’t need to pay too much attention to it.
- “Rotate by X-axis” and “Rotate by Y-axis” are used to adjust the orientation of a structure after it has been selected; their specific uses will be explained later in this document.
- The “Export Mode” button indicates the current usage mode. Clicking the mode button and then exiting and re-entering the UI will toggle between modes. Currently, there are two modes: “Export Mode” and “Binding Mode,” both of which are used when exporting structures; their respective uses will be explained later.
- After clicking the “Export to Log” button, the structural code of the selected multi-block structure will be exported to the log; its usage will be explained later in this section.
Basic Operations
1. Electoral District
- After constructing the necessary structure in-game, equip the Export Tool and open the UI to ensure that you are currently in “Export Mode”. Then, simply right‑click on any block to select a bounding box; the selected area will be highlighted with a blue outline.
- The selection logic follows an “incremental selection” approach: each right‑click expands the selection’s length, width, and height based on the first block selected with a right‑click (no need to construct auxiliary blocks along the diagonal), making it extremely convenient to select structures that lack diagonal blocks.
- To reset the selection area, simply hold SHIFT + Right Click at any time.
- The blocks within the selection area are updated in real time; if changes are made after the selection is completed, there’s no need to reselect the area.
2. Material blocks for binding the storage chamber and the host machine
Open the UI and switch the mode to “Binding Mode.” In this mode, simply right‑click the block type you wish to set to bind the block material types of both the cabin and the host. A notification will appear upon successful binding.
3. Configure whether the machine can use the laser bay (high‑power energy bay).
Open the UI and switch the mode to “Binding Mode”. In this mode, right‑click any block while holding SHIFT,
4. Export Structure Code
Open the UI and click the “Export to Log” button. The exported file will be located in the latest.log file within the logs folder at the root directory. Once opened, scroll to the very bottom—there you’ll find the structure code.
Structural Direction
Under normal circumstances, it’s best to ensure that the controller block faces outward when exporting a structure. Since the orientation of the controller block is fixed in the exported code, we need to adjust the machine’s orientation by rotating it around the X‑axis. Rotation around the Y‑axis is used less frequently and will not be discussed in detail here. The following section will use a simple example to illustrate this process. As shown in the figure, I’ve constructed a basic 3×3 multi-block structure (with oak logs serving as placeholder blocks for the controller block).
After completing the selection and exporting, you’ll see the following code in the logs. In this code, you can observe that placeholder B represents the host block, while A represents the iridium-reinforced machine block. However, the issue with this code is that the controller block is oriented incorrectly—when you use this code as-is, you’ll notice that the controller block’s face is pointing inward. Therefore, we need to rotate it.
Click “Rotate by Y-axis” twice, then export the model—after which you’ll see the following code. At this point, the host’s orientation will match your expectations.
By examining the code in both examples, you’ll notice that the bottommost line of code actually corresponds to the very first layer on the front side of the structure as it appears in-game. If the controller block is located on the outermost layer, make sure the host placeholder is placed on the last row. Similarly, if it’s on the second layer, ensure the controller block’s placeholder is positioned on the second-to-last row. (Of course, this step isn’t strictly necessary—if the mod developers handle the conversion instead.)
Placeholder block
The modpack features a large number of tiered blocks and replaceable blocks, such as ABS casings, coils, and more. The export tool includes a convenient conversion system; if you wish to use these blocks in your multi-block structures, you can designate certain vanilla blocks as placeholders—during export, the code will automatically handle the conversions. Below is a list of placeholder blocks. If you encounter blocks not listed here, simply specify them directly in the structure’s code file when submitting.
Complete Operation Procedure
Export a multi-block structure code from scratch
- Build the multi-block structure you designed.
- Replace the controller blocks with oak logs and replace the chamber locations with cobblestone.
- Replace the placeholders with blocks (if applicable).
- Bind cabin block type.
- Set whether the machine is a laser machine or a conventional machine.
- Select the structure you designed and export the code.
- Rotate the knob to align the host as needed (this step can be skipped), then export again.
- Copy the adjusted structure code into a new document and submit it (simply upload it to the group’s file directory—recommended to include a preview image).
Tip: Selection, binding chamber block types, laser/normal machine toggling, and other operations do not need to be performed in a specific order.