Evil Companion v1.1.0 - Major Update

Release Date: November 3, 2025
Minecraft Version: 1.20.1
Forge Version: 47.2.1

🎉 What's New

⚖️ Balanced Progression System

• NEW: Diminishing returns formula for health and damage scaling
  • Early Game (Levels 1-10): Linear growth for accessible progression
  • Mid Game (Levels 11-50): Square root scaling for moderate challenges
  • Late Game (Levels 51+): Logarithmic scaling prevents exponential difficulty spikes
• Result: Boss remains challenging but fair at all levels, preventing impossible fights at level 100+

🎨 Enhanced Combat Animations

• NEW: Boss now visually crouches when blocking with shield (player-like animation)
• NEW: Shield raise animation when defending
• FIXED: Shield no longer spams - now has 5-second cooldown
• IMPROVED: Shield only activates below 80% health for more strategic gameplay

🤺 Improved AI Behavior

• NEW: Boss properly fights ALL hostile mobs at unhostile levels (Level 1-2)
  • Monsters: Full persistent combat until dead
  • Players: One-hit retaliation only (unless angry/hostile)
• NEW: Boss can climb ladders, vines, and scaffolding
• NEW: Boss intelligently uses doors, buttons, and levers
  • Presses buttons to open paths
  • Pulls levers strategically
  • Opens doors to reach targets
• IMPROVED: Boss stops breaking blocks when it can attack or reach the player
  • No more griefing during active combat
  • Focuses on fighting when target is accessible

🐉 Complete End Dimension Overhaul

• FIXED: Boss respawn spam - now only spawns once when needed
• FIXED: Player trap system - changed from full cage to foot trap
  • Only traps legs (2 blocks high), no roof
  • Boss can attack from above
  • Player immobilized but can still fight back
• FIXED: Shulker spawn spam - 30-second cooldown
  • 70% Endermen, 30% Shulkers (balanced)
  • Void-safe spawning (Y >= 10)
• NEW: Void avoidance system
  • Detects Y < 0 and teleports to safety
  • Stops falling at Y < 10
  • Smart safety position finding
• NEW: Intelligent End Crystal rebuilding
  • Finds nearest destroyed pillar (100-block radius)
  • Navigates to pillar base
  • Towers up by placing obsidian blocks
  • Places crystal on bedrock top only
• NEW: Enhanced priority system
  • Crystal rebuilding (check every 10s, 40% chance)
  • Helper spawning (check every 5s, 25% chance)
  • Combat abilities (3-second cooldown)
  • No action conflicts
• IMPROVED: Mining disabled in End dimension
• IMPROVED: Only targets assigned players and Iron Golems when hostile
  • No more attacking all mobs indiscriminately
  • Focused combat on relevant threats

📘 Comprehensive Field Guide

• REWRITTEN: 16-page guidebook with complete gameplay information
• NEW SECTIONS:
  • Level progression explained
  • Combat abilities breakdown
  • AI behaviors guide
  • Anger system mechanics
  • Visual crafting recipes
  • Survival tips and strategies
  • Loot tables reference
  • Multiplayer guidance
• IMPROVED: Configuration-agnostic descriptions (no hardcoded values)

🎮 Commands System

• NEW: /evilcompanion guide - Get the field guide book (all players)
• NEW: /evilcompanion removeboss <player> - Remove a player's boss completely (OP only)
• NEW: /evilcompanion setlevel <player> <level> - Change boss level (1-1000) (OP only)
• NEW: /evilcompanion disableboss <player> - Disable boss spawning for player (OP only)
• NEW: /evilcompanion enableboss <player> - Enable boss spawning (OP only)
• NEW: /evilcompanion spawnboss <player> - Force spawn/assign boss for player (OP only)
  • FIXED: Now clears dragon defeat status to allow respawning after disableboss
• NEW: /evilcompanion reload - Reload configuration in-game (OP only)

⚖️ Separate Base Health Configs

• NEW: unhostileBaseHealth - Base health for unhostile boss (Levels 1-2, default: 100 HP)
• NEW: hostileBaseHealth - Base health for hostile boss (Level 3+, default: 60 HP)
• NOTE: Old baseHealth config deprecated but kept for backwards compatibility

💎 Loot System Improvements

• FIXED: Enchanted books now have actual random enchantments applied
  • Level 3-19: 1 enchantment (low-mid level)
  • Level 20-49: 2 enchantments (mid-high level)
  • Level 50+: 3 enchantments (max level)
• IMPROVED: Enchantment quality scales with boss level
  • Low levels: Lower enchantment tiers
  • High levels: Maximum enchantment tiers

📦 Recipe Improvements

• FIXED: All 5 recipes now appear in crafting table by default
• NEW: Recipe advancement system unlocks recipes automatically
  • Companion Field Guide: Unlocks when you get a book
  • Truce Tonics: Unlock when you get a honey bottle
• IMPROVED: Simplified field guide recipe (book + stick only)

