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.

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

TIER PROGRESSION

When an item reaches a new tier, a chat announcement fires and tier-specific particles spawn around the player. The item's tooltip updates to show current bond time and tier name.

Tier times are fully configurable. The defaults are:
• Novice → Adept: 20 minutes
• Adept → Master: 1 hour
• Master → Legendary: 2 hours
• Legendary → Mythic: 4 hours
• Mythic: Max tier (no cap)

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

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. Upgrade all four tools to the next tier together to maintain synergy.

Config options:
• bond_synergy_enabled — toggle on/off
• bond_synergy_multiplier — change the multiplier (1.0–10.0)

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

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 Surge turns Mythic tier into a celebration moment. The more Mythic items you have, the more often Surges fire.

Config options:
• bond_surge_chance — probability per Mythic enchant (0.0–1.0)

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

BOND LEGACY

Items you've personally named in an anvil gain bond faster. There are two tiers of bonus:

• 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 (so "excalibur" and "EXCALIBUR" both work).

The Legacy bonus stacks with Bond Synergy and Bond Corruption. A full tool set with legendary names would gain bond at 3.0x speed (2.0 × 1.5).

Config options:
• bond_legacy_enabled — toggle on/off
• bond_legacy_random_multiplier — multiplier for any custom name (default 1.15)
• bond_legacy_preset_multiplier — multiplier for legendary names (default 1.5)

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

BOND CORRUPTION

The dark counterpart to Bond Surge. 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 than normal
• Are unbreakable — they 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.

The risk/reward:
• 1 corrupted item = 1 HP every 10 seconds (manageable)
• 5 corrupted items = 5 HP every 10 seconds (dangerous)
• 10 corrupted items = you're dying constantly

Players must choose: keep the immense power of corrupted gear, or destroy it in lava to stop the HP drain. On hardcore servers, this creates genuine tension — corrupted Mythic gear is the strongest in the game, but it will eventually kill you.

Corrupted items gain bond at 3.0x speed. This stacks with Synergy (2.0x) and Legacy (1.5x), meaning a corrupted, legendary-named, synergy-active item gains bond at 9.0x speed.

Config options:
• bond_corruption_enabled — toggle on/off
• bond_corruption_chance — probability per item on death (default 0.02 = 2%)
• bond_corruption_drain_interval — ticks between HP drain (default 200 = 10 seconds)
• bond_corruption_bond_multiplier — bond speed multiplier (default 3.0)

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

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 (helmet, chestplate, leggings, boots) grants permanent buffs:
• Resistance
• Strength
• Speed

Mythic items are also auto-named to reflect their evolved status.

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

DEATH MECHANICS

• Normal / Peaceful / Easy — you keep all bond progress and enchantments
• Hardcore — dying resets ALL bonded items to zero (bond seconds, upgrade timers, names wiped clean)
• Any difficulty — 2% chance per bonded item to become Corrupted instead of resetting (if enabled)

Anvil repairs preserve bond data. If you repair a bonded item, the output keeps the bond seconds, upgrade time, named status, and corruption status of the original.

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

ENCHANTMENT FILTERING

Server owners can control exactly which enchantments are allowed using in-game commands:

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

Blacklist blocks specific enchantments globally. Whitelist locks items to ONLY the listed enchantments. Both sync across the entire server and apply to all players.

Enchantment names can be typed with or without the minecraft: prefix:
• /aee blacklist add minecraft:vanishing_curse
• /aee blacklist add vanishing_curse

Defaults: Vanishing Curse and Binding Curse are blacklisted automatically so your bonded gear never gets cursed.

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

PERFORMANCE

Built with a full adaptive performance monitor that scales processing based on server TPS:

• 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 until recovery

Configurable options:
• adaptive_performance — enable/disable auto-scaling
• min_tick_interval — base processing interval
• particle_density — 0 to 3 visual effect scaling
• held_only — only process held item + armor
• include_inventory — process all 36 inventory slots

Works on potato laptops and dedicated servers alike.

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

CHAT MESSAGES

Four verbosity levels (configurable):
• 0 = no chat messages at all (silent mode)
• 1 = tier transitions only (rank-up announcements)
• 2 = held item only (only your main hand / offhand announces enchantments)
• 3 = all items (every item in your inventory announces enchantments)

