Skip to content

Releases

Copper Golem Clerk 3.2.0 (Paper 26.3)

Choose a tag to compare

@mhardin18 mhardin18 released this 11 Nov 04:13
3ff711c

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-aliases in config.yml, as alias: group (for example mechanisms: redstone) or alias: [group, group]. A sign, [Only ...] filter or /cgc find with 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 adds group-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 50 looks 50 blocks around you. It searches loaded chunks only, and says how many chunks in range weren't loaded.
    • /cgc golems 50 lists 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 13 is the disc. /cgc find music disc 13 50 is 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 find for. A larger number is cut down to it, with a note. It never counts as less than find-radius. Ops (coppergolemclerk.allclaims) and the console aren't limited. /cgc golems isn't limited either.
  • /cgc check and /cgc label now 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 check with 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-distance sideways 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-at still 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.
  • 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.

  • Default groups cleaned up:

    • decorations is split into signs, banners (and banner patterns), pottery (sherds and the decorated pot) and beds.
    • decorations keeps 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-blocks is merged into workstations (22 items).
    • Cherry leaves, flowering azalea leaves and the mangrove propagule moved from flowers to foliage.
    • The chorus flower moved from flowers to end.
    • The name tag moved from tools to animal-gear.
    • stone (81 items) is split into stone (47), deepslate (20) and tuff (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 default config.yml if you want them.
    • [utility blocks] still works on a fresh config (it finds workstations). [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)

Choose a tag to compare

@mhardin18 mhardin18 released this 05 Nov 21:37
c00601b

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 check points 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 than max-golems-per-claim for every this many claim blocks. With 5 and 2500, a 9x9 claim gets 5 golems and a 100x100 claim gets 9.
  • /cgc check now 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 label on 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-templates is now templates, crafting-materials is now materials, saplings-and-leaves is now foliage, and concrete-and-terracotta is split into concrete and terracotta. Old and new names both work on signs. Upgrading doesn't change your groups:.
  • 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-distance ends 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-claims is 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-claim is unchanged.
  • /cgc check on an [Overflow] chest now points to /cgc overflow. The range in /cgc overflow and /cgc storage follows search-distance.
  • Console messages about updating config.yml link to that version's config.yml on 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-distance sideways 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-reach above 3, golems now feed furnaces and use [Fuel] and [Furnace Supply] containers in rows 4 to 6.
  • With furnace-jobs-before-sorting low (1 especially) and a copper chest that keeps getting items, golems no longer stop tending furnaces.
  • A golem that goes over max-golems-per-claim now 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-reach or take-reach raised, 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 check on 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.yml is brought up to date automatically. New settings are added with their explanations, and your values are kept.
  • max-golems-outside-claims and matching-chest-timeout-seconds are removed from config.yml on 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)

Choose a tag to compare

@mhardin18 mhardin18 released this 02 Nov 19:09
55ac2f1

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.yml up 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 as config-before-<version>.yml, and the console lists what was added and which explanations changed. A config.yml with 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 overflow says when a hopper fills the chest.
  • Every setting in config.yml now has its own explanation right above it (settings that used to share one, like the find-* and max-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 check on 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 to carry-amount of an item across several stacks; they used to take only the first stack (3 of 3 + 5 ingots, for example).
  • config.yml and the README explain debug (every decision the plugin logs, and that it changes nothing golems do) and trace-golems (how often it logs) in full.
  • The build checks that every setting is documented: in config.yml with 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.md to docs/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-claim is 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 golems no longer lists a golem that was killed just before its chunk unloaded (for example /kill and then everyone leaving) as "not loaded". It used to stay in the list, and in golems.yml, for 30 days.

Copper Golem Clerk 2.6.2 (Paper 26.3)

Choose a tag to compare

@mhardin18 mhardin18 released this 01 Nov 14:38
77e487e

Changed

  • /cgc find torch finds 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, golems where 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)

Choose a tag to compare

@mhardin18 mhardin18 released this 30 Oct 19:34
07430ca

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)

Choose a tag to compare

@mhardin18 mhardin18 released this 30 Oct 18:44
1c0628b

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.

Copper Golem Clerk 2.5.1 (Paper 26.3)

Choose a tag to compare

@mhardin18 mhardin18 released this 29 Oct 02:07
9910142

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)

Choose a tag to compare

@mhardin18 mhardin18 released this 28 Oct 18:48
81a9bbd

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.

Copper Golem Clerk 2.4.1 (Paper 26.3)

Choose a tag to compare

@mhardin18 mhardin18 released this 28 Oct 05:11
884e5d7

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)

Choose a tag to compare

@mhardin18 mhardin18 released this 28 Oct 03:36
5fb8396

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 version shows the installed version and checks for a newer release right away.