Repository navigation
Releases
Copper Golem Clerk 3.2.0 (Paper 26.3)
Groups can have other names, golems take finished items out of furnaces before they go back to sorting, and /cgc check and /cgc label now tell you when a more specific chest will win an item. /cgc find and /cgc golems take a search radius, golems only greet near their work, and a golem's home is now wherever it last got work, so lost golems also find their way back to furnaces and [Overflow] chests. The default groups are tidier, and chest lids open when golems use them.
New
- Groups can have other names. Add them under
group-aliasesinconfig.yml, asalias: group(for examplemechanisms: redstone) oralias: [group, group]. A sign,[Only ...]filter or/cgc findwith an alias means that group. A group's own name always wins, and the console warns about aliases it can't use. Empty by default. Upgrading addsgroup-aliases: {}. /cgc find <item> [radius]and/cgc golems [radius]take an optional search radius. From the console, use/cgc find <item> <x> <y> <z> [world] [radius]and/cgc golems <x> <y> <z> [world] [radius]./cgc find birch log 50looks 50 blocks around you. It searches loaded chunks only, and says how many chunks in range weren't loaded./cgc golems 50lists the golems within 50 blocks, nearest first. Like find, it counts along each axis. The header says "within 50 blocks".- A number that ends an item's name is part of it.
/cgc find music disc 13is the disc./cgc find music disc 13 50is the disc within 50 blocks. - Without a radius, both work as before. No radius can go past 30,000,000.
find-max-radius(default 64, 1 to 128) is the most a player can ask/cgc findfor. A larger number is cut down to it, with a note. It never counts as less thanfind-radius. Ops (coppergolemclerk.allclaims) and the console aren't limited./cgc golemsisn't limited either./cgc checkand/cgc labelnow say when golems would take an item to a more specific chest. The rule is unchanged: the sign label covering the fewest items wins, so[ingots and gems]beats[*copper*]for a copper ingot. Now the commands tell you./cgc checkwith an item in hand says which chest wins, where it is, and to add[copper ingot]to this chest's sign to keep the item here. If that chest is labelled for exactly the item, it says to take it off that label./cgc label, and the label advice at the end of/cgc check, list the items in the chest that go to a more specific chest. They show 5 lines at most, then "... and N more". For an unlabelled chest they check the label they suggest.- Nearby means within
search-distancesideways and 8 blocks up or down. Locked, blocked, full and hopper-fed chests don't count, as when golems choose.
Changed
-
Golems take finished items out of furnaces before they go back to sorting. Before, a golem sorted every copper chest first, so cooked items sat in the furnace while there was sorting to do. Taking items out is now part of furnace upkeep and counts toward
furnace-jobs-before-sorting, so a busy copper chest still gets sorted.furnace-take-out-atstill decides when a furnace is worth a trip. -
A golem's home is now the last place it got work from, not only the last copper chest it took from. Lost-golem rescue uses it.
- Home is the copper chest it took items from, the
[Overflow]chest it fetched from, the[Furnace Supply]or[Fuel]container it took from, or the furnace it took finished items (or an empty lava bucket) out of. Chests it only delivers into never become home. - A golem is lost when no work place (copper chest, furnace, smoker, blast furnace,
[Overflow],[Fuel]or[Furnace Supply]container) is in its range and its home is more than 40 blocks away (12 up or down). Alerts name the home ("its furnace", "its [Overflow] chest"). Copper chests still read "its copper chest". - If the home stops being a work place (broken, sign removed), the golem forgets it.
- A golem with no home takes the nearest work place in its range as home. With none in range it walks to the nearest one within 64 blocks (12 up or down). With none within 64 blocks it's left alone, like vanilla, until there is one.
- Home is the copper chest it took items from, the
-
Greeting visits stay near the golem's work. An idle copper golem only visits an iron or snow golem within 16 blocks of its home (if that is within
search-distance), else of its nearest copper chest or furnace, else of where it stands. It turns back if it gets more than 20 blocks from there.- It gives up if it can't get within reach in 20 seconds, if it gets no closer for 8 seconds, if the other golem can no longer be reached, or if that golem dies or disappears. Work turning up still ends a visit at once.
- A visit that ends without a hello walks the golem back to the spot beside its copper chest or furnace, for up to 15 seconds. It stops if work turns up.
- With
debug: true, every visit that ends without a hello is logged with the reason ("stopped going to say hello: ...").
-
Golems now open a chest, barrel or shulker box lid briefly whenever the plugin moves items for them. This covers:
- fetching from an
[Overflow]chest - taking from or putting into a
[Fuel]or[Furnace Supply]container - putting an item with no home back in its copper chest
- taking more from a copper chest for
carry-amount, as vanilla golems do
Before, the items just moved with a pickup sound and the lid stayed shut, so it looked as if nothing had touched the chest. Closing a lid never loads a chunk.
- fetching from an
-
Default groups cleaned up:
decorationsis split intosigns,banners(and banner patterns),pottery(sherds and the decorated pot) andbeds.decorationskeeps shelves, cushions, copper golem statues, item frames, the painting, armor stand, bookshelves and the flower pot.- Mob heads and skulls moved to
rare-items. utility-blocksis merged intoworkstations(22 items).- Cherry leaves, flowering azalea leaves and the mangrove propagule moved from
flowerstofoliage. - The chorus flower moved from
flowerstoend. - The name tag moved from
toolstoanimal-gear. stone(81 items) is split intostone(47),deepslate(20) andtuff(14), so each fits in a double chest.- A
[deepslate]sign now means the deepslate group without the deepslate ores. Before, it took every item with deepslate in its name. - Creative-only items are in no group now: budding amethyst, infested cobblestone and mossy stone bricks, the command block minecart, the knowledge book, and the copper, iron and snow golem spawn eggs.
- Existing servers keep their groups. Upgrading doesn't rewrite
groups:, so copy the new ones from the defaultconfig.ymlif you want them. [utility blocks]still works on a fresh config (it findsworkstations).[workstations]works on an older config.
-
Built against the newest Paper API (26.3 build 244). It still runs on build 190 and later.
Fixed
- Golems leave a furnace's output alone when a hopper minecart is under it, as they already did for a hopper. They check again when they reach the furnace, so a hopper placed while a golem was on its way is respected too.
Copper Golem Clerk 3.1.0 (Paper 26.3)
Golems now keep your furnaces going before they sort, can search farther for chests and furnaces, and give up on stuck walks sooner. Sign labels can run over more than one line, /cgc check suggests labels, and bigger claims can get more golems. This release also fixes several furnace-job bugs and one problem with tall chest walls.
New
- Furnaces come first. An idle golem now tends furnaces (stopped furnaces, empty buckets, fuel, items to cook from a
[Furnace Supply]) before it sorts copper chests. Before, sorting came first.furnace-jobs-before-sorting(default 3) sets how many furnace jobs in a row a golem does while a copper chest has items. Set it to 0 for the old order. - Longer sign labels. If a label is too wide for one line, leave the
[open and close it with]on a later line:[Only light/sources]is[Only light sources]. Lines are joined with a space, or with nothing after a-or_./cgc checkpoints out a label that is never closed. search-distance(default 32, up to 128): how far golems look for chests, copper chests,[Overflow]chests and furnaces. Above 32, golems walk to chests that vanilla golems can't see, and longer walks get more time.claim-blocks-per-extra-golem(default 0, off): bigger claims get more golems. Each claim gets one more golem thanmax-golems-per-claimfor every this many claim blocks. With 5 and 2500, a 9x9 claim gets 5 golems and a 100x100 claim gets 9./cgc checknow ends with sign-label advice, like/cgc label. For an unlabelled chest it suggests labels for what is in it. For a labelled chest it shows anything the label doesn't cover. For an empty chest it suggests labels for the item in your hand./cgc labelon a labelled chest now also suggests a label for what its label doesn't cover.- The README lists the default groups, with their sign labels and what is in them.
Changed
- Four default groups have shorter names so their labels fit on one line:
smithing-templatesis nowtemplates,crafting-materialsis nowmaterials,saplings-and-leavesis nowfoliage, andconcrete-and-terracottais split intoconcreteandterracotta. Old and new names both work on signs. Upgrading doesn't change yourgroups:. - A
[Terracotta]sign now also takes glazed terracotta. Concrete and terracotta are no longer the same group when golems match a chest by its contents. - Walks the plugin sends golems on no longer stop after a fixed 30 seconds. A golem gives up when it has gone 10 seconds without getting a block closer. Slow golems (Slowness, soul sand, crowds) now get there. A ceiling that grows with
search-distanceends any walk that never arrives. - How long a golem keeps trying to deliver an item now comes from the walk, not a setting. An item with no home in range is put back after about 30 seconds instead of two minutes.
- Adding or changing a sign or item frame label clears the "no home" marks on chests within
search-distance. Golems try those items again straight away. max-golems-outside-claimsis gone. Golems on unclaimed land are no longer limited. The old limit was shared by all unclaimed land in a world, so one player's golems could stop sorting because of another player's.max-golems-per-claimis unchanged./cgc checkon an[Overflow]chest now points to/cgc overflow. The range in/cgc overflowand/cgc storagefollowssearch-distance.- Console messages about updating
config.ymllink to that version'sconfig.ymlon GitHub. - Built against Paper API 26.3 build 238. Builds also check that the plugin compiles against build 190, so it still runs on every build from 190.
Fixed
- Golems now look for lava cauldrons as far as they look for furnaces:
search-distancesideways and 8 blocks up or down. Before, it was 16 sideways and 4 up or down. - A golem on a furnace job no longer has its item put back in a copper chest partway through a long walk.
- Golems no longer use a furnace,
[Fuel],[Furnace Supply]or cauldron through a wall or floor. They now have to stand beside it with open space, as for chests. - With
deliver-reachabove 3, golems now feed furnaces and use[Fuel]and[Furnace Supply]containers in rows 4 to 6. - With
furnace-jobs-before-sortinglow (1 especially) and a copper chest that keeps getting items, golems no longer stop tending furnaces. - A golem that goes over
max-golems-per-claimnow drops the plugin's path settings straight away, and gets them back when it is under the limit again. - A golem walking to an
[Overflow]chest now checks on the way that the item still has a home. If the chest filled up, was removed or was relabelled, the golem stops instead of carrying the items back. - With
deliver-reachortake-reachraised, the top row of a wall of chests built against a hillside or another wall now gets its items instead of sending them to[Overflow]./cgc checkon such a chest now says when golems can't walk to the spot level with it.
Upgrading
- Replace the jar in
plugins/and restart. config.ymlis brought up to date automatically. New settings are added with their explanations, and your values are kept.max-golems-outside-claimsandmatching-chest-timeout-secondsare removed fromconfig.ymlon upgrade. The console says why.- Needs Paper 26.3 build 190 or newer, and Java 25.
Copper Golem Clerk 3.0.0: The Furnaces Are Alive (Paper 26.3)
A major release, "The Furnaces Are Alive": golems now run your furnaces (feeding, fueling and emptying them), and your config.yml is kept up to date with every new setting and its explanation when you upgrade.
New
- Upgrading brings your
config.ymlup to date: at startup, any setting the new version has that your file doesn't is added, with its default and the comment that explains it, in the same place as in a fresh config, and the comment above every setting you already have is replaced with the new version's explanation. Your values are never changed, and a note at the end of a setting's line stays; the old file is kept asconfig-before-<version>.yml, and the console lists what was added and which explanations changed. Aconfig.ymlwith a YAML error is left alone, and one that can't be written gets a clear console warning (new settings then use their defaults). [Overflow]chests that a hopper fills (a smelter's output chest): golems fetch an item from them only once 8 of it have built up (overflow-fetch-min) or it has waited 2 minutes (overflow-fetch-wait-seconds), instead of walking over for every ingot the hopper drops in. Overflow chests no hopper feeds are emptied right away, as before./cgc overflowsays when a hopper fills the chest.- Every setting in
config.ymlnow has its own explanation right above it (settings that used to share one, like thefind-*andmax-golems-*settings, got their own), so a setting added on upgrade always comes with its comment. - Golems run your furnaces (
furnace-feeding, on by default): label a furnace, smoker or blast furnace like a chest ([raw iron]) and golems keep it going. Items to cook come only from[Furnace Supply]containers, and each load is split between all the labelled furnaces that take it. Golems take only as much as the furnaces have room for, top a furnace up once it's running low (furnace-refill-below, default 16), split a load between at most 2 furnaces, and only into shares of at least 8 (furnace-split-min, emptiest furnaces first), never bring a load or fuel to a furnace another golem is already handling, wait for room at a furnace that filled up meanwhile (furnace-wait-seconds, default 20) and put anything left back in the supply instead of sorting it away. Fuel comes only from[Fuel](or[Fuels]) containers (furnace-fuel, default charcoal, coal, then lava buckets, used only for a furnace with a backlog of 100 or more items (waiting, on the way, and its share of the matching[Furnace Supply]items) if another fuel is there (furnace-lava-min-items), since a bucket lasts 100 items and a lit furnace burns it out even with nothing to cook, and whose empty buckets are refilled at a lava cauldron; with a cauldron that dripping lava refills, empty buckets wait in a[Fuel]container until it's full, and an idle golem then fills one and puts it back), enough for what's waiting plus 16 more items (furnace-fuel-ahead) so the next load needs no fuel trip of its own; fuel a golem couldn't put in goes back to a[Fuel]container. Golems take out what's done once 8 are ready (furnace-take-out-at) or the furnace has stopped (including when something left in its output slot keeps it from lighting), and sort it, unless a hopper under the furnace collects it or nothing in range would take it. Urgent jobs come first: a full output slot, fuel, then items to cook, then taking out finished items. A golem that can't find a path to a furnace or container right now tries again after 10 seconds (one that walks there for 30 seconds without arriving waits a minute). A chest sitting on a hopper that leads into a furnace (a hand-built smelter) is never used for sorting. With GriefPrevention, golems use only furnaces and containers in their copper chest's claim, or where its owner has container trust (furnace-trusted-claims)./cgc checkon a furnace explains what golems will do and why. Sign spellings (any case):[Fuel],[Fuels];[Furnace Supply],[Furnace Supplies],[Furnaces Supply], and the words may be joined by a dash or underscore ([Furnace-Supply]). /cgc label: suggests a sign label for the chest you're looking at, from what's in it (the item's own label, the most specific group its items share, or the group most of them fit and which items don't); on a labelled chest it says whether everything matches. It only suggests; you place the sign. Players get suggestions for containers they could open (coppergolemclerk.label, everyone by default)./cgc storage: how full the storage around you is, by label (or by contents for unlabelled chests), fullest first, with full and nearly full ones flagged, plus[Overflow]chests, empty chests left and items waiting in copper chests. Players see only containers they could open (coppergolemclerk.storage, everyone by default).
Changed
- Golems fetching from an
[Overflow]chest take up tocarry-amountof an item across several stacks; they used to take only the first stack (3 of 3 + 5 ingots, for example). config.ymland the README explaindebug(every decision the plugin logs, and that it changes nothing golems do) andtrace-golems(how often it logs) in full.- The build checks that every setting is documented: in
config.ymlwith its own comment (so upgrades add it with its explanation), in the README settings reference and, for settings new since this changelog started, in the CHANGELOG. "Adding a setting" in the README lists the steps. - Documentation explains what
*(any letters in the item's name:[*sand],[sand*],[*]for everything),#(a Minecraft item tag:[#logs]) and@([@fuel]) do on a sign, with examples, including that[*]on a chest is picked before[Overflow]. - The Hangar page text moved from
docs/hangar.mdtodocs/FullDescription.md. - Hangar page: an icon for every section, and a pixel-art copper golem (
docs/copper-golem.png) beside the title.
Fixed
max-golems-per-claimis now counted for each claim on its own, as documented. It used to add up all the claims of one owner, and golems in admin claims counted as unclaimed land (max-golems-outside-claims); admin claims now have their own limit too./cgc golemsno longer lists a golem that was killed just before its chunk unloaded (for example/killand then everyone leaving) as "not loaded". It used to stay in the list, and ingolems.yml, for 30 days.
Copper Golem Clerk 2.6.2 (Paper 26.3)
Changed
/cgc find torchfinds only torches, as before, but now adds an "Also nearby" line naming other items near you with the word in their name (copper torch, soul torch...) and suggests/cgc find *torch*to find them all (/cgc help find, README and Hangar page say so too). Searches that already match by name, patterns, tags and groups that cover them get no hint.- README and Hangar page: the "For players" lists give every player command a line of its own (
find,check,overflow,stats,golemswhere allowed,help); the README gets a "For admins" list like the Hangar page's; both say what the load test found (about 0.1 ms per golem per tick, as in vanilla).
Fixed
- The "While you were away, golems sorted N items" message counted items sorted while you were still online. It used the whole hour you left in, and a server stop or restart never noted you leaving at all (Paper disconnects players after plugins stop), so the next join counted everything since your last real logoff. It now notes the running count when you leave or the server stops, and reports only what was sorted after that. Players last seen under an older version get no count on their next join, rather than a wrong one.
Copper Golem Clerk 2.6.1 (Paper 26.3)
Fixed
- On a Paper 26.3 build older than 190 (before Paper added the golem sorting event), the plugin now logs that it needs build 190 or newer and turns itself off. Before, it stayed on with its sorting missing (Paper logged "Failed to register events for class SortListener" and golems sorted like vanilla) while its other features kept running.
Changed
- README, Hangar page and CHANGELOG say which Paper build is needed: 26.3 build 190 or newer.
Copper Golem Clerk 2.6.0 (Paper 26.3)
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.
Copper Golem Clerk 2.5.1 (Paper 26.3)
Changed
- The green antenna light shows only to players holding the toggle item (bamboo). Golems look normal the rest of the time.
Copper Golem Clerk 2.5.0 (Paper 26.3)
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.
Copper Golem Clerk 2.4.1 (Paper 26.3)
Golem deaths are logged.
Upgrading
Replace CopperGolemClerk-2.4.0.jar in plugins/ with CopperGolemClerk-2.4.1.jar and restart. No config changes needed: the new option is on by default.
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.
Copper Golem Clerk 2.4.0 (Paper 26.3)
Update notices.
Upgrading
Replace CopperGolemClerk-2.3.0.jar in plugins/ with CopperGolemClerk-2.4.0.jar and restart. No config changes needed: the new option is on by default.
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.