Copper Golem Reforged

Configurable Paper plugin that adds diamond and netherite upgrades for copper golems. It lets upgraded golems sort items within a configurable area, use fallback copper chests when no matching storage is found, and be fully managed through admin command

Usage

Admin commands

• /cg reload — reload the plugin configuration

• /cg on — enable the plugin

• /cg off — disable the plugin

Permissions

coppergolem.admin - Allows managing CopperGolem Rethought

Upgrade behavior

Diamond upgrade

A copper golem becomes an upgraded diamond golem when a player uses a diamond on it. Diamond golems work within a configurable radius of 10 blocks on X and Z and 3 blocks on Y, and their default maximum carried stack size is 16.

Netherite upgrade

Netherite golems are available as a separate upgrade type and can be enabled or disabled independently in the configuration. They use black particle effects, work within a configurable radius of 40 blocks on X and Z and 5 blocks on Y, and their default maximum carried stack size is 32.

Sorting behavior

When an upgraded golem takes an item, it searches for chests within its configured area and chooses a chest that already contains the same item type

If no chest in range contains that item, the golem uses fallback behavior and returns the item to a copper chest. When doing so, it places the item into the last available slot from the end, or into a slot that already contains the same item.

• When fallback storage is needed and multiple copper chests are available in range, the golem prioritizes waxed oxidized copper chests first and oxidized copper chests after that. If no preferred chest is available, it can use the nearest suitable copper chest.

Configuration

Upgrade settings

Both upgrade types are configured under GolemUpgrades, where each one has its own block of settings. For each upgrade, you can configure whether it is enabled, which item is used to apply it, the effect color or null, and a custom name or null.

Behavior settings

The configuration also includes per-upgrade settings for radius, stack limit, cache refresh, movement tolerance, particles, interaction timings, fallback behavior, unreachable-target handling, and preferred copper chest order.