Home›Java›Mods›Evil Companion
Evil Companion
ModsJava

Evil Companion

Java mod listed for Minecraft 1.20. Downloads from the MC Java Mods app on Android.

by zaberdev · on CurseForge

Minecraft mod that introduces a dynamic, evolving entity that starts as your mischievous friend but can become your ultimate rival. Unlike traditional…

⬇ Download on CurseForge

The author built this one for Minecraft 1.20.1 on Forge. On other versions it may install and then do nothing.

Open in MC Java ModsGet it on Google Play →

"Your friend. Your rival. Your doom."

📖 Overview

Evil Companion is a revolutionary Minecraft mod that completely reimagines the boss fight experience. Instead of a static encounter, you get a dynamic, evolving rival that starts as your annoying friend but can become your ultimate nemesis. Perfect for players who want a persistent challenge that grows with them!

� Quick Features

Feature Description
🎭 Dual Personality Friendly prankster → Hostile rival
📈 Infinite Scaling Balanced progression from Level 1 to 1000+
👥 Multiplayer Modes SHARED, PER_PLAYER, RATIO, or MANUAL spawning
🧠 Smart AI 15+ behaviors: mining, stealing, climbing, fighting
🎨 Custom Textures Bespoke calm/enraged skins with Steve fallback
🧱 Trap Master Breaks blocks to escape, climbs ladders, uses doors
⚡ Teleportation Follows you across dimensions
🎯 Gear Thief Steals your best equipment and uses it!
🐉 End Boss Defends Ender Dragon, rebuilds crystals
🧪 Peace Items Craft tonics and elixirs for temporary truces
📘 In-Game Guide 16-page field guide with all mechanics explained
⚙️ Fully Configurable 50+ config options for custom difficulty

🌟 What Makes It Special?

Unlike traditional boss mods with one-time fights, Evil Companion offers:

🎮 THE EXPERIENCE

v1.1.0 Update: Now with balanced progression, enhanced AI, and complete field guide!

Level 1: The Mischievous Friend 😊

Your companion spawns at Level 1 and is NOT hostile. Instead, it acts like a playful, greedy player:

Core Behaviors:

The Greed Counter:

Survival Tips:

Level 2: MAXIMUM ANNOYANCE 😈

Everything gets 2x more frequent:

Activity Level 1 Level 2
Mining Every 15s Every 7.5s
Item Stealing Every 30s Every 15s
Inventory Theft Greed 10+ Greed 5+
Chest Raiding Greed 20+ Greed 10+
Griefing Greed 15+ Greed 8+
Teleportation Every 120s Every 60s

🎯 Gear Stealing System!

The companion has a smart gear evaluation AI:

Gear Scoring Algorithm:

Score = Material Value + (Enchantments × 10) + (Durability × 5)

Material Values:
- Netherite: 100
- Diamond: 80
- Iron: 60
- Gold: 40 (but enchants can make it better!)
- Leather: 20

Example: A fully enchanted Diamond Sword (5+ enchants) can be worth MORE than an unenchanted Netherite Sword!

💥 Becoming Hostile

After 3 hits (configurable), the companion becomes HOSTILE:

🌐 MULTIPLAYER FEATURES

Perfect for servers! Three spawn modes to fit any player count:

Spawn Modes:

Mode Description Best For
SHARED (Default) One boss for entire server Co-op teams, small servers
PER_PLAYER One boss per player Competitive servers, solo challenges
RATIO One boss per X players Medium/large servers, balanced gameplay
MANUAL (v1.1.1+) No automatic spawning Event servers, full admin control

1. SHARED Mode (Cooperative)

2. PER_PLAYER Mode (Competitive)

3. RATIO Mode (Balanced)

4. MANUAL Mode (Admin Controlled) NEW in v1.1.1

Advanced Player Assignment:

Edge Cases Handled:

⚔️ COMBAT & PROGRESSION

v1.1.0 Major Balance Update: Completely rewritten progression system with diminishing returns for fair fights at all levels!

Balanced Infinite Scaling (Levels 3+)

Once hostile, the companion scales infinitely with smart diminishing returns:

New Stats Formula (v1.1.0):

Early Game (Levels 1-10): Linear Growth
- Health = Base + (Level × Multiplier)
- Damage = Base + (Level × Multiplier)
- Fast progression for accessible early game