Default is 3 (all items).

Message format:
[Bond] Wooden Pickaxe enchanted with Mending 3
[Bond] Iron Sword has reached Adept tier!
[Bond] Golden Axe enchanted with Sharpness 5 (Superior!)
[Bond Synergy] Full tool set active! Bond gain x2.0
[Bond Surge] Your mythic gear resonates with power!
[Bond] Corrupted items cannot be dropped! Destroy in lava or void.

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

TOOLTIP DISPLAY

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

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

FULL CONFIGURATION

Every aspect of the mod is configurable in autoenchantevolution-common.toml:

[AutoEnchantEvolution]
• max_enchant_level (default 1,000,000)
• max_enchantments_per_item (default 10)
• held_only (default false)
• include_inventory (default true)
• set_bonus_enabled (default true)
• auto_name_enabled (default true)
• novice_max_seconds (default 1200 = 20 min)
• adept_max_seconds (default 3600 = 1 hr)
• master_max_seconds (default 7200 = 2 hr)
• legendary_max_seconds (default 14400 = 4 hr)
• bond_synergy_enabled (default true)
• bond_synergy_multiplier (default 2.0)
• bond_surge_chance (default 0.05 = 5%)
• bond_legacy_enabled (default true)
• bond_legacy_random_multiplier (default 1.15)
• bond_legacy_preset_multiplier (default 1.5)
• bond_corruption_enabled (default true)
• bond_corruption_chance (default 0.02 = 2%)
• bond_corruption_drain_interval (default 200 = 10 sec)
• bond_corruption_bond_multiplier (default 3.0)

[Performance]
• adaptive_performance (default true)
• min_tick_interval (default 20)
• particle_density (default 1)
• chat_message_level (default 3)

[Enchantment_Filters]
• enchantment_blacklist (default: vanishing_curse, binding_curse)
• enchantment_whitelist (default: empty = all allowed)

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

COMPATIBILITY

• Minecraft 1.20.1
• Forge 47.3.0+
• Java 17
• Server and client compatible
• Works with existing worlds — no new blocks or items required
• Safe to add/remove from existing saves (bonded items just stop progressing when mod is removed)

VERSION 2.1.0 — THE BOND UPDATE

Major Features:
• Added Bond Synergy — carrying a full tool set (pickaxe + shovel + axe + sword) at the same tier grants 2x bond gain to ALL bonded items. Configurable multiplier.
• Added Bond Surge — Mythic items have a 5% chance on enchant to trigger an explosive shockwave that damages nearby mobs, buffs the player, and instantly upgrades all bonded items.
• Added Bond Legacy — items renamed in an anvil gain bond 15% faster. 15 hidden legendary names grant 50% faster bond. Players must discover them naturally.
• Added Bond Corruption — on death, each bonded item has a 2% chance to corrupt instead of resetting. Corrupted items are unbreakable and gain bond 3x faster but drain 1 HP every 10 seconds and cannot be dropped.

Improvements:
• Doubled all tier progression time thresholds:
  - Novice: 10 min → 20 min
  - Adept: 30 min → 1 hr
  - Master: 1 hr → 2 hr
  - Legendary: 2 hr → 4 hr
  - Mythic: unchanged (max tier)
• Bond multipliers now stack multiplicatively (Synergy × Legacy × Corruption)
• Chat message format standardized across all features
• Tooltip now shows "Legendary Name" for items with preset names
• Tooltip now shows "CORRUPTED" for corrupted items

Bug Fixes:
• Fixed garbled/corrupted chat messages from encoding issues
• Fixed missing notifyUpgrade and notifyTierTransition methods
• Fixed EnchantmentHelper API calls for 1.20.1
• Fixed anvil repair not preserving corruption status

New Config Options:
• bond_synergy_enabled
• bond_synergy_multiplier
• bond_surge_chance
• bond_legacy_enabled
• bond_legacy_random_multiplier
• bond_legacy_preset_multiplier
• bond_corruption_enabled
• bond_corruption_chance
• bond_corruption_drain_interval
• bond_corruption_bond_multiplier