Welcome to the Hangar Open Beta. Please report any issue you encounter on GitHub!
Avatar for mhardin18

Copper golems follow chest signs or put like with like, and keep your furnaces fuelled and fed. Golems Union approved.

Report CopperGolemClerk?

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 golems finds your copper golems: the 10 nearest (or every one with all), 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 have coppergolemclerk.teleport. /cgc golems shows lost golems. Turn it off with rescue-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 with coppergolemclerk.alerts (ops by default). Alerts are logged and not repeated for alert-cooldown-minutes (30). Turn them off with full-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 check shows 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 with status-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 add barrel and shulker_box. Golems then use them like chests (labels, contents, [Overflow]); the golem walks up and the plugin puts the item in. Leaving chest out 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-claims widens 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 overflow and /cgc stats (permissions coppergolemclerk.check/.overflow/.stats, everyone by default), limited to containers they could open and their own claims; /cgc golems too, for their own golems, if golems-command-for-players is on (off by default). coppergolemclerk.allclaims (op) sees into every claim.
  • Golem limits: max-golems-per-claim and max-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.md is the plugin page text for Hangar (no overstated features, an invitation to suggest ideas); the config.yml header and plugin.yml description 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-reach and take-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 check says 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). Needs coppergolemclerk.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 version shows the installed version and checks for a newer release right away.

Information

Published
October 30, 2026
Author
0Downloads

Platforms

Paper
Paper
26.3