> For the complete documentation index, see [llms.txt](https://docs.mipcraft.eu/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.mipcraft.eu/smartgolems/gui-system.md).

# GUI System

SmartGolems features a consistent **4-Pillar GUI layout** across all golem classes, ensuring players have a familiar, intuitive control scheme regardless of the golem's specialization.

## 🏛️ Layout Overview

```
+---+---+---+---+---+---+---+---+---+
|   | 📡|   | ⚔ |  | 📦|   | ⭐|   |  Row 1: The 4 Core Pillars
+---+---+---+---+---+---+---+---+---+
|   |   |   |   |   |   |   |   |   |  Row 2: Context / Stats
+---+---+---+---+---+---+---+---+---+
| ⚙ |   | ▶|   | 🪓|   | 💾|  | ✖ |  Row 3: Navigation & Controls
+---+---+---+---+---+---+---+---+---+
```

{% stepper %}
{% step %}

## Pillar 1: Connections & Routes (`📡`, Slot 1)

{% hint style="info" %}
**Sub-Menu**: `&8[&b📡&8] &bConnections & Routes` (5x9 GUI)
{% endhint %}

* **Container Routes**: Displays linked Source and Destination chests, coordinates, and distances.
* **Chest Filters**: Click any chest card to open its **Whitelist / Blacklist** filter configuration.
* **Route Clearer**: Remove individual routes or clear all links with a single click.
* **Quarry & Pen Visualizer**: Displays corner boundaries and area dimensions.
  {% endstep %}

{% step %}

## Pillar 2: Hand Tool Socket (`⚔`, Slot 3)

{% hint style="info" %}
**Sub-Menu**: `&8[&3⚔&8] &3Tool & Equipment` (3x9 GUI)
{% endhint %}

* **Center Socket (Slot 13)**: Place any weapon, pickaxe, axe, hoe, shears, or bucket into the socket.
* **Live Visual Packet Sync**: The golem immediately holds the item in its right hand in the world.
* **Enchantment Application**: Tool enchantments (Efficiency, Fortune, Silk Touch, Unbreaking, Sharpness) directly augment the golem's action effectiveness.
  {% endstep %}

{% step %}

## Pillar 3: Golem Storage Backpack (`📦`, Slot 5)

{% hint style="info" %}
**Sub-Menu**: `&8[&2📦&8] &2Storage [Editable]` (6x9 GUI / 54 Slots)
{% endhint %}

* **Unlocked Slots**: Items currently stored in the golem's internal inventory.
* **Locked Slots**: Blocked with gray stained glass panes with tooltips showing required Storage Upgrade tiers.
* **Access Modes**:
  * **Editable Mode** (Golem is in Stay/Idle state): Players can freely insert and extract items.
  * **Live View Mode** (Golem is actively working): Real-time view of the golem gathering items.
    {% endstep %}

{% step %}

## Pillar 4: Upgrade Codex & Stats (`⭐`, Slot 7)

{% hint style="info" %}
**Display**: Real-Time Dynamic Stat Lore
{% endhint %}

Hovering over the Upgrade Codex card displays all current stats:

* **Movement Speed Multiplier**: Base + (Level × 0.05)
* **Work Speed / Action Delay**: Delay reduction (Instant at Level 4+)
* **Backpack Capacity**: Current unlocked slots out of 54
* **Operating Radius**: 8 to 33 blocks centered on linked chest
* **Step Assist Height**: 1.0b to 2.5b obstacle clearance
* **Combat Mode & Health**: Active HP, Armor defense, and aggro stance
  {% endstep %}
  {% endstepper %}