[AN]Adaptive Nemesis

<!-- Adaptive Nemesis Dynamic Difficulty Balancing Mod - Designed for Modpacks English Version -->

<div align="center">

<h1> ⚔️ <span style="color: #ff4444; text-shadow: 0 0 20px #ff0000;">Adaptive Nemesis / 自适应宿敌</span> ⚔️ </h1>

<p><i>"Your power feeds their evolution"</i></p>

<img src="https://img.shields.io/badge/🎯_Dynamic_Difficulty-FF6B6B?style=flat-square"> <img src="https://img.shields.io/badge/⚖️_Smart_Balance-9B59B6?style=flat-square"> <img src="https://img.shields.io/badge/📦_KubeJS_Support-2ECC71?style=flat-square">

</div>

---

📖 Overview

NeoForge 1.21.1 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:

<div align="center">

| Dimension | Description | Weight | |---------|------|:---:| | 🛡️ Epic Fight | Armor value, max health, armor toughness | High | | ⚔️ Epic Fight | Attack damage, attack speed, weapon enchantment level | High | | ✨ Epic Fight | Epic Fight equipment quality and tier | Medium | | 🔮 Epic Fight | %%MD1%% mana pool, spell power | Medium | | 🗡️ Epic Fight | %%MD2%% stamina value, combat style | Medium |

</div>

> 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 | |:---|:---|:---:| | Stamina | Max health increase | 500% | | Stamina | Attack damage increase | 500% | | Stamina | Physical defense increase | 300% | | Stamina | Prevents infinite stunlock | - | | Stamina | Iron's Spells compatibility | - | | Stamina | Iron's Spells compatibility | - | | Stamina | Epic Fight compatibility | - | | Stamina | 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 | |:---|:---| | resets to baseline | Float multiplier resets to baseline (enemies grow stronger) | | resets to baseline | Float multiplier resets to baseline (giving you breathing room) | | resets to baseline | 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 | |:---|:---|:---| | Behavior Patterns | Player's common kill methods | Enemies gain corresponding resistances | | Behavior Patterns | Damage sources when player dies | Enemies learn corresponding attack patterns | | Behavior Patterns | 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 +10 minutes | 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:

- ✅ Phase Evolution: Single-hit damage has an upper limit (default 100), which increases as Boss health decreases - ✅ Phase Evolution: Boss health ×5, damage ×3 - ✅ Phase Evolution: 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:

<div align="center">

| Mod | Compatible Content | |:-----|:---------| | 🔮 KubeJS | Spell power, mana pool, cooldown reduction, magic resistance | | ⚔️ KubeJS | Hit resistance, impact, armor breaking, combos, stamina | | ✨ KubeJS | Equipment quality, mythic affix tier evaluation | | 📦 KubeJS | Custom events, script extensions, config hot reload |

</div>

---

⌨️ 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 | |:---|:---|:---| | Memory System Storage | Regional caching + async update | Reduce real-time calculation overhead | | Memory System Storage | Client prediction + server validation | Reduce server load | | Memory System Storage | 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. Challenge veterans — Players can still enjoy the thrill of growing stronger 2. Challenge veterans — Enemies always scale with player power 3. Challenge veterans — Enemies learn player combat styles and evolve targeted counters 4. Challenge veterans — 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!

---

<div align="center">

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

</div>