Mid Game (Levels 11-50): Square Root Scaling
- Health = Base + (√(Level - 10) × Multiplier × 8)
- Damage = Base + (√(Level - 10) × Multiplier × 3)
- Moderate progression for balanced mid game

Late Game (Levels 51+): Logarithmic Scaling
- Health = Base + (log(Level - 50 + 1) × Multiplier × 20)
- Damage = Base + (log(Level - 50 + 1) × Multiplier × 8)
- Slow progression prevents impossible fights

Additional Stats:
- Armor = Base + (Level × 0.5), max 30
- Knockback Resist = Level × 5%, max 100%

Balanced Examples:

Level Health Damage Armor Notes
1 120 HP 4 DMG 0 Starting stats (Iron equipment)
10 220 HP 12 DMG 5 End of linear growth
25 420 HP 20 DMG 12.5 Diamond equipment
50 720 HP 28 DMG 25 Netherite equipment
100 1,100 HP 38 DMG 30 Challenging but fair
200 1,560 HP 50 DMG 30 Requires strategy
500 2,100 HP 70 DMG 30 Epic endgame fight
1000 2,700 HP 85 DMG 30 Legendary challenge

Why Diminishing Returns?

Equipment Progression:

The boss automatically upgrades its gear as it levels up:

Level Weapon Armor Enchantments
1-4 Iron Sword Iron Armor None
5-9 Diamond Sword Diamond Armor Sharpness II, Protection II
10-14 Netherite Sword Diamond Armor Sharpness IV, Protection III
15-19 Netherite Sword Netherite Armor Sharpness V, Protection IV, Fire Aspect II
20-24 Netherite Sword Netherite Armor + Unbreaking III on all items
25+ Netherite Sword Netherite Armor + Sweeping Edge III, Looting III
30+ Netherite Sword Netherite Armor All enchantments max level

Special Equipment Features:

Pro Tip: The boss evaluates gear quality intelligently - a heavily enchanted Diamond sword might be worth more than a plain Netherite sword!

Special Abilities:

The boss unlocks powerful abilities as it levels up:

Level Ability Effect Details
1+ Trap Escape Breaks blocks when stuck NEW! Stops breaking during combat
1+ Climbing NEW! Climbs ladders, vines, scaffolding Full navigation freedom
1+ Door Usage NEW! Opens doors, presses buttons, pulls levers Player-like intelligence
1+ Shield Defense NEW! Blocks attacks with shield 5s cooldown, <80% HP only
3+ Speed Boost Speed II-V when below 30% HP Retreat or aggressive chase
5+ Minion Summoning Spawns zombies (1 + Level/5) Up to 20+ minions
7+ Regeneration Regen I-IV (scales every 5 levels) Hard to wear down
10+ Resistance Resistance II-IV when blocking Damage reduction
12+ Fire Aura Burns entities within 3-8 blocks Area denial
15+ Lightning Strike Summons lightning on players Devastating AoE
20+ Weather Control Creates thunderstorms 10min cooldown
30+ Strength Permanent Strength I-III Increased melee damage
40+ Jump Boost Permanent Jump Boost III Superior mobility

Combat Abilities Summary:

Note: All ability levels are configurable in config/evil_companion-common.toml

🧱 Trap Escape & Navigation System:

v1.1.0: Boss now stops breaking blocks when it can attack or reach you directly!

The companion has advanced pathfinding AI to escape traps and reach targets:

Breaking Rules:

Level Can Break
1-2 Soft blocks (dirt, wood, glass, leaves)
3-9 + Stone, cobblestone, ores
10+ ANY block except bedrock

When It Activates:

Smart Detection:

Break Speed:

Navigation Abilities (v1.1.0):

Strategy Tips:

Minion Spawning:

The boss can summon reinforcements during combat:

Examples:

🐉 END DIMENSION MECHANICS

v1.1.0 Complete Overhaul: Fixed all major bugs, improved AI, and balanced spawning!

When the Ender Dragon is alive, the companion gets special powers:

Instant Respawn:

Dragon Defense AI:

1. Rebuild End Crystals 🔮

How it works:

Improvements (v1.1.0):

2. Spawn Reinforcements 🐚

Spawn System:

Improvements (v1.1.0):

