[AN]Adaptive Nemesis

📖 Overview

Adaptive Nemesis is a NeoForge 1.21.1 dynamic difficulty balancing mod designed specifically for Minecraft modpacks.

It solves the common modpack problem where early game feels like "scratching with a toothpick" while late game becomes "one-shotting everything." By intelligently evaluating player strength and dynamically adjusting enemy attributes, combat always maintains that "a bit hard, but not too much" thrilling tension.

⚔️ Core Mechanics

1. Player Strength Evaluation System

The mod continuously monitors each player's comprehensive combat power, assessing based on multi-dimensional data:

Dimension Description Weight 🛡️ Defense Armor value, max health, armor toughness High ⚔️ Offense Attack damage, attack speed, weapon enchantment level High ✨ Mythic Affixes Apotheosis equipment quality and tier Medium 🔮 Iron's Spells Iron's Spells 'n Spellbooks mana pool, spell power Medium 🗡️ Epic Fight Epic Fight stamina value, combat style Medium

All weights can be customized via configuration files, with KubeJS script support for extended evaluation logic!

2. Dynamic Enemy Scaling

When hostile mobs spawn, the mod provides adaptive attribute bonuses based on the average strength of nearby players:

Scaling Type Description Cap Health Max health increase 500% Damage Attack damage increase 500% Armor Physical defense increase 300% Attack Speed Prevents infinite stunlock - Spell Power Iron's Spells compatibility - Spell Resistance Iron's Spells compatibility - Hit Resistance Epic Fight compatibility - Knockdown Resistance Epic Fight compatibility - Stamina Epic Fight compatibility -

Attribute Random Distribution: Each spawned enemy's attributes will fluctuate around the base value (70%~130%), making every battle unpredictable!

Base Scaling = Player Comprehensive Strength × Difficulty Coefficient Float Adjustment = Base Scaling × (0.7 ~ 1.3) // Attribute random distribution

3. True Damage Conversion (Iron Turtle Terminator)

For high-armor players, the mod forcibly converts a portion of damage into armor-ignoring true damage:

Armor Level True Damage Ratio Standard Armor (≤20) 5% Enhanced Armor (20~50) 15% High Armor (50~100) 25% Iron Turtle (>100) 35%

Never fear becoming invincible with god gear! Enemies will find your weakness 🔥

4. Adaptive Float System

Dynamically adjusts difficulty based on real-time player performance:

Player Behavior System Response Consecutive Kills Float multiplier +10% (enemies grow stronger) Frequent Deaths Float multiplier -15% (giving you breathing room) Long Inactivity Float multiplier resets to baseline

💡 Goal: Always make players feel "a bit hard, but not too much" — just the right challenge

5. Nemesis Memory System

Each player has an independent Nemesis profile. Enemies remember your combat style and evolve accordingly:

Memory Type Records Enemy Evolution Direction Kill Preference Player's common kill methods Enemies gain corresponding resistances Death Records Damage sources when player dies Enemies learn corresponding attack patterns Equipment History Equipment combinations player has used Enemies evolve targeted counter-strategies Behavior Patterns Melee/ranged/magic preferences Enemies adjust AI behavior

6. Newbie Protection Mechanism

Provides thoughtful protection for low-strength players:

Trigger Condition Effect Duration Player Comprehensive Strength < Threshold Monster attributes -30% Configurable First Death Protection time +10 minutes Cumulative cap 3 Consecutive Deaths Force enable protection Until any enemy is killed

7. Boss Mechanics

Prevents players from one-shotting Bosses, extending epic combat experiences:

• ✅ Damage Cap: Single-hit damage has an upper limit (default 100), which increases as Boss health decreases
• ✅ Attribute Amplification: Boss health ×5, damage ×3
• ✅ Combat Tracking: Records combat duration and cumulative damage
• ✅ Phase Evolution: Bosses dynamically adjust attack patterns based on combat duration

🔗 Mod Compatibility

Adaptive Nemesis natively supports the following popular mods:

Mod Compatible Content 🔮 Iron's Spells 'n Spellbooks Spell power, mana pool, cooldown reduction, magic resistance ⚔️ Epic Fight Hit resistance, impact, armor breaking, combos, stamina ✨ Apotheosis Equipment quality, mythic affix tier evaluation 📦 KubeJS Custom events, script extensions, config hot reload

⌨️ Commands

All commands use /an prefix, requiring OP permission (level 2):

Command Description /an status View mod current running status /an strength [player] View specified player's strength evaluation data /an difficulty View/adjust difficulty settings /an protection [player] View/manage newbie protection status /an memory [player] View Nemesis memory profile /an scan [range] Scan surrounding enemies' scaling data /an nemesis [type] Summon Nemesis /an test [module] Test mod module functions /an reload Reload configuration files /an help Display help information

⚙️ Configuration System

All mod mechanisms can be finely adjusted through configuration files

• Config file path: config/adaptive_nemesis-common.toml

🔧 KubeJS Integration

Automate mod configuration through scripts:

Available Events

Event Name Trigger Timing Purpose adaptive_nemesis.entity_scale When entity attributes are scaled Customize specific entity scaling multipliers adaptive_nemesis.damage_calculation When true damage is calculated Adjust damage values or cancel conversion adaptive_nemesis.player_strength_evaluation When player strength is evaluated Modify final strength calculation adaptive_nemesis.nemesis_memory_update When Nemesis memory updates Listen for milestones or custom rewards

Practical Scenarios

Scenario Implementation Extra zombie scaling Check entity ID, multiply scaling Boss double scaling Check boss type, multiply scaling High-level player difficulty Add strength based on player level Milestone rewards Listen for every-10-kills event, grant rewards Global difficulty adjustment Define global coefficient, unified multiplication

📦 Datapack Support（In the Plan）

Extend mod content through datapacks without writing code:

• Custom Nemesis types
• Define entity transformation rules
• Configure special scaling effects
• Override default difficulty parameters

🚀 Performance Optimization

Optimization Solution Effect Entity Calculation Regional caching + async update Reduce real-time calculation overhead Multiplayer Server TPS Client prediction + server validation Reduce server load Config Hot-Update Incremental sync, not full reload Avoid lag spikes Memory System Storage On-demand loading, periodic archiving Control save file size

📖 Design Philosophy

"Your power feeds their evolution"

Adaptive Nemesis's core concept is dynamic balance:

1. Never weaken players — Players can still enjoy the thrill of growing stronger
2. Match enemies to strength — Enemies always scale with player power
3. Learn and counter — Enemies learn player combat styles and evolve targeted counters
4. Protect newbies — Give new players enough room to grow
5. Challenge veterans — Keep experienced players constantly challenged

• Whether you're a newcomer just starting a modpack or a veteran in full god gear, Adaptive Nemesis provides just the right combat experience!

⚔️ Every time you grow stronger, your Nemesis evolves ⚔️