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

# Introduction

![](/files/OAMPcjs00fIiuVaMKe4b)

{% hint style="info" %}
**SmartGolems** is an enterprise-grade Minecraft Spigot & Paper plugin built for Minecraft (26.X). It transforms ordinary Copper Golems into autonomous, upgradeable, and highly intelligent companion workers capable of farming, quarrying, sorting, transporting, lumberjacking, animal breeding, and defending your base.
{% endhint %}

## 🌟 Core Highlights

* **Autonomous Specialized AI**: Built directly on native NMS pathfinding for ultra-fast, zero-lag task execution.
* **Strict 2-Block Melee Reach**: Golems interact physically with blocks and containers within a realistic 2.8-block melee radius.
* **Permanent Anti-Oxidation (No Rusting)**: Golems never oxidize, turn green, or freeze into copper statues.
* **Consistent 4-Pillar GUI**: Standardized 3x9 control panel layout across all golem classes (Connections, Equipment, Storage Backpack, Upgrade Codex).
* **Progressive Upgrade System**: Tiered crafting recipes where each upgrade tier requires the previous tier as a crafting ingredient.
* **Smart Backpack Storage**: 54-slot visual inventory with locked glass panes displaying current capacity level.
* **Visual Equipment System**: Equip weapons, tools, or items into the golem's hand with live packet synchronization.
* **Custom Item & CraftEngine Support**: Seamlessly accepts custom items from `CraftEngine` (`craftengine:<id>` or `ce:<id>`) or vanilla materials across all recipes and filters.
* **Minimalist Icon Nametags**: Clean over-head symbols (`★`, `🌾`, `🪓`, `🌸`, `🐾`, `⛏`, `📦`, `🚚`) replacing cluttered text names.

## 🚀 Quick Start Guide

{% stepper %}
{% step %}

## Installation

1. Download `MipCraft_SmartGolems.jar`.
2. Place the `.jar` file into your server's `plugins/` directory.
3. *(Optional)* Install **CraftEngine** if you plan to use custom textured items in recipes.
4. Restart your server.
   {% endstep %}

{% step %}

## Spawning a Golem

1. Craft a golem spawn egg in a crafting table (e.g. Copper Block + Tool/Material + Copper Ingots).
2. Right-click the egg on the ground to place the golem.
3. Your golem will spawn with a clean icon nametag overhead and permanent anti-oxidation protection!
   {% endstep %}

{% step %}

## Linking & Configuration

1. Craft a **Configuration Wand** (`AMETHYST_SHARD` + `STICK`).
2. Right-click the golem with the wand, then right-click a target Chest/Barrel.
3. Right-click the golem without sneaking to open the **4-Pillar GUI Control Panel**!
   {% endstep %}
   {% endstepper %}

<figure><img src="/files/rZjQu1UVz9YchBdOZBCd" alt=""><figcaption></figcaption></figure>

## 🧭 Navigation

* [Golem Specializations](broken://pages/21957a54d0af1a2d89c12fb14315bb44f844931b)
* [4-Pillar GUI Interface](broken://pages/45a8b2c55c5ace2f84b4ac956547eb5882c5f60d)
* [Progressive Upgrades](broken://pages/78eb6363179803675cdc642e90d9fb3062337719)
* [Crafting Recipes](broken://pages/085797ecdde8914368ed3018293adf5bc8125270)
* [Wand & Controls Guide](broken://pages/ee2df8c47ac1edfa8cfd53080788ec5c8d680f68)
* [Configuration (config.yml)](broken://pages/ccbb9c4a447ce1b084fb7daacfb2bc271b14c952)