📜 Adaptive Nemesis Changelog

---

v1.0.16 (2026-08-30) 🎯

⏳ Feature: Nemesis Auto-Despawn

• NemesisConfig.java: Added 3 new config options:
  • ENABLE_NEMESIS_AUTO_DISAPPEAR — toggle on/off
  • NEMESIS_AUTO_DISAPPEAR_SECONDS — lifetime (default: 300s / 5 min)
  • NEMESIS_DISAPPEAR_MESSAGE — despawn notification message
• NemesisSystem.java: Added nemesisSpawnTimes Map to track each nemesis spawn timestamp. New onEntityTick() periodically polls and auto-discard()s entities past their lifetime.
• NemesisSystem.java: Records spawn time in both convertToNemesis() and convertToNemesisManual() — command-spawned nemeses are equally controlled.
• zh_cn.json / en_us.json: New translation key adaptive_nemesis.nemesis.disappear
  • 🇨🇳 "%s 已经消失了..."
  • 🇬🇧 "%s has disappeared..."
• Effect: Nemeses (natural spawn or command-summoned) automatically vanish after the configured duration, preventing performance bloat and gameplay imbalance from permanent stragglers.

---

🔧 Fix: Config Type Switched to SERVER — Multiplayer Sync

• AdaptiveNemesisMod.java: Config registration changed from COMMON → SERVER. Server becomes config authority; NeoForge auto-syncs to all clients.
• Config.java: Added isServerSide() environment check. saveToFile() now has server-side protection — multiplayer clients no longer attempt to write read-only configs.
• AdaptiveNemesisConfigScreen.java: Added readOnly field. Multiplayer client controls are greyed out with a read-only hint to prevent accidental edits.
• AdaptiveNemesisConfigScreen.java: markChanged() now has read-only guard — multiplayer clients are blocked from saving.
• en_us.json / zh_cn.json: New localization key readonly_hint for the read-only tooltip.
• ⚠️ Note: Config file renamed from adaptive_nemesis-common.toml → adaptive_nemesis-server.toml. Existing configs need manual migration.

---

💥 Fix: Enchantment Scaling Causing Save Crashes (Reconnect Failure)

• EnchantmentScalingHandler.java: Resets enchantment caches on server shutdown (resetCaches() method) — prevents Holder.Reference<Enchantment> stale references from singleton pattern.
• EnchantmentScalingHandler.java: Validates Holder validity in applyCoreEnchantments() with double-check on ResourceKey existence in server registry.
• EnchantmentScalingHandler.java: Added holder.isBound() validation in applyModCompatibleEnchantments() to prevent network encoding failures.
• InvasionSystem.java: Added Holder validation in applyFrostWalkerBoots() to prevent Frost Walker enchantment from causing network encoding exceptions.
• ModEventHandler.java: Calls EnchantmentScalingHandler.resetCaches() on ServerStoppingEvent, ensuring stale references are purged on shutdown.
• EnchantmentScalingHandler.java: Fixed collectCompatibleEnchantments() Holder.unwrapKey() API call.

---

🔄 Fix: Invasion Event Infinite Loop (Spawning More & More)

• InvasionSystem.java: Added playerInvasionCooldowns Map tracking per-player cooldown (UUID → cooldown expiry timestamp).
• InvasionSystem.java: Added cooldown check in incrementUndeadKillCount() — shows remaining time hint during cooldown period.
• InvasionSystem.java: Auto-sets cooldown on invasion trigger (default: 15 min, configurable).
• InvasionSystem.java: Clears cooldown in handleInvasionVictory(), allowing the next invasion to trigger normally.
• zh_cn.json / en_us.json: New cooldown warning translations:
  • cooldown_warning
  • cooldown_warning_minutes
  • cooldown_warning_seconds
• InvasionConfig.java: Existing invasionCooldownMinutes config (default: 15 min) — no new config needed.

---