---

📖 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:

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:

---

⌨️ 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!

---