
Dark Doppelganger
A high-difficulty boss mod for 1.20.1 and 1.21.1 inspired by dark magic, spellcasting combat, and multi-phase encounters and Heavily by Irons Spells and Spellbooks!
The Dark Doppelganger is a powerful spell-casting enemy that mirrors player strength, summons minions, and escalates as the fight goes on.

🧿 The Dark Doppelganger Boss
The Dark Doppelganger is a multi-phase boss fight designed for experienced players.
Boss Features
- Multi-phase combat with increasing difficulty
- Spellcasting melee and ranged attacks
- Teleports back from the void if knocked off the world
- Summons hostile minions during combat
- Dynamic boss music and boss health bar
- Scales stats and abilities based on configuration
- Designed for multiplayer encounters (supports multiple players fighting at once)
🔮 Boss Phases
- Phase 1: Standard spellcasting and melee attacks
- Phase 2: Increased aggression and new spell combinations
- Final Phase: Frequent minion summoning, life-drain abilities, and high pressure combat
The boss cannot be cheesed easily and is intended to feel like an end-game encounter.
👁️ Minions
The Dark Doppelganger can summon hostile minions during the fight.
Minion Behavior
- Attack players aggressively
- Do NOT attack the boss or other boss minions
- Automatically choose nearby players as targets
- Despawn when the boss is defeated
- Not player-owned and cannot be controlled
Minions are designed to pressure players, not act as companions.
Custom Items

- Shadow Orb - Summon Doppelganger item
- Doppelganger - Ring +150 Mana +30 Health
- Elder's Necklace - +200 Mana +25% Eldritch Spell Power
- Summoner Necklace - +225 Mana +25% Summon Damage
📜 Custom Spells
This mod includes two custom spells, used by the boss and its minions.
- Jump Portal - Jump/evade fast spell

- Summon Minion - Lets you summon your own minion

