Copper Golem Patch

Keeps vanilla Copper Golem behavior intact — it just makes them actually good at their job.

Vanilla Copper Golems forget everything the moment they look away. Every trip is trial and error: open a chest, check if the item fits, walk to the next one, repeat — sometimes for the same wrong chest, over and over. Copper Golem Patch fixes that without changing how golems are supposed to behave.

What it does

• 🧠 Persistent memory — each golem remembers which chest holds what, so it stops wasting trips on chests it already knows are wrong.

• 🤝 Swarm knowledge sharing — golems that wander close to each other share what they've learned, proximity-style. No global instant database, no magic — just golems passing knowledge along like a real swarm.

• 🪫 No more stuck golems — if a golem ends up holding an item that genuinely has nowhere to go, it puts it back in a copper chest and moves on, instead of wandering forever with a diamond in its hand.
• ✅ 100% vanilla matching rules — a chest counts as a valid drop-off if it's empty or already contains that item type anywhere inside it, exactly like vanilla — not just in the first slot.
• ⚙️ Fully configurable, with a config file written in plain English for non-technical server owners.
• 🪶 Built for performance — tuned and benchmarked so it doesn't add meaningful load next to your other plugins.

How it works

1. While vanilla AI evaluates candidate chests for a golem, the plugin observes their contents and remembers them.
2. On its next pass, the golem skips chests it already knows won't work — no detour, no 3-second examine animation wasted.
3. Golems passing near each other exchange what they've learned, so a golem doesn't need to have personally visited a chest to know about it.
4. An item that truly has nowhere to go gets returned to a copper chest and marked "unsortable for now" — shared with nearby golems too — until a spot frees up.

Performance

Benchmarked on a real Paper 26.1.2 server with /tick query, plugin enabled vs. disabled, at 5/10/50 and 100 simultaneous golems. After an internal caching pass, server impact at 100 golems sits within a few milliseconds of the plugin-disabled baseline — this plugin is built to run alongside everything else on your server, not compete with it.

Configuration

Every setting in config.yml ships with a plain-language explanation — no Minecraft-plugin-dev jargon required. Tweak the gossip radius, memory size, or give-up timing, or just leave the defaults; they work well out of the box.

Commands

Command	Description
/cgp info	Shows what the nearest golem currently remembers
/cgp reload	Reloads the config without restarting the server
/cgp toggle	Quickly enables/disables the plugin

Permission: coppergolempatch.admin (default: op)

Compatibility

• Paper 26.1.2
• No dependencies, no other plugins required
• Safe to disable at any time — golems fall back to pure vanilla behavior instantly

Source code

Open source — link in the sidebar. Issues and pull requests welcome.