==== IMPORTANT ====

This datapack works ONLY with Minecraft 1.19.4 or snapshot 23w03a and above! These versions add the necessary /ride command!

About

Iron Golem is a datapack which makes players automatically tame their Iron Golems upon creating them.

Players can mount their Golems by hitting them with an empty hand or a Compass. Once player mounts a Golem, they are three ways to ride it:

1. walk as if they were walking normally,
2. hold Compass in mainhand to make it automatically go where player is facing,
3. hold Compass in offhand to "lock" a direction and make it continually go there.

The tamed Golems in this datapack have new behaviors:

1. they will attack any mob, which attacks their owner,
2. they will defend their owner from any mob attacking them.

The datapack also adds an individual twist to each Golem: attributes and 63 unique traits!
Attributes define each Golem's health, speed, damage and fuel efficiency, which determines how fast Golem's health depletes when riding.
Each Golem has two random traits, which can positively or negatively alter movement speed, attributes, fighting capabilities and more.

Iron Ingots, in addition to repairing a Golem, can also upgrade their attributes and traits. Spyglass allows to status check Golems. By hitting them with a Spyglass, player can get an overview about their owner, statistics (hp, damage, speed), attributes and traits.
Spyglass can also be directly used to check whether Golem is player created and has an owner.


Lodestone is another useful item in leading Golems. When holding it in hand, nearby owned and tamable Golems will follow the player.

Taming

There are 2 types of Iron Golems in Minecraft:

1. Non-player Created, generating naturally in Villages or Pillager Outposts,
2. Player Created, by placing 4 Iron Blocks in T-shape and Carved Pumpkin on top to create them.
Only the second type (Player Created) can be tamed. When the Golem is created, it is automatically tamed. For Golems created before installing this datapack, the "finders keepers" rule applies - a player using Iron Ingot on such Golem will tame it. A tamed Golem is forever bound to its owner.

Mounting

Each player can very easily mount their Golems - by hitting them with an empty hand or a Compass. The datapack tries to compensate the health loss caused by hitting your Golem (make sure it has at least 1 hp first!)

Riding

When on a Golem, walking mechanics work the same (using arrow keys).

Golems cannot jump or swim and they sink in water (unless they have a special trait). They also take no fall damage.
If you have Compass in your main hand, Golem will automatically walk in the direction you're looking.

If you have Compass in your off hand, Golem will lock in the direction and continue going that path. This way you can walk and face different directions.
Just remember to switch hands quickly not to fall off a cliff.

Holding Recovery Compass in any hand will make golem walk 33.3% faster (and double the wear out tempo, see Attributes and Fuel Efficiency).
The last important thing to know is that when there's a hostile mob nearby, the Golem will try to walk to it it even if you're controlling it.

It will result in Golem not walking exactly the straight path you want it to.

Tamed Behavior

Original Golem AI only attacks nearby hostile mobs.
Your Golems will also attack any mob which attacks you, e.g. wolves.
They will also attack any mob which you attack, even Villagers. There are limitations to what Golems can attack:
- can't attack Creepers or other Players (hardcoded AI)
-will not attack mobs owned by you (your other Golems or your pets)
-will not attack Player Created Golems which are tameable (without owner)
Golems can still attack other player's Golems and Non Player Created ones. Be careful not to strike other player Golem by mistake, this can lead to a Golem fight!

Repairing

Using Iron Ingot on a Golem restores it 25 health. The only difference in this datapack is that if Golem is not fully upgraded, it will be healed up to 99.99% instead of 100%, so it's possible spam many Iron Ingots for upgrading.
This mechanic can be disabled/enabled by following commands:

/trigger irongolem.disable_infinite_repair
/trigger irongolem.enable_infinite_repair

Status Checking

When hitting a Golem with Spyglass, you can immediately see its owner, stats, attributes and traits.

The datapack tries to compensate the health loss caused by hitting the Golem (make sure it has at least 1 hp first!)
Hitting Golems with Spyglass shouldn't cause aggression towards you or it (unless you do more dmg due to Strength).

If you want to know who the Golem belongs to and if it is tameable, you can use the Spyglass to show particles near each Golem:
- Hearts mean the Golem is yours,
- Angry Villager particles mean Golem is Non Player Created,
- Black hearts mean the Golem is someone else's,
- Green glow means the Golem is tameable.
The particles can be disabled/enabled by following commands:

/trigger irongolem.disable_spyglass_particles

/trigger irongolem.enable_spyglass_particles

Leading Golems

When holding Lodestone block in any hand, all nearby your and tameable Golems will walk towards you at 75% speed.

This is useful if you want to move multiple golems or lead them to particular place.
Keep in mind the Golems don't pathfind, but walk to you in a straight line. A useful tip is to hold Compass in one hand and Lodestone in another if you want to move multiple Golems while riding one.

Attributes

This Datapack introduces Attribute system. There are 4 attributes:

- Max Health,
- Movement Speed,
- Attack Damage,
- Fuel Efficiency.

Each Attribute has 101 levels, from level 0 to 100 inclusive.
Each Golem starting attributes are random, initially roughly between 0 and 50.

The more Golems you create and upgrade, the higher the upper cap becomes.
In order to level up attributes to lvl 100, you need to use Iron Ingots to upgrade the Golem.
How Each attribute scales between lvl 0 and 100 (and what's the original Iron Golem default):

- Max Health between 75 and 175 Health (100 originally),
- Movement Speed between 0.2 and 0.4 (0.25 originally),
- Attack Damage Speed between 12 and 24 (15 originally),
- Fuel Efficiency Speed between 75% and 150%.

Fuel Efficiency is an inconvenience, which makes Iron Golem's health slowly deplete when you are riding it.
Each step you take slowly wears out your Golem. It's not a huge number, but adds a cost mechanic to having your all-in-one bodyguard & vehicle by your side. What changes is you need to have some Iron Ingots with you to heal the Golem when travelling long distances.
The higher level of Fuel Efficiency, the slower the Health drains. When Golem health is under 75%, it receives a riding speed penalty, dependent on missing hp, up to 50% slow:
- 100% hp = 0% slow,
- 75% hp = 0% slow,
- 50% hp = 16.7% slow,
- 37.5% hp = 25% slow,
- 0.01% hp = 50% slow.

Traits

Traits are unique bonuses for Iron Golems. They can improve speed, stats, give auras and more. They can be positive or negative.

Each Golem starts with two traits - one positive and one negative.
The negative trait can be eventually upgraded to a positive one. So even if you roll a really bad trait, keep in mind you can upgrade it.

Upgrading

Every time you heal a Golem, there's a:

-96% chance to upgrade one random Golem attribute,
-4% chance to upgrade one Golem trait.
Upgrading a Golem creates particles.

(!) Useful Triggers (!)

(!) List of Traits (!)

Questions/Ideas/Suggestions/Bugs? Don't hesitate to write in the comments! Enjoy!
=======================================