⚠️ Important
Summon Minion spell is NOT learnable by players and does not appear in the Scroll Forge.
These spells are used exclusively by the Dark Doppelganger and its summons, but defeating the boss gives you a chance at a spell drop!
🧙 Spellcasting System
- Uses Iron’s Spells & Spellbooks
- Fully integrated with spell schools, effects, and animations
- Compatible with other spell-based mods
How to Summon the Dark Doppelganger
⚠️ The Dark Doppelganger is intended to be a dangerous encounter.
- Use a Shadow Orb in the End. Throw it into the void.
⚙️ Configuration
Most values are configurable:
- Boss health
- Damage
- Armor
- Spell power
- Minion strength
- Hard Mode toggles
⚔️ Intended Experience
- Challenging, cinematic boss fight
- Multiplayer-friendly
- Spell-heavy combat
- No PvP abuse or player-owned combat minions
- Designed for late-game or modpack progression
🖤 Final Notes
This mod is built to feel like a true magical boss encounter, not a standard mob fight.
Prepare well.
Good luck.
Dependencies
1.21.1 Now available for NeoForge
To enjoy the Dark Doppelganger mod, ensure the following dependencies are installed:
- Forge (Version: 47.4.10 or higher)
- Iron's Spells 'n Spellbooks (Version: 3.15.0 or higher)
- Curios API (Version: 5.7.0+1.20.1 or higher)
- Caelus API (Version: 3.1.0+1.20 or higher)
- GeckoLib (Version: 4.4.5 or higher)
- Player Animator (Version: 1.0.2-rc1+1.20 or higher)
All Versions
+ Add VersionFixes
- Removed extremely large world-wide entity scans used during server shutdown and level unload. ( Fix for mods like Sable )
- Fixed compatibility issues caused by those global entity scans, including Sable preventing the server from shutting down.
- Removed broad minion cleanup scans on player logout, respawn, and dimension changes.
- Fixed minions being able to get removed because an unrelated nearby player logged out or changed dimensions.
- Removed the now-unused ServerEvents event subscriber to prevent NeoForge mod-loading errors.
- Fixed boss music logic repeatedly sending stop-music packets during the fight.
- Fixed boss music failing to restart correctly after reaching the end of its timer.
- Limited boss music cleanup to nearby players instead of affecting the entire server.
- Fixed the boss laugh sound previously being played with zero volume in one location.
- Added a shared cooldown to boss laughs so they no longer play excessively.
- Fixed void recovery logic so the boss can recover in any dimension instead of relying on a hardcoded End-only check.
- Improved boss state persistence across saves and server restarts.
- Changed summoner tracking to use UUIDs instead of storing a direct player reference.
Minion Improvements
- Boss-spawned minions now store the UUID of the specific Dark Doppelganger that created them.
- Minions now clean themselves up if their owning boss no longer exists.
- Bosses only remove minions that actually belong to them.
- Minion ownership now persists through world saves.
- Boss minions inherit the boss’s active target when summoned.
- Removed unused global minion-count tracking.
Boss Recovery
- Added automatic recovery teleporting when the Dark Doppelganger becomes stranded below the player.
- If the boss remains significantly below the player for several seconds, it attempts to teleport back to a safe nearby position.
- Added immediate recovery if the boss falls below the world’s build floor.
- Recovery teleport searches for valid ground and collision-free space near the player.
- Rescue teleporting is separate from offensive teleport abilities and works in every phase.
- Added cooldowns to prevent rescue teleport spam.
New Doppelganger Mechanics
Mirror Adaptation
- The boss now tracks repeated damage types used against it.
- Repeatedly using the same type of attack causes the Doppelganger to temporarily adapt to it.
- Adapted attacks deal reduced damage for a limited time.
- Adaptation becomes stronger during the final phase.
- Switching attack types prevents the player from relying on a single repeated strategy.
Live Weapon Mirroring
- The Doppelganger periodically copies the player’s currently equipped main-hand weapon.
- Changing weapons during the fight can cause the boss to update its own weapon.
- Weapon mirroring stops during the final phase as the Doppelganger becomes less dependent on directly copying the player.
Mirror Theft
- Replaced frequent automatic buff removal with a dedicated ability.
- The Doppelganger can steal selected beneficial effects from the player.
- Stolen effects are removed from the player and temporarily applied to the boss.
- Added visual effects and messaging when a buff is stolen.
Mirror Clones
- Added temporary Dark Doppelganger clones during later phases.
- Clones copy the boss/player equipment appearance.
- Clones can actively attack the player.
- Clones use reduced health and damage compared to the main boss.
- Clones automatically disappear after a limited lifetime.
- Clone deaths no longer trigger normal boss death logic or rewards.
Shadow Echo
- The boss now records the player’s recent movement.
- It can summon a Shadow Echo that replays the path the player previously took.
- The echo damages players who intersect with its replayed path.
- Shadow Echoes wear copied player equipment and disappear after completing their replay.
Shadowstep
- Added offensive teleporting during later phases.
- The boss can teleport behind distant targets when enough space is available.
- Teleporting uses the existing portal visual effects.
- Added collision checks to reduce teleporting into invalid locations.
Phase Changes
- Phase 2 is now presented as Reflection Broken.
- Final phase is now presented as Shadowfall.
- Phase transitions now initialize the new clone, teleport, echo, and Mirror Theft systems.
- Later phases use shorter ability cooldowns and stronger adaptation.
- The final phase increases pressure through more frequent Doppelganger-specific abilities.
Audio Changes
- Added a global laugh cooldown.
- Routine boss abilities now respect the same laugh cooldown.
- Life Drain, Mirror Theft, and adaptation only have a chance to trigger a laugh.
- Clones do not trigger boss laughs.
- Laughs should now occur primarily during meaningful ability moments instead of repeatedly throughout combat.
Internal / Technical
- Added persistent NBT data for:
- Summoner UUID
- Phase state
- Clone state
- Minion ownership
- Ability cooldowns
- Rescue teleport state
- Reduced unnecessary entity queries.
- Reduced unnecessary network sound packets.
- Improved cleanup behavior for spawned boss entities.
- Improved compatibility with large modpacks and entity-management mods.
- Updated all dependencies and NeoForge version to insure all is working on latest!
Buff minion summon to be more spell casting focused
Minions got a buff Default spells and health better, new config to set there health different from boss minions.
Minions and Boss now copy the players skin that summon them!
Updated to latest 3.15.4 Irons and Curios 5.14.1
New config to disable weapon and or armor copying
Updated dependencies and Neo versions
Updated to the latest 3.15.4 Irons, Curios 9.5.1, and GeckoLib 4.8.3
New spells new ai works with latest 3.15.0 irons!!
New spells new ai works with latest 3.15.0 irons!!
- Ported from CF
- Ported from CF
- Fixed advancement triggering on clones/minions
- Fixed items/loot dropping on clones/minions
- added new command to summon doppelganger via closet person not command executor /darkd summon_doppelganger
- Fixed minions/clones not following Config's of main boss
- New summon animation
- New irons spell
- Logic and perfromance updates
- huge update to the boss
- improved logic
- improved AI
- imrproved damage and other stats
- new phases and abilities
- overall difficulty increased
- increased HP to 4,000
- Increased clones to 50% hp
- updated logic of Doppelganger
