About CopperGolemClerk
From HangarA 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
- Download
SmartCopperGolems-<version>.jarfrom the
latest release. Release tags name the Paper version they're for (e.g. v1.0.0-paper26.3).
- Put the jar in your server's
plugins/folder. - Restart the server (don't use
/reload). - Check the console for
Enabling SmartCopperGolems, or run/pluginsin 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
- Place a copper chest and fill it with mixed items.
- 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.
- Build a copper golem (a carved pumpkin on top of a copper block) next to the
copper chest.
- 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
Highlights
From source dataGame 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
| Loader | Game versions | Newest |
|---|---|---|
| Paper | 26.3 | 26.3 |
From 3 recorded builds of CopperGolemClerk.
Recent builds
| Build | Released | Game versions | Loaders |
|---|---|---|---|
| 2.1.0 | 2026-10-26 | 26.3 | Paper |
| 1.3.0 | 2026-10-25 | 26.3 | Paper |
| 1.0.0 | 2026-10-24 | 26.3 | Paper |
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 catalogWeapons, items & crafting
New weapons, gear, items and the recipes to make them.
Runs on your server
From source side supportHangar 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