3. Aggressive Combat ⚔️

Attack Abilities:

Safety Improvements (v1.1.0):

4. Void Avoidance 🌌

NEW in v1.1.0:

5. Enhanced Priority System ⚡

v1.1.0 Priority Logic:

  1. Crystal Rebuilding (Highest)

    • Check every 10 seconds
    • 40% chance to attempt
    • 10-second cooldown

  2. Helper Spawning (Medium)

    • Check every 5 seconds
    • 25% chance to attempt
    • 5-second cooldown

  3. Combat Abilities (Low)

    • 3-second global cooldown
    • Only targets assigned players
    • One ability at a time

Benefits:

Special Targeting Rules (v1.1.0):

When Hostile in End:

Result: Focused, intelligent combat that feels fair!

💎 LOOT SYSTEM

Killing the boss rewards you with infinitely scaling loot:

Always Drops:

Resource Formula Example (Level 50)
Diamonds Level + (Level ÷ 3) 66 diamonds
Iron Ingots (Level + 5) + (Level ÷ 5) 65 iron
Gold Ingots (Level ÷ 2 + 1) + (Level ÷ 10) 31 gold
Experience 50 + (Level × 10) + (Level^1.3 × 2) ~800 XP

Progressive Drops:

Level Items Drop Chance Notes
5+ Emeralds 100% (Level - 4) + (Level ÷ 5)
10+ Netherite Scrap 100% (Level - 9) ÷ 2 + (Level ÷ 10)
15+ Nether Stars 100% 1 + (Level ÷ 20)
15+ Enchanted Golden Apples 100% 1 + (Level ÷ 15)
25+ Netherite Ingots 100% (Level - 24) ÷ 5
35+ Totem of Undying 30% Chance based
40+ Elytra 50% Chance based
50+ Dragon Egg 100% Legendary prize!
60+ Beacon 100% Ultimate reward!

Enchanted Books:

Boss Equipment:

The boss drops its equipped gear on death:

Pro Tip: High-level bosses drop more loot than Wither and Ender Dragon combined!

🧪 PEACE ITEMS & CRAFTING

Companion Field Guide 📘

NEW in v1.1.0: Comprehensive 16-page guidebook with all mechanics explained!

Recipe: Book + Stick = Field Guide

[  ] [ ] [  ]
[  ] [B] [  ]
[  ] [S] [  ]

B = Book
S = Stick

Contents:

How to Get:

Truce Tonics & Treaty Elixir 🧪

Brew these items to temporarily pacify the boss:

Item Duration Recipe Cost Use Case
Truce Tonic (Simple) 30 seconds Honey Bottle + Glow Berries Quick break
Truce Tonic 45 seconds + Regeneration Potion Exploration time
Truce Tonic (Potent) 90 seconds + Golden Apple Major projects
Treaty Elixir 60 seconds + Dragon Breath + Totem + Netherite Scrap Capture/defeat boss

Effects:

Crafting Location: Standard crafting table Recipe Book: All recipes shown in field guide with visuals

🎮 COMMANDS SYSTEM

NEW in v1.1.0: Complete command system for players and admins!
EXPANDED in v1.1.1: Boss customization commands with professional naming! Also supports /ec shorthand!

Player Commands:

Command Permission Description
/ec guide All players Receive Companion Field Guide book

Admin Commands - Boss Management (OP Level 2):

Command Description Example
/ec remove-boss &lt;player&gt; Completely remove a player's boss /ec remove-boss Steve
/ec set-level &lt;player&gt; &lt;level&gt; Change boss level (1-1000) /ec set-level Alex 50
/ec disable-boss &lt;player&gt; Disable boss spawning for player /ec disable-boss Steve
/ec enable-boss &lt;player&gt; Enable boss spawning (note below) /ec enable-boss Steve
/ec spawn-boss &lt;player&gt; Force spawn/assign boss for player /ec spawn-boss Alex
/ec reload Reload configuration file in-game /ec reload

Admin Commands - Customization (OP Level 2): NEW in v1.1.1

