RevampMySoul

Revamps Artifact of Soul to spawn a 30s timed soul copy of the defeated enemy with 1s spawn invulnerability and Evolution items support.

By FortressForce

https://github.com/FortressForce/RevampMySoul

Date uploaded	3 hours ago
Version	1.0.1
Download link	FortressForce-RevampMySoul-1.0.1.zip
Downloads	3
Dependency string	FortressForce-RevampMySoul-1.0.1

This mod requires the following mods to function

bbepis-BepInExPack

Unified BepInEx all-in-one modding pack - plugin framework, detour library

Preferred version: 5.4.2117

RiskofThunder-HookGenPatcher

MMHOOK generation at runtime.

Preferred version: 1.2.5

Rune580-Risk_Of_Options

A convenient API for adding BepInEx ConfigEntry's to a option menu

Preferred version: 2.8.2

README

Revamp My Soul

Revamps the Artifact of Soul in Risk of Rain 2!

This mod aims to give the Artifact of Soul more bite and variety than just generic wisps you need to fight. Instead of spawning simple Lesser Wisps, defeated enemies spawn an exact soul clone of themselves. Souls render with the authentic Happiest Mask ghost shader, inherit Doppelganger status (InvadingDoppelganger), inherit elite essence (such as Blazing, Overloading, and Glacial), receive Artifact of Evolution items, grant XP on kill, feature a Dio's Best Friend (DBF) invulnerability spawn burst, take hits normally, and live for a strict 30-second timer.

Features

Authentic Ghost Skin: Defeated enemies spawn with the authentic Happiest Mask ghost shader (matGhostEffect), clearly distinguishing them as souls while maintaining full combat interaction.
Optional Wisp Soul Fire: Toggleable setting to envelope souls in bright cyan soul fire flames (BurnEffectController.helfireEffect).
Doppelganger Inheritance: Defeated Invading Doppelgangers pass down their Doppelganger item (InvadingDoppelganger) to create authentic Doppelganger souls.
Kill Credit & 5 XP Reward: Soul enemies grant 5 XP (configurable) upon defeat, allowing mods like Early Bird Sacrifice to reliably register kills.
Elite Essence Inheritance: Elite monsters (Blazing, Overloading, Glacial, Malachite, Celestine, Mending, Voidtouched, etc.) pass on their elite affixes to their soul clone, creating fiery Blazing souls, sparking Overloading souls, and more.
Full Combat Interaction: Hurtboxes remain active so players, turrets, and drones can target, hit, shoot, debuff, and damage soul enemies normally.
Dio's Best Friend Invulnerability: Souls spawn with the iconic Dio's Best Friend invulnerability buff (Immune) and revival sound/burst effect (default: 1.0s) to safely absorb spawn damage.
Artifact of Evolution Integration: When Artifact of Evolution is active, spawned souls automatically receive all monster team items on spawn.
30-Second Lifetime Countdown: Souls die cleanly on a true timer rather than health decay, ensuring monster healing items (like Monster Tooth, Medkit, Bungus) do not grant eternal life.
No Infinite Loops: Defeated souls never spawn another soul upon dying.
Risk of Options Support: Fully configurable in-game in real time.

Configuration

All settings can be configured via the in-game Risk of Options menu or the generated config file:

Setting	Default	Description
Enabled	`true`	Enables or disables the mod entirely.
Require Artifact Of Soul	`true`	If `true`, souls only spawn when Artifact of Soul is active. If `false`, souls spawn in any run.
Enable Wisp Soul Fire	`false`	If `true`, attaches bright cyan wisp soul fire flames across the soul enemy's body.
Soul Lifetime Seconds	`30.0s`	Duration in seconds before the spawned soul expires and suicides.
Spawn Invulnerability Seconds	`1.0s`	Duration in seconds of Dio's Best Friend invulnerability granted on spawn.
Play Dio Spawn Effect	`true`	Plays the Dio's Best Friend revival burst & sound effect upon soul spawn.
Grant Evolution Items	`true`	If `true`, grants monster team items to souls when Artifact of Evolution is active.
Transfer Elite Essence	`true`	If `true`, defeated elite monsters pass their elite affixes (Blazing, Overloading, etc.) to their soul.
Soul Exp Reward	`5 XP`	Experience reward granted on defeat (enables kill registration for mods like Early Bird Sacrifice).
Damage Boost Percentage	`0%`	Optional extra damage bonus for soul enemies.
Enable Debug Logging	`false`	Enables verbose console logging.

Recent Patches

v1.0.1

Multiplayer Networking Fix: Fixed soul enemies being untargetable/unhittable by clients in multiplayer. Shots no longer pass through soul enemies for non-host players.
- Root Cause: The SoulMarker component (a plain MonoBehaviour) only existed on the server, so the client-side hurtbox override never activated — clients saw the ghost skin but couldn't interact with the souls.
- Fix: Replaced SoulMarker-based detection in client-side hooks with inventory-based detection (Ghost item + Monster team), which uses RoR2's built-in Inventory network synchronization to work on all clients automatically.
- Also fixes wisp soul fire VFX not appearing on clients when enabled.

v1.0.0

Initial Release:
- Enemy Soul Clones: Spawns an exact AI clone of the defeated enemy upon death when Artifact of Soul is enabled.
- Happiest Mask Ghost Visuals: Authentic ghost shader distinguishes souls while keeping hurtboxes 100% active and hittable.
- Configurable Wisp Soul Fire: Optional toggle to add blazing cyan ethereal soul flames to soul bodies.
- Doppelganger Inheritance: Passing down InvadingDoppelganger items from defeated doppelgangers.
- Elite Essence Transfer: Inherits elite affixes (Blazing, Overloading, Glacial, Malachite, Celestine, Voidtouched, etc.).
- Dio's Best Friend Invulnerability: Spawn effect, audio cue, and 1.0s invulnerability buff (Immune).
- Artifact of Evolution Support: Automatically grants monster team inventory on spawn.
- 30-Second Timed Lifetime: Strict lifetime timer preventing healing items from stalling death.
- XP & Kill Registration: Grants 5 XP per soul kill for kill-counting mods.
- Risk of Options Integration: Full in-game real-time configuration menu.

Get the Thunderstore App