🐛 Bug Fixes

Combat & Rendering

• FIXED: Armor now renders correctly on boss entity
• FIXED: Shield animation missing (no crouch or shield raise)
• FIXED: Shield spam behavior (activated every 3 seconds)
• FIXED: Boss wouldn't fight monsters at low levels

AI & Pathfinding

• FIXED: Boss continued breaking blocks even when target was accessible
• FIXED: Incorrect retaliation behavior (one-hit logic not working)
• FIXED: Boss couldn't climb or navigate vertical obstacles
• FIXED: Boss couldn't use doors, buttons, or levers

End Dimension

• FIXED: Boss respawning every 5 seconds (spam)
• FIXED: Boss boxing players near portals
• FIXED: Boss boxing players in mid-air
• FIXED: Boss boxing players near void
• FIXED: Shulker spawn spam (overwhelming)
• FIXED: Boss falling into void repeatedly
• FIXED: Boss prioritizing mining over dragon defense
• FIXED: Boss attacking all mobs instead of focusing on threats
• FIXED: End crystals not being rebuilt properly
• FIXED: Boss breaking End portals and bedrock while escaping or boxing players

World Protection

• FIXED: Boss can no longer break or replace End portals, End portal frames, End gateways, or bedrock in any dimension
• FIXED: All AI goals (trap, grief, escape, bridge, defend dragon) now respect protected blocks

Recipes & Items

• FIXED: Recipes didn't appear in crafting table
• FIXED: Recipes weren't unlocked by default
• FIXED: Enchanted books were plain (no actual enchantments)

Balance Formulas

New Health Calculation:

// Levels 1-10: Linear
health = baseHealth + (level × perLevel)

// Levels 11-50: Square Root
health = base + (√(level - 10) × perLevel × 8)

// Levels 51+: Logarithmic
health = base + (log(level - 50 + 1) × perLevel × 20)

New Damage Calculation:

// Levels 1-10: Linear
damage = baseDamage + (level × perLevel)

// Levels 11-50: Square Root
damage = base + (√(level - 10) × perLevel × 3)

// Levels 51+: Logarithmic
damage = base + (log(level - 50 + 1) × perLevel × 8)

Loot System

Enchanted Book Generation:

• Generates 1-3 random non-curse enchantments
• Enchantment levels scale with boss level:
  • Level 3-9: Low tier (1/3 max level)
  • Level 10-24: Mid tier (1/2 max level)
  • Level 25-49: High tier (max level - 1)
  • Level 50+: Maximum tier (max level)

Commands

New Admin Commands:

• disableboss - Marks player as dragon slayer (prevents spawn)
• enableboss - Information command (boss requires manual spawn)
• spawnboss - Forces boss spawn/assignment via spawn manager
• All commands use BossProgressManager for dragon defeat tracking

Separate Base Health System

New Config Options:

• unhostileBaseHealth (default: 80 HP) - Base health for Levels 1-2
• hostileBaseHealth (default: 140 HP) - Base health for Level 3+
• Old baseHealth config deprecated but kept for backwards compatibility

Balance Impact:

• Unhostile phase (L1-2): 80 base HP = easier early game
• Hostile phase (L3+): 140 base HP = challenging combat
• Better progression curve between phases

World Protection System

Protected Blocks:

• BEDROCK
• BARRIER
• COMMAND_BLOCK (all variants)
• END_PORTAL
• END_PORTAL_FRAME
• END_GATEWAY

📊 Stat Comparison (Old vs New)

Health Progression

Damage Progression

Impact: High-level bosses are now beatable without requiring god-tier equipment!

📦 Installation

1. Download evil_companion-1.1.0.jar
2. Place in your .minecraft/mods folder
3. IMPORTANT: Delete old config file:
   • %appdata%\.minecraft\config\evil-companion-common.toml
4. Launch Minecraft 1.20.1 with Forge 47.2.1
5. New config will auto-generate with updated values

⚠️ Breaking Changes

Configuration Changes

• Health and damage formulas completely rewritten
• Old progression values no longer apply
• Action Required: Delete old config file for best experience

Recipe Changes

• Field guide recipe simplified (was: book + 4 sticks, now: book + stick)
• Recipe unlock system changed to advancement-based

🙏 Credits

• Developer: zaber-dev
• Testers: Community feedback from CurseForge
• Special Thanks: All players who reported balance issues

📝 Notes

This update focuses on balance, polish, and quality of life. The diminishing returns system ensures that the boss remains a fun challenge at all levels without becoming impossible. New AI behaviors make the boss feel more alive and intelligent, while the enhanced guidebook helps new players understand the mod's mechanics.

Upgrade from 1.0.0? Yes! All features are compatible. Just delete your old config file.

Multiplayer compatible? Yes! All changes work seamlessly in multiplayer with all three spawn modes.

Performance impact? Minimal. New AI goals are optimized and don't affect server TPS.

Enjoy the balanced chaos! 😈