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.

──────────────────────

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.

──────────────────────

MYTHIC SET BONUS

Equipping a full set of Mythic-bonded armor 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, and names are wiped clean

This makes the mod a true risk/reward progression system in hardcore mode.

──────────────────────

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.

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.

──────────────────────

CONFIGURATION

Every aspect of the mod is configurable:
• Max enchant level (default 1,000,000)
• Max enchantments per item (default 10)
• Tier time thresholds
• Chat message verbosity (0=off, 1=tiers only, 2=held only, 3=all items)
• Particle density (0–3)
• Performance tuning
• Enchantment blacklist/whitelist

──────────────────────

COMPATIBILITY

• Minecraft 1.20.1
• Forge 47.3.0+
• Java 17

What's new?
• Fixed garbled/corrupted chat messages — enchantment upgrade notifications now display cleanly as "[Bond] <item> enchanted with <enchantment> <level>" instead of broken encoding text
• Fixed notifyUpgrade method that was cut off mid-line in source code causing malformed message output
• Fixed missing notifyTierTransition method — tier-up announcements now fire correctly with proper item names and tier colors
• Tier transition messages now properly format with tier-specific colors (gray/green/blue/gold/red)
• Superior enchantment upgrades now display "(Superior!)" in gold bold text

What's changed?
• 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: 4 hr+ (unchanged, still max tier)
• Chat message format standardized to: [Bond] <Item> enchanted with <Enchantment> <Level>
• Chat verbosity default set to level 3 (all inventory items announce)
• Enchantment names now use proper translatable components instead of raw strings — displays correctly in all languages