!CuGO Title Image

Copper Golem Overcomplication

Trust me it's relatively simple to understand!

In this mod, the Copper Golems get a massive revamp. It has near-infinite memory, reconfigurable almost everything, and a couple new behaviors to make the lil guy a bit more interactive.

Utility Stuff

Wandering

When you first spawn your lil guy in, he won't go straight to work. He'll check his surroundings first! He'll wander about your base or storage facility. As it explores, a hidden "Wander Chance" decreases. The longer it wanders, the more likely it is to stop and take a break. If it gets stuck or can't find a path (if you put it in a maze), it will shrink its search radius to focus on more immediate possible pathing.

Lingering

When CuGO gets bored of wandering, it enters a Lingering State. It will begin to look around, standing still.

Pinging

The work begins. The reason for all this buildup is so it can ping the local area for storage containers. These can be:

• Chests
• Copper Chests
• Barrels (configurable)
• Shulker Boxes (configurable)

Home will be chosen of the Copper Chests it discovered. Nothing is truly special about this Copper Chest for now, but may be in the future.

Whenever it is not working, it will wander about, linger, then ping, making sure its internal map is always up to date, no matter what changes you make to the layout.

The Chest Monster

This is the big one. I made a memory and priority system for CuGO to follow.

Fetching

When the Golem decides it's time to work, it scans its known "Home" and nearby Copper Chests to find items to move.

• Persistent Memory: If it recently found items in a specific chest, it will remember that location and check it first in the next cycle.
• No place like Home: It will check the Home chest first, unless it knows for a fact there's items someplace else.
• The OG Stuff: I made sure to keep the vanilla golem sounds and animations. This should, in theory, make this mod compatible with FreshLX's Fresh Animations (I did not check this yet because I'm an incompetent mod dev 👀)
• Bulk or no Bulk, that is the question: Via config, you can define exactly how many items the Golem is allowed to carry at once. It can be the vanilla count of 16, the default count of 64, or as little as 1 at a time.

Sorting

Once CuGO has an item in its possession, its goal is to find the perfect place for it. I made the vanilla purity check a bit better.

• CuGO can handle the memories of the contents of Chests, Trapped Chests (better be careful how you wire these), Barrels, and Shulker Boxes.
• Every time CuGO opens a chest, it snapshots the contents into its memory (stored as NBT). The next time it needs to sort that specific item, it will march directly to the last place it saw it, or put it, before.
• Matching item in chest? Valid placement. Empty chest? Valid placement.

PANIC!

CuGO is a pro at the forbidden art of tactical cowardice. When the going gets tough, CuGO would rather let someone else deal with it. If that fails, it books it for the hills.

1. Once CuGO gets hit, he'll run directly away from the threat.
2. After a couple seconds, CuGO will remember he's not alone. Let's have someone bigger and stronger deal with this:

