AutoEnchantEvolution

AutoEnchantEvolution turns your tools and armor into living items that grow stronger the longer you play with them. Every second an item spends in your inventory builds its Bond — and as the Bond grows, your gear evolves through tiers, automatically gaining new enchantments and upgrading existing ones.

No grind tables. No enchanted books. Just play the game, and your gear grows with you.

══════════════════════════════════════════════════════════

HOW IT WORKS

Tools and armor accumulate Bond Seconds while in your inventory. As bond time increases, items progress through five tiers:

• Novice (0–20 min) — gray
• Adept (20 min–1 hr) — green
• Master (1–2 hr) — blue
• Legendary (2–4 hr) — gold
• Mythic (4 hr+) — red

Each tier has its own upgrade interval. Every interval, the item either gains a new enchantment or upgrades an existing one. Enchantments can exceed vanilla max levels — these are called Superior enchantments and display in gold bold text.

The mod respects vanilla enchantment compatibility. A sword won't get Flame. A pickaxe won't get Protection. Only valid enchantments for each item type are applied.

══════════════════════════════════════════════════════════

CUSTOM ENCHANTMENTS

AutoEnchantEvolution adds 5 brand new enchantments that cannot be obtained from the enchantment table — they only appear through the bond system:

━━━ Galactic Protection ━━━
• Applies to: all armor pieces (helmet, chestplate, leggings, boots)
• Effect: flat damage reduction with NO CAP — completely bypasses vanilla's EPF system
• Level 1: 8% damage reduction
• Level 2: 16% damage reduction
• Level 3: 25% damage reduction
• Level 4+: 8% per level (level 13 = 100% invincibility)
• Stacks across all armor pieces — Galactic Protection 3 on all four pieces = 96% reduction
• Tooltip: "Reduces all damage by 8% per level. No cap."

━━━ LifeSteal ━━━
• Applies to: swords and axes
• Effect: heals you based on damage dealt to the target
• Level 1 (None Hostile): heal 10% of damage dealt (hit for 20 = heal 2 HP)
• Level 2 (Hostile): heal 25% of damage dealt (hit for 20 = heal 5 HP)
• Level 3 (Danger): heal 50% of damage dealt + excess healing converts to absorption hearts
• At level 3, if you're at full health and hit for 40 damage, you gain 20 absorption HP (golden hearts)
• Tooltip: "Heals 10-50% of damage dealt per level."

━━━ Bleeding ━━━
• Applies to: swords and axes
• Effect: causes the target to bleed over time — bypasses armor, bypasses regeneration
• Level 1 (None Hostile): 1 HP every 2 seconds for 10 seconds (5 total damage)
• Level 2 (Hostile): 2 HP every 2 seconds for 20 seconds (20 total damage)
• Level 3 (Danger): 3 HP every second for 30 seconds (90 total damage)
• Bleeding STACKS — each hit extends the duration by the base amount
• Bleeding targets emit red particles every time they take damage
• Bleeding persists through death immunity and regeneration
• Tooltip: "Causes target to bleed, bypassing armor."

━━━ Shockwave Absorber ━━━
• Applies to: boots only
• Effect: reduces fall damage and redirects kinetic energy
• Level 1 (None Hostile): absorbs 30% of fall damage
• Level 2 (Hostile): absorbs 60% of fall damage
• Level 3 (Danger): absorbs 95% of fall damage + launches all nearby mobs 3 blocks into the air on landing
• At level 3, landing creates a shockwave that knocks back and damages mobs within 4 blocks
• Visual: crimson particles erupt on landing
• Tooltip: "Reduces fall damage. Lv3 knocks back nearby mobs."

━━━ Destruction Of Mines ━━━
• Applies to: pickaxes, shovels, axes
• Effect: massively increases mining speed + area mining at high levels
• Level 1: 2x mining speed
• Level 2: 5x mining speed
• Level 3: 10x mining speed + 3x3 area mining (breaks connected blocks of same type)
• Level 4: 17x mining speed + 3x3 area mining
• Level 5+: 26x+ mining speed + 5x5 area mining
• Formula: speed = (level² + 1) × original speed
• Tooltip: "Massive mining speed. Lv3+ mines in an area."

All custom enchantments are marked as treasure enchantments — they will NEVER appear in the enchantment table or from villager trades. The only way to obtain them is through the bond system.

Custom enchantments can also become Superior (above level 3) through the bond system, just like vanilla enchantments.

══════════════════════════════════════════════════════════

BOND SYNERGY

If you carry a full tool set — pickaxe, shovel, axe, and sword — all at the same tier, Bond Synergy activates. All bonded items in your inventory gain bond at 2x speed (configurable).

