Welcome to the Hangar Open Beta. Please report any issue you encounter on GitHub!
Copper golems follow chest signs or put like with like, and keep your furnaces fuelled and fed. Golems Union approved.
All versions are for Paper 26.3 (Java 25); 2.6.0 and later need Paper 26.3 build 190 or newer. Versions before 2.0 were called SmartCopperGolems. To upgrade, replace the old SmartCopperGolems-*.jar in plugins/ with the new one and restart. Your config.yml is kept. From 3.0.0 on, settings new in a version are added to it at startup with their explanations, and the explanations of the settings you have are brought up to date (before that, new settings used their defaults until you added them).
3.1.0 (2026-11-05)
New
Golems keep furnaces going before they sort. An idle golem first does furnace upkeep (stopped furnaces, empty buckets, fuel, items to cook from a [Furnace Supply]), then sorts copper chests, then takes out finished items, then re-sorts [Overflow]. Before, sorting always came first and furnaces were tended only when there was nothing to sort. furnace-jobs-before-sorting (default 3; 0 = sorting first, the old order) is how many furnace jobs in a row a golem does while a copper chest has items before it sorts once.
A sign label too wide for one line can carry on to the next: leave the [ open and close it with ] on a later line ([Only light / sources] = [Only light sources]). Lines are joined with a space, or with nothing after a - or _. Before, a label had to fit on one line, so some group names and most [Only <group>] filters couldn’t be written at all. /cgc check points out a label that’s never closed, and /cgc label and /cgc overflow say how to write a label too wide for one line.
The README lists the default groups, with their sign labels and what’s in them.
/cgc check on a chest now ends with sign-label advice, the same as /cgc label: for an unlabelled chest, labels for what’s in it (most specific first) and which items wouldn’t fit; for a labelled chest, anything in it the label doesn’t cover and a label that would cover it; for an empty chest, labels for the item in your hand. [Overflow], [Fuel], [Furnace Supply] and copper chests get none. /cgc label on a labelled chest also now suggests a label for what its label doesn’t cover.
search-distance (default 32, vanilla’s range; up to 128): how far golems look for chests, copper chests, [Overflow] chests and furnaces, in blocks each way sideways. Above 32 the plugin walks golems to chests vanilla golems can’t see and moves the items for them, lets their paths reach that far, and gives longer walks more time before giving up.
claim-blocks-per-extra-golem (default 0, off): bigger claims get more golems. Each claim gets one more golem than max-golems-per-claim for every this many claim blocks of its area, so with 5 and 2500 a 9×9 claim gets 5 and a 100×100 claim gets 9.
Changed
/cgc check on an [Overflow] chest now points to /cgc overflow. The range in the messages and help of /cgc overflow and /cgc storage now follows search-distance instead of always saying 32 blocks.
Four default groups have shorter names, so their sign labels fit on one line: smithing-templates is now templates, crafting-materials is now materials, saplings-and-leaves is now foliage, and concrete-and-terracotta is split into concrete (blocks, powder, slabs and stairs) and terracotta (plain, dyed and glazed). The old and new names both work on signs whichever your config.yml has: upgrading doesn’t change your groups:, so [foliage] finds an older config’s saplings-and-leaves, and [concrete and terracotta] finds both new groups. With the new groups, concrete and terracotta no longer count as the same group when golems match a chest by its contents, and a [Terracotta] sign takes glazed terracotta too (it’s now a group; before it took plain and dyed only). /cgc label and /cgc overflow suggest the short name on an older config when there is one.
Walks the plugin sends golems on (to furnaces, supplies, far or high chests, overflow chests) no longer end at a fixed 30 seconds or so. A golem gives up when it has gone 10 seconds without getting a block closer, either in a straight line or along its path, so stuck golems move on sooner and slow ones (Slowness, soul sand, crowds) get there. A ceiling that grows with search-distance (81 s at 32, 132 s at 64, 235 s at 128) ends any walk that never arrives.
How long a golem keeps trying to deliver an item now comes from the walk, not a setting. Each fallback step (best chest, any matching chest, [Overflow] or empty chests) lasts as long as walking to the farthest chest it tries takes, 30 seconds or more, so a bigger search-distance gets longer steps automatically. A step with nothing new to try is skipped, so an item with no home in range is put back after the 30-second vanilla step instead of after two minutes. matching-chest-timeout-seconds is gone: it’s taken out of config.yml on upgrade, and the console says why.
Adding or changing a sign or item frame label clears the “no home” marks on chests within search-distance, so golems try those items again straight away instead of after homeless-retry-minutes.
max-golems-outside-claims is gone, and golems on unclaimed land are no longer limited. It shared one limit among all the unclaimed land in a world, oldest golems first, so one player’s golems could leave another player’s, far away, sorting like vanilla without them being told why; and since only loaded golems count, golems switched between the two as players came and went. It’s taken out of config.yml on upgrade, and the console says why. max-golems-per-claim is unchanged.
Console messages about bringing config.yml up to date link to that version’s config.yml on GitHub instead of pointing into the jar.
A performance test tool, tools/perf (see its README): it measures how much server time golems cost, with the plugin off and at each search-distance, and compares versions. It is for developers and changes nothing in the plugin.
Built against the newest Paper API (26.3 build 238), and every build now also checks that the plugin compiles against build 190’s API, so it keeps running on every build from 190 on, as the requirements say.
Fixed
Golems look for lava cauldrons as far out as for furnaces and chests: search-distance sideways and 8 blocks up or down. Before, it was always 16 sideways and 4 up or down, so with search-distance 64 a golem tended a furnace 50 blocks away but never filled its bucket at a cauldron 20 blocks away. Instead of reading every block, each chunk is first asked whether it has a cauldron at all, and only chunks that do are scanned; the result is kept for 5 seconds, so a cauldron placed just now is used within 5 seconds.
A golem on a furnace job no longer has its item put back in a copper chest partway through a long walk. An empty bucket on its way to a far cauldron, or fuel to a far furnace, has no chest of its own, and after the 30-second steps of looking for one the golem returned it and started over.
Golems on furnace jobs no longer use a furnace, [Fuel], [Furnace Supply] or cauldron through a wall or floor. A golem counted as there once it was within 2.5 blocks in a straight line, whatever was in between, so a golem held up behind a wall, or one a floor above, could take or put items through it. It now has to be beside the block with open space to it, as for chests.
With deliver-reach above 3, golems now feed furnaces (and use [Fuel] and [Furnace Supply] containers) in rows 4 to 6. They walked to the foot of the stack, couldn’t reach the block from there, and gave up.
With furnace-jobs-before-sorting low (1 especially) and a copper chest that keeps getting items, golems stopped tending furnaces almost entirely. While vanilla walked a golem over to sort, the plugin saw it as idle and gave it a furnace job; the golem then picked up its load at the copper chest, which silently ended that job. A golem let go to sort now gets no furnace job until it has picked up its load (or 15 seconds pass).
A golem that goes over max-golems-per-claim now drops the plugin’s path settings straight away (the longer paths for search-distance, and avoid-trapdoors), and gets them back when it’s under the limit again. Before, the change waited for the next reload or for the golem’s chunk to load again.
A golem walking to an [Overflow] chest to fetch an item now checks on the way that the item still has a home. If that chest filled up, was removed or relabelled, the golem stops without taking anything, instead of carrying the items straight back.
With deliver-reach or take-reach raised, the top row of a wall of chests built against a hillside or another wall never got its items: they went to [Overflow]. The ground behind the wall, level with the top chests, counted as a place to stand, so those chests looked reachable the vanilla way, and vanilla golems can’t open them from the floor in front. Now only a spot a golem can walk to counts, and the golem is sent to that spot. /cgc check on such a chest now says that golems can’t walk to the spot level with it, and how many rows up it is from the floor they use (before, it said nothing was wrong).
Platforms
Paper
26.3