• Iron Golems
• Players (that didn't attack it)
• Snow Golems (it's... it's.)

3. Once a Guardian is found, CuGO becomes a genius at trigonometry, figuring out the best place to constantly be to keep behind the muscle between it and the attacker.
4. What about the merchandise? If CuGO has a Home set, its priorities shift. Its life doesn't matter, but the company's assets, and will book it toward Home and try to deposit what it has.

It will only calm down once the known threat is dead, gone, or safely over 16 blocks away.

Update requires restart.

Battery & Power Management

If enabled in the config, CuGO is powered by a finite battery.

• Active Seeking: When power drops below the warning threshold, the golem will pause its current task, mid-task, and seek out an active Redstone Signal.
• Precision Docking: The Golem will align itself perfectly with a redstone source to begin charging (this was so much harder than you think)
• Visual Feedback: You'll see redstone sparks as the Golem siphons power from the grid.
• Panic Drain: Be careful! Panicking is stressful on the hardware. if a Golem is running for its life, its battery will drain significantly faster.

Passive Siphoning

Golems are smart enough to recognize a redstone hot spot when they walk over one.

• If a Golem happens to walk over or stand near an active redstone source during its normal routine, it will passively gain a small amount of charge.
• Passive charging is slower than dedicated docking, but it's a great way to keep your "patrol" Goelms powered without them constantly needing to dock if you wire your room correctly.

Self Preservation

If you look good, you feel good. CuGO follows this to a T. Provide them with the right tools, and they will maintain themselves.

• If a Golem is holding Honeycomb, it will apply it to itself to prevent further oxidation
• If a Golem is holding an Axe, it will use it to scrape off oxidation if it is unwaxed.
• It won't ever use a tool if it is about to break, or able to be broken (configurable)

Weathering

The Copper Golem continues to follow the aging process, with a few tweaks.

• There is a clean, reliable, and random transition as it progresses through oxidation stages
• When a Golem fully oxidizes, it enters a shutdown sequence, clanking, trying to hold on, before turning into a Copper Golem Statue.

Statues

This is getting long. Statues can be recharged. And yes, this, too, is configurable.

• Rechargeable Statues: Depending on your config, if you give your statue a redstone signal, your lil guy will come back to the world of the living.
• Pose Shifting: Nothing really different here. If you have rechargeableStatues set to true, using an axe won't bring it back to life. Setting it to false does the vanilla thing.

Dev Logs

Turn debugMode on if you want to get spammed in chat and server logs, or if you need to debug. See what I see.

Configs

debugMode - Setting to true allows for your console to show debug messages. Helps to picture what is going on in CuGO's head.

redstoneBoost - Walking across Redstone Blocks gives CuGO speed.

rechargeableStatues - Setting to true allows you to reactivate statues back into a new CuGO. This currently does not save the original's NBT.

rechargeableGolems - When set to true, golems have a battery. If any part of them visibly touches or is next to a redstone signal, it will stand still and recharge when it is at 10%.

damageItemsOnUse - Setting to true allows the golem, when using an axe to scrape its oxidization, to use up the tool's durability.

barrelAsOutput - Barrels are a valid container to be sorted into if set to true

shulkerAsOutput - Shulker Boxes are valid containers to be sorted into if set to true

wanderRadius - Changes the max radius that CuGO searches while randomly wandering. Integer value.

wanderTime - Changes how long CuGO remains in the random wander state before being forced to go to FetchBehavior. Integer value in seconds.

lingerTime - Changes how long CuGO lingers before pinging. This is purely cosmetic. Integer value in seconds.

searchRadius - Searches a radius around it for containers and redstone sources. Integer value.

panicTime - This is the amount of time it takes for CuGO to calm down while CuGO is safe. this is paused if danger remains nearby. Integer value in seconds.

xzInteractRange - Probably should've named this horizInteractRange. It is the horizontal dimension of the box that CuGO checks when deciding whether it is in range of a chest to open it. Double (decimal) value.

yInteractRange - Probably should've named this vertInteractRange. It is the vertical dimension of the box that CuGO checks when deciding whether it is in range of a chest to open it. Double (decimal) value.

maxStackSize - The max stack size CuGO can hold at any one time. In vanilla, this is 32. In CuGO default configs, it is 64. Integer value.

batteryLife - The battery life of CuGO, used when rechargeableGolems is turned on. Integer value in minutes.

warningThreshold - When this amount of time is left, it begins searching for charge. Integer value in minutes. Keeping this approximately 10% of the batteryLife seems healthiest.

batteryDrain - Each tick, this decides how many charges are used. Integer value, charge per tick.

chargeTime - The amount of time it takes for CuGO to, hypothetically, go from 0% to 100%. Integer value in seconds.

passiveCharge - If true, CuGO can charge by casually walking through a valid charge location.

passiveChargeRateMultiplier - If passiveCharge is true, this affects the rate of that passive charge. Double (decimal) value.

consumeConsumables - If true, this will consume things like copper ingots when healing itself.

losUnderThreshold - If above this relative to CuGO's position, CuGO will ignore LOS. Positive Integer value.

losOverThreshold - If below this relative to CuGO's position, CuGO will ignore LOS. Positive Integer value.