> 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/golems.md).

# Golems

SmartGolems features **8 specialized companion classes**, each optimized with custom native NMS pathfinding goals and physics constraints.

{% stepper %}
{% step %}

## Quarry Excavator Golem (`⛏`)

{% hint style="info" %}
**Icon**: `&4⛏` | **Theme**: Dark Red | **Base Tool**: Wooden Pickaxe
{% endhint %}

![Quarry Golem Showcase](/files/8Kn73kdBuzEugwGnnfDd)

### Mechanics & Behaviors

* **3D Cuboid Mining**: Systematically excavates a player-defined rectangular cuboid layer by layer from the highest Y-level down to the lowest.
* **Tool & Enchantment Support**: Equipping a pickaxe into the Hand Tool Socket applies its mining speed, **Fortune**, or **Silk Touch** attributes.
* **Drop Collection**: Picks up all broken ores and blocks directly into its backpack and deposits them into linked output chests.
* **Reach Boundary**: Operates strictly within the defined quarry cuboid corners set with the Configuration Wand.
  {% endstep %}

{% step %}

## Animal Rancher Golem (`🐾`)

{% hint style="info" %}
**Icon**: `&c🐾` | **Theme**: Red | **Base Tool**: Lead
{% endhint %}

![Animal Rancher Showcase](/files/RQMIbuaXuO4MHRg3wtk5)

### Mechanics & Behaviors

* **Autonomous Livestock Breeding**: Breeds adult animals (Cows, Sheep, Pigs, Chickens) using feed withdrawn from linked chests (Wheat, Seeds, Carrots).
* **Cow Milking**: Uses empty buckets from storage to milk adult cows and deposits filled Milk Buckets back into storage.
* **Population Monitoring**: Checks the total animal count against the user-configured population cap.
* **Humane Slaughter**: When herd size exceeds the cap, slaughters surplus adult animals while safely protecting baby animals, collecting meat, leather, and wool.
  {% endstep %}

{% step %}

## Tree Lumberjack Golem (`🪓`)

{% hint style="info" %}
**Icon**: `&2🪓` | **Theme**: Dark Green | **Base Tool**: Wooden Axe
{% endhint %}

![Tree Lumberjack Showcase](/files/SjVS8Bve4VUqJjembwLZ)

### Mechanics & Behaviors

* **Bottom-Up Log Chopping**: Targets trees within its chest's operating radius from the ground up (reaching blocks up to 2.5 blocks above ground).
* **Intelligent Vertical Scaffolding**: For taller canopies, builds a single straight-vertical scaffolding tower and climbs inside to reach higher branches.
* **Canopy Clearing**: Chops leaves obstructing sight or movement and collects drops (apples, sticks, saplings).
* **Clean Scaffolding Dismantling**: Completely dismantles its scaffolding tower from top to bottom before moving to the next tree.
* **Trunk Base Replanting**: Automatically replants saplings at remembered trunk base positions on soil.
  {% endstep %}

{% step %}

## Crop Farmer Golem (`🌾`)

{% hint style="info" %}
**Icon**: `&a🌾` | **Theme**: Green | **Base Tool**: Wooden Hoe
{% endhint %}

### Mechanics & Behaviors

* **Mature Crop Detection**: Scans for fully mature Wheat, Carrots, Potatoes, Beetroots, and Nether Wart within its chest operating radius.
* **Instant Smart-Replanting**: Harvests mature crops and immediately replants the matching seed from its inventory.
* **Automated Deposit**: Transports harvested produce to linked output chests without wandering outside its designated farm area.
  {% endstep %}

{% step %}

## Flower Farmer Golem (`🌸`)

{% hint style="info" %}
**Icon**: `&e🌸` | **Theme**: Yellow | **Base Tool**: Bone Meal
{% endhint %}

### Mechanics & Behaviors

* **Bonemeal Propagation**: Uses bonemeal on grass blocks and double-tall flowers to propagate rare flower blossoms.
* **Harvest & Storage**: Picks blossoms and deposits them into linked storage containers.
  {% endstep %}

{% step %}

## Sorting Golem (`📦`)

{% hint style="info" %}
**Icon**: `&d📦` | **Theme**: Light Purple | **Base Tool**: Redstone Comparator
{% endhint %}

### Mechanics & Behaviors

* **Multi-Chest Distribution**: Takes unsorted items from an input source chest and sorts them across up to 5 target chests.
* **Whitelist & Blacklist Rules**: Uses visual filter menus to define specific item routes per chest.
  {% endstep %}

{% step %}

## Item Transport Golem (`🚚`)

{% hint style="info" %}
**Icon**: `&b🚚` | **Theme**: Aqua | **Base Tool**: Hopper / Chest Minecart
{% endhint %}

### Mechanics & Behaviors

* **Long-Distance Logistics**: Transports items between a Source Chest and a Destination Chest over long distances.
* **Supply Chain Automation**: Keeps automated processing lines fed without complicated hopper pipelines.
  {% endstep %}

{% step %}

## Omni Master Golem (`★`)

{% hint style="info" %}
**Icon**: `&6★` | **Theme**: Gold | **Base Tool**: Beacon
{% endhint %}

### Mechanics & Behaviors

* **All-in-One Utility**: Capable of switching between combat, mining, farming, and carrying tasks.
* **Expanded Capacity**: Starts with 9 base slots and expands up to 54 slots.
  {% endstep %}
  {% endstepper %}