SANDBOX — this is a test environment. No servers are actually deployed and no real payments are charged.
Source-checkedWeapons, items & crafting

CopperGolemClerk

by mhardin18 · for Minecraft

A Paper plugin that makes copper golems sort similar items together, not just identical ones.

2Downloads
26d agoLast updated
GPLLicense
PaperLoaders

About CopperGolemClerk

From Hangar

A Paper plugin that makes copper golems sort similar items together, not just identical ones.

Copper Golem Clerk

A Paper plugin that makes copper golems sort similar items together, not just identical ones.

Vanilla golems only put an item into a chest that already holds that exact item, or into an empty chest. With this plugin, a golem carrying birch logs will also use a chest that holds oak logs. A golem carrying a diamond pickaxe will use a chest of tools, and so on.

Requirements

  • A Paper server, version 26.3
  • Java 25

Spigot and Bukkit aren't supported: the plugin uses Paper-only golem events.

Install

  1. Download SmartCopperGolems-<version>.jar from the

latest release. Release tags name the Paper version they're for (e.g. v1.0.0-paper26.3).

  1. Put the jar in your server's plugins/ folder.
  2. Restart the server (don't use /reload).
  3. Check the console for Enabling SmartCopperGolems, or run /plugins in game.

On first start the plugin creates plugins/SmartCopperGolems/config.yml. The defaults work as-is: about 50 groups that cover every survival item. After editing the file, run /sg reload to apply it without a restart.

To update, replace the old jar with the new one and restart. Your config.yml is kept. To uninstall, delete the jar (and the plugins/SmartCopperGolems/ folder if you don't want to keep the config).

Quick start

  1. Place a copper chest and fill it with mixed items.
  2. Place a few chests nearby (within 32 blocks sideways, 8 up or down). Put one

item in each to say what goes there, or label it with a sign like [logs] or an item frame.

  1. Build a copper golem (a carved pumpkin on top of a copper block) next to the

copper chest.

  1. Stay nearby: golems only work in loaded chunks, and Paper slows them down

when no player is close.

The golem now puts birch logs in your oak log chest, a diamond pickaxe in your tools chest, and so on.

How it works

Paper fires ItemTransportingEntitySortEvent whenever a golem checks whether its item belongs in a chest. The plugin answers "yes" when the chest's items share a group with the carried item. Otherwise vanilla rules apply.

Groups are defined in config.yml using:

| Entry | Meaning | |-----------------|--------------------------------------------| | DIAMOND | one item | | *_ORE | name pattern | | #minecraft:logs | vanilla or datapack item tag | | @edible, @fuel, @record | item properties |

Smarter use of empty chests

Vanilla golems walk to the nearest chest they haven't tried and drop their item into the first empty chest they reach, often before finding the chest where it belongs. They also give up after trying 10 chests, so far-away chests never get used.

With prefer-matching-chests (on by default), a golem carrying an item first looks over every chest in its range: 32 blocks sideways and 8 up or down, in loaded chunks. If any chest matches the item (frame label, same item, or same group) and has room, the golem walks straight to it. Empty chests are used only when no matching chest has room. If the golem hasn't delivered within matching-chest-timeout-seconds (default 30), for example because the chest is walled off, it falls back to vanilla behavior for that item.

Item frame labels

Hang an item frame (or glow item frame) with an item in it on any side of a chest, and golems put only that exact item in that chest. A label overrides groups and the empty-chest rule. Several frames on one chest allow each framed item; empty frames are ignored. Turn this off with item-frame-labels: false.

Sign labels and overflow chests

Put a wall sign on any side of a chest (or a standing sign on top) with rules in square brackets, one per line:

| Line | Accepts | |-------------|---------------------------------| | [logs] | the logs group from the config | | [oak log] | that one item | | [*_ORE] | items matching the pattern | | [#planks] | items in that tag | | [Overflow]| anything with no other home |

Case doesn't matter and spaces count as underscores. A group name wins over an item with the same name, and group names work singular or plural ([Rail] = rails, [ore] = ores, [light source] = light-sources). If a word matches no group and no item, it matches items with that word in their name ([carpet] = every carpet). For one exact item that shares a group's name, use a framed item instead.

When several chests would take an item, golems use the most specific one. Labels (frames and signs) come before contents: a framed item first, then the sign label covering the fewest items, then a chest already holding that exact item, then a group match by contents. A stew goes to [stews] before [food], and a [logs] chest wins over an unlabelled chest that happens to hold birch logs. Frame and sign labels on one chest combine.

Where a golem takes an item, in order: a matching chest with room (label, same item or group), then an [Overflow] chest, then an empty chest (overflow-before-empty: false swaps the last two). Overflow chests never count as a match for what's already in them.

Items with no home

Read the full description on Hangar →

Highlights

From source data

Game versions

Built for Minecraft 26.3.

Loaders

Runs on Paper.

Footprint

Rated a light load on a server.

CopperGolemClerk on Nxeon

From our catalogue
One-click install
Supported on Nxeon Minecraft servers, for Paper servers. We download it from Hangar, place it, and restart the server.
Server side
Required on the server
Server type needed
Paper
Server load
light
Smallest plan we suggest
Minecraft — 1.5 GB (2 GB RAM). This follows our own load rating above, not a benchmark.
Latest build
2.1.0, released 2026-10-26

Game versions by loader

LoaderGame versionsNewest
Paper26.326.3

From 3 recorded builds of CopperGolemClerk.

Recent builds

BuildReleasedGame versionsLoaders
2.1.02026-10-2626.3Paper
1.3.02026-10-2526.3Paper
1.0.02026-10-2426.3Paper

Run CopperGolemClerk on a Minecraft server

Pick a server or deploy a new one above; it is installed in one click.

What kind of mod it is

From the catalog
Listed on Hangar as “Plugins”

Weapons, items & crafting

New weapons, gear, items and the recipes to make them.

Runs on your server

From source side support

Hangar lists CopperGolemClerk as required on the server. Check its Hangar page to see whether players need it too.

Compatibility

Game
Minecraft
Loaders
Paper
Runs on
Serverrequired on the server
Game versions
26.3
Requires
One-click install needs a Paper server.

Verified at the source

  • ✓HangarOfficial listing, checked 2026-10-27Open ↗
  • ✓Authormhardin18, as published on Hangar
  • ✓LicenseGPLFree

CopperGolemClerk, answered

Generated from the mod’s own source data.

Do my players need to install CopperGolemClerk?

Hangar lists CopperGolemClerk as required on the server. Check its Hangar page to see whether players need it too.

Which loaders does it support?

Paper.

Is it free?

Yes. CopperGolemClerk is free to download from Hangar. Its license is GPL.

How do I add it to my Nxeon server?

Use “Add to a server” on this page, or open NxLabs from your dashboard. We install it, restart your server and switch it on.

NxLabs

Run CopperGolemClerk on a Minecraft server.

Deploy in about a minute from $4.20 a month, then add CopperGolemClerk in one click.