Command Description Example
/ec set-name &lt;player&gt; &lt;name&gt; Change a boss's name dynamically /ec set-name Steve "The Destroyer"
/ec set-texture &lt;player&gt; &lt;normal&#124;hostile&gt; &lt;path&gt; Set custom texture for player boss /ec set-texture Alex hostile mypack:angry.png
/ec set-texture all &lt;normal&#124;hostile&gt; &lt;path&gt; Set texture for ALL active bosses /ec set-texture all normal minecraft:textures/entity/zombie/zombie.png
/ec reassign-boss &lt;fromPlayer&gt; &lt;toPlayer&gt; Transfer boss ownership between players /ec reassign-boss Steve Alex

Features:

Use Cases:

Important: spawnboss command now automatically clears the dragon defeat status, so you can use it after disableboss without issues!

🎨 BOSS CUSTOMIZATION

NEW in v1.1.1: Full customization control for boss appearance and identity!

Customizable Boss Names:

Configure in config/evil_companion-common.toml:

["Boss Appearance"]
    # List of possible boss names (randomly chosen on spawn)
    # Leave empty to use default names
    # Add your own custom names separated by commas
    bossNames = ["Zyren", "Kaelix", "Vorn", "Drayen", ...]

Custom Textures System:

Three levels of texture customization:

  1. Config-Wide Textures (Global default):
["Boss Appearance"]
    # Texture path for normal/unhostile boss appearance
    # Format: namespace:path/to/texture.png (ResourceLocation format)
    # Leave as 'default' to use default player skin or mod textures
    normalTexturePath = "default"

    # Texture path for hostile boss appearance
    hostileTexturePath = "default"
  1. Per-Boss Textures (Admin override):
/evilcompanion settexture Steve normal mypack:custom/steve_calm.png
/evilcompanion settexture Alex hostile horror:entities/ghost.png
  1. All-Bosses Textures (Event override):
/evilcompanion settexture all hostile event:boss_angry.png

Texture Priority:
Per-Boss Command → Config Global → Default Mod Textures → Player Skin

Texture Path Format:

How to Add Custom Textures:

Method 1: Resource Pack (Recommended)

  1. Create folder: .minecraft/resourcepacks/MyBossPack/
  2. Add pack.mcmeta:
{
  "pack": {
    "pack_format": 15,
    "description": "Custom Evil Companion Textures"
  }
}
  1. Add texture: assets/mypack/textures/boss_evil.png
  2. Enable resource pack in Minecraft
  3. Set in config: hostileTexturePath = "mypack:boss_evil.png"

Method 2: Admin Commands (Quick testing)

/evilcompanion settexture Steve normal minecraft:textures/entity/zombie/zombie.png

Customization Use Cases:

⚙️ CONFIGURATION

Over 50 configurable options to customize your experience!

Key Configuration Options:

Difficulty Settings:

# Base stats (v1.1.0+: Separate health for unhostile vs hostile)
unhostile_base_health = 100.0   # Levels 1-2 (easier)
hostile_base_health = 60.0     # Level 3+ (harder)
health_per_level = 10.0
base_damage = 4.0
damage_per_level = 1.0

# Legacy config (deprecated but kept for compatibility)
base_health = 120.0

# Hits before hostile (default: 3)
hits_until_hostile = 3

# Speed boost threshold (default: 30%)
speed_boost_health_threshold = 30

Balance Tip: Unhostile phase (L1-2) uses higher base health (100 HP) for longer friendly interactions. Hostile phase (L3+) uses lower base health (60 HP) for better challenging combats!

Spawn Mode:

# Options: "SHARED", "PER_PLAYER", "RATIO"
spawn_mode = "SHARED"

# For RATIO mode only
players_per_boss = 2

Behavior Toggles:

# Enable/disable features
can_teleport = true
can_steal_items = true
can_steal_from_inventory = true
can_grief_blocks = true
can_mine_blocks = true
can_spawn_minions = true

# Greed thresholds
inventory_theft_greed = 10
chest_raiding_greed = 20
griefing_greed = 15

Ability Unlock Levels:

speed_boost_level = 3
regeneration_level = 7
resistance_level = 10
fire_aura_level = 12
lightning_level = 15
weather_control_level = 20
strength_level = 30
jump_boost_level = 40

Configuration File Location:

Single-Player/Client:

%appdata%\.minecraft\config\evil_companion-common.toml

Dedicated Server:

<server_folder>/config/evil_companion-common.toml