A chat message notifies you when synergy activates:
[Bond Synergy] Full tool set active! Bond gain x2.0

The multiplier applies to ALL bonded items, not just the four tools.

══════════════════════════════════════════════════════════

BOND SURGE

When a Mythic-tier item gains a new enchantment, there's a 5% chance to trigger a Bond Surge:

• A shockwave erupts from you, knocking back and damaging all hostile mobs within 10 blocks
• Every bonded item in your inventory instantly gains +1 enchantment level
• You receive Strength II and Speed II for 10 seconds
• Explosion particles and thunder sound effects
• Chat message: [Bond Surge] Your mythic gear resonates with power!

══════════════════════════════════════════════════════════

BOND LEGACY

Items you've personally named in an anvil gain bond faster:

• Any custom name — 15% faster bond gain (1.15x multiplier)
• Legendary Names — 50% faster bond gain (1.5x multiplier)

Legendary Names are 15 hidden preset names scattered throughout the mod. Players must discover them naturally — there are no hints in-game. If you name your item one of these names, you'll see "Legendary Name" appear in gold on the tooltip.

Legendary Names are case-insensitive.

══════════════════════════════════════════════════════════

BOND CORRUPTION

When you die (any difficulty), each bonded item has a 2% chance to become Corrupted instead of resetting.

Corrupted items:
• Keep ALL enchantments and bond progress
• Gain bond 3x faster
• Are unbreakable — never lose durability
• Drain 1 HP every 10 seconds per corrupted item (magic damage, bypasses armor)
• Cannot be dropped — only destroyed in lava or the void
• Display "CORRUPTED" in dark red on the tooltip
• Emit purple witch particles around you when held

If you die again, corrupted items do NOT reset — they persist through death permanently.

══════════════════════════════════════════════════════════

MULTIPLIER STACKING

All bond multipliers stack multiplicatively:

  Total = Synergy × Legacy × Corruption

Examples:
• Full tool set only: 2.0x
• Legendary name only: 1.5x
• Corrupted only: 3.0x
• Full tool set + legendary name: 3.0x
• Full tool set + legendary name + corrupted: 9.0x

══════════════════════════════════════════════════════════

MYTHIC SET BONUS

Equipping a full set of Mythic-bonded armor grants permanent Resistance, Strength, and Speed.

══════════════════════════════════════════════════════════

DEATH MECHANICS

• Normal / Peaceful / Easy — you keep all bond progress and enchantments
• Hardcore — dying resets ALL bonded items to zero
• Any difficulty — 2% chance per bonded item to become Corrupted instead of resetting

Anvil repairs preserve bond data, named status, and corruption status.

══════════════════════════════════════════════════════════

ENCHANTMENT FILTERING

Server owners can control which enchantments are allowed:

• /aee blacklist add <enchantment> — blocks an enchantment
• /aee blacklist remove <enchantment> — removes from blacklist
• /what_blacklisted — view blocked enchantments
• /aee whitelist add <enchantment> — adds to whitelist (strict mode)
• /aee whitelist remove <enchantment> — removes from whitelist
• /what_whitelisted — view whitelisted enchantments

Works with both vanilla and custom enchantments:
• /aee blacklist add autoenchantevolution:bleeding
• /aee blacklist add bleeding

Defaults: Vanishing Curse and Binding Curse are blacklisted automatically.

══════════════════════════════════════════════════════════

PERFORMANCE

Built with a full adaptive performance monitor:

• TPS ≥ 18 → 5 slots/batch every 20 ticks
• TPS ≥ 14 → 3 slots/batch every 60 ticks
• TPS ≥ 8 → 2 slots/batch every 100 ticks
• TPS < 8 → 1 slot/batch every 200 ticks
• TPS < 5 → all processing paused

══════════════════════════════════════════════════════════

CHAT MESSAGES

Four verbosity levels (configurable):
• 0 = silent (no messages)
• 1 = tier transitions only
• 2 = held item only
• 3 = all items (default)

══════════════════════════════════════════════════════════

TOOLTIP DISPLAY

Bonded items show:
• CORRUPTED (dark red) — if corrupted
• Bond: 2h 15m 30s (Master) — current bond time and tier
• Legendary Name (gold) — if item has a legendary name
• Superior: 3 (red) — count of enchantments above vanilla max
• Enchantment list with descriptions
• Superior enchantments shown in gold bold

══════════════════════════════════════════════════════════

COMPATIBILITY

• Minecraft 1.20.1
• Forge 47.3.0+
• Java 17
• Server and client compatible