Copper golems follow chest signs or put like with like, and keep your furnaces fuelled and fed. Golems Union approved.
Changelog
All versions are for Paper 26.3 (Java 25). 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, and new settings use their defaults until you add them.
2.6.0 (2026-10-30)
New
/cgc golemsfinds your copper golems: the 10 nearest (or every one withall), each with its position (admins can click to teleport), distance and direction, what it's carrying, its copper and its mode. Golems in unloaded chunks are listed where they were last seen.- Lost golems find their way home: a golem remembers the copper chest it last took items from, and if it ends up far from any copper chest (more than 40 blocks, or 12 up or down) it walks back. A golem that can't, or is stuck in a pit, is reported to its owner with an alert. Teleporting it home is off by default (
lost-golem-teleport-home) and also needs the claim owner to havecoppergolemclerk.teleport./cgc golemsshows lost golems. Turn it off withrescue-lost-golems: false. - Full-chest alerts: when a golem finds the chest labelled for its item full, or an
[Overflow]chest is full or 90% full (overflow-alert-percent), the owner of the GriefPrevention claim is told (when they join, if they're offline); elsewhere, players withcoppergolemclerk.alerts(ops by default). Alerts are logged and not repeated foralert-cooldown-minutes(30). Turn them off withfull-chest-alerts: false. - Golems stay out of portals (
avoid-portals, on by default): a copper golem never goes through a Nether portal, End portal or End gateway, so one that wanders into a portal stays in its own world. Golems on a lead or riding go through as usual. - Copper chest filters: an
[Only ...]sign on a copper chest ([Only Logs],[Only Oak Log],[Only #planks]) makes golems take only those items out of it and leave the rest. Several[Only ...]lines add up./cgc checkshows the filter. - Status labels: while you hold bamboo, copper golems near you show what they're doing (
carrying 12 birch log,fetching granite,lost, walking home,idle...) and how weathered their copper is. Only players holding bamboo see them. Turn them off withstatus-labels: false. /cgc stats: how many items golems have sorted today, this week and all time: in your own claims for players, and for admins the whole server, the most-sorted items and the busiest claims. Players are told when they join what golems sorted in their claims while they were away, and how many of their chests filled up (join-summary).- Barrels and shulker boxes:
destination-containers(default[chest, trapped_chest], as in vanilla) can addbarrelandshulker_box. Golems then use them like chests (labels, contents,[Overflow]); the golem walks up and the plugin puts the item in. Leavingchestout keeps golems away from plain chests. - Bigger loads:
carry-amount(1 to 64, default 16 as in vanilla) sets how many items a golem carries per trip. After a golem takes items from a copper chest it takes more of the same from that chest (or puts some back, below 16); overflow fetches take that many too. /cgc find <item>: which containers near you hold an item (or a group, pattern or tag), nearest first, counting items in shulker boxes; the nearest 5 glow for you for 10 seconds (find-highlight-count,find-highlight-seconds). By default it only looks in GriefPrevention claims you own (find-outside-own-claimswidens it to unclaimed containers and claims where you have container trust). Players can search once every 2 seconds.find-enabled,find-radius(32).- Players can use
/cgc check,/cgc overflowand/cgc stats(permissionscoppergolemclerk.check/.overflow/.stats, everyone by default), limited to containers they could open and their own claims;/cgc golemstoo, for their own golems, ifgolems-command-for-playersis on (off by default).coppergolemclerk.allclaims(op) sees into every claim. - Golem limits:
max-golems-per-claimandmax-golems-outside-claims(per world) cap how many copper golems use the plugin; the oldest keep it, the newest over the limit sort like vanilla, and the claim owner is told. Off (0) by default. Load testing (up to 200 golems) found each working golem costs about 0.1 ms per tick with or without the plugin; the README's Golem limits section has the numbers.
Changed
- Documentation: the README now starts with what the plugin does (golem limits included), has a feature overview, a full settings reference (every setting with its default and what it does) and a permissions table;
docs/hangar.mdis the plugin page text for Hangar (no overstated features, an invitation to suggest ideas); theconfig.ymlheader andplugin.ymldescription describe the plugin instead of vanilla golems.
Fixed
- Golems on the floor above an
[Overflow]chest never fetched from it: they were sent to the chest block itself, and the pathfinder stopped them on the floor right above the chest instead of finding the way round by the stairs. Golems now walk to a spot beside the chest they have a whole path to, and skip an overflow chest they can't get to.
2.5.1 (2026-10-28)
Changed
- The green antenna light shows only to players holding the toggle item (bamboo). Golems look normal the rest of the time.
2.5.0 (2026-10-28)
New
Taller stacks of chests:
deliver-reachandtake-reach(default 2, vanilla's limit; up to 6) set how many chest rows up golems put items in and take items out. For chests above row 2 the golem walks to the foot of the stack and the plugin moves the items./cgc checksays how high a chest is and whether golems reach it.Switch a single golem back to vanilla: right-click it with bamboo (
golem-toggle-item), and again to switch it back. Golems using the plugin wear a small green light on their antenna (mode-markers). Needscoppergolemclerk.toggle(everyone by default) and, with GriefPrevention, permission to build where the golem stands.Golems say hello: an idle copper golem walks over to a nearby iron or snow golem, waves, and goes back to its routine, then waits
greet-cooldown-minutes(default 5) before greeting again (greet-other-golems, on by default).
Changed
- The plugin checks explicitly that a golem is a copper golem before doing anything with it, so iron and snow golems (or any other mob) are never affected.
2.4.1 (2026-10-28)
New
- Golem deaths are logged (
log-golem-deaths, on by default): when a copper golem dies, the server log says where, why (lava, a fall, a mob and which one,/kill...) and what it was holding. A golem turning into a statue, or removed by a plugin or command, is logged too.
2.4.0 (2026-10-27)
New
- Update notices: once a week the plugin checks GitHub for a newer release for your Minecraft version. A new one is logged, and admins are told when they join (once per release) with a link. Nothing is downloaded. Turn it off with
update-check: false. /cgc versionshows the installed version and checks for a newer release right away.