Applying Config Changes:

  1. Option A: Restart Minecraft/Server (always works)
  2. Option B: Use /evilcompanion reload command (requires OP, NEW in v1.1.0)

Important: Delete old config when upgrading from v1.0.0 to v1.1.0 for balanced progression!

📦 INSTALLATION

Requirements:

Installation Steps:

  1. Download the latest version of Evil Companion from CurseForge
  2. Locate your Minecraft installation folder:
    • Windows: %appdata%\.minecraft
    • macOS: ~/Library/Application Support/minecraft
    • Linux: ~/.minecraft
  3. Place the downloaded JAR file into the mods folder
  4. Launch Minecraft with Forge 47.2.1 profile
  5. Verify mod loaded successfully (check mods list in main menu)

First Time Setup:

  1. Join a world or create a new one
  2. Boss will spawn automatically based on config settings
  3. Recommended: Craft the Companion Field Guide immediately (Book + Stick)
  4. Read the guide to understand mechanics

Upgrading from v1.0.0:

  1. Download v1.1.0 JAR file
  2. Delete old config file: config/evil_companion-common.toml
  3. Replace old JAR with new JAR in mods folder
  4. Launch game - new config will generate automatically
  5. Important: Deleting config ensures you get balanced progression formulas!

🔗 COMPATIBILITY

✅ Compatible With:

⚠️ Potential Issues:

🛠️ Troubleshooting:

Boss Not Spawning:

Performance Issues:

Config Not Loading:

❓ FREQUENTLY ASKED QUESTIONS

General Questions:

Q: Can I remove the boss permanently?
A: Yes! Use /evilcompanion removeboss <player> (requires OP). Truce items only provide temporary peace (30-90 seconds).

Q: Does the boss respawn after death?
A: Yes, the boss respawns after 30+ seconds (5 seconds in End dimension). It remembers its level and equipment.

Q: Can I have multiple bosses?
A: Yes! Use spawn_mode = "PER_PLAYER" for one boss per player, or spawn_mode = "RATIO" for balanced spawning.

Q: Is this mod balanced for multiplayer?
A: Absolutely! Three spawn modes (SHARED, PER_PLAYER, RATIO) adapt to any server size. v1.1.0 includes major balance improvements.

Q: Can I disable annoying features?
A: Yes! Configure can_teleport, can_steal_items, can_grief_blocks in config file.

Gameplay Questions:

Q: How do I prevent the boss from becoming hostile?
A: Don't hit it! If you accidentally hit it, use a Truce Tonic to reset hostility.

Q: Can I use traps to kill it?
A: Early levels yes, but it breaks blocks to escape. Level 10+ breaks anything except bedrock. Best strategy: direct combat + mobility.

Q: What's the best way to fight high-level bosses?
A: Balanced approach: Netherite armor (Protection IV), Netherite sword (Sharpness V), Shield, Golden Apples, Potions (Strength, Regeneration), Totems of Undying.

Q: Does it steal my items when I die?
A: No, it only steals from dropped items on ground and directly from your inventory (when greed is high).

Q: Can it break my base?
A: Only if greed is high (15+) or it's trapped. It stops griefing when it can reach you directly (v1.1.0).

Q: Can the boss break End portals or bedrock?
A: No! The boss never breaks or replaces: bedrock, End portals, End portal frames, End gateways, barriers, or command blocks. Your portal home is always safe.

📝 CHANGELOG

v1.1.0 - November 3, 2025

🙏 CREDITS

Developer: zaber-dev

Special Thanks:

Inspiration:

📜 LICENSE

All Rights Reserved

Summary:

🎉 FINAL WORDS

Thank you for choosing Evil Companion! This mod represents months of development, balancing, and community feedback. Version 1.1.0 brings major improvements to make the experience fair and fun for everyone.

Whether you're playing solo or with friends, at Level 1 or Level 1000, we hope you enjoy the unique challenge of having a mischievous friend turned ultimate rival.

Good luck, and remember: Every hit counts. Every level matters. Every fight is personal. 😈

"Your friend. Your rival. Your doom."

Quick facts

Install steps are the general flow for this file type — How to install Minecraft Java mods & modpacks walks through it step by step.

File checked by MCModsHub

These come from our own check of the pack file, not from the source page.

Explore more

All Mods for JavaAll Minecraft Java modsJava mods for 1.20