Guide

Cyberpunk 2077 Immersion Patch mod guide: story quest fixes for 2.5 (v1.21.3)

Immersion Patch v1.21.3 fixes over 30 immersion-breaking bugs in Cyberpunk 2077 story quests: stuck phone calls, sliding NPCs, floating props, cut-off dialogue and looping-choice colours shown the wrong way. It works with game version 2.5, it is free on Nexus Mods, and it installs with Vortex or by hand. You need ArchiveXL and Cyber Engine Tweaks; Codeware 1.14.0 or higher is optional and switches on extra runtime patches.

At a glance

The short version

Game
Cyberpunk 2077
Guide type
Mods & Extensions
Read time
12 min read
Last updated
Nov 22, 2026
Cyberpunk 2077 key art. Image: CD Projekt Red.

Quick answer

  • Free mod, Nexus Mods 29152 by anygoodname, version 1.21.3, updated 21 November 2026 for Cyberpunk 2077 2.5.

  • Over 30 fixes across main quests, side quests, gigs and minor quests, each tied to a named quest.

  • Required: ArchiveXL (version 1.28.0 is NOT supported) and Cyber Engine Tweaks. Codeware 1.14.0+ is optional.

  • Install with Vortex, or drop the extracted folders into the game folder by hand.

  • It complements the same author's Minor Activities Quest Fixes. The two mods share some fixes and work together; neither replaces the other.

  • Two fixes can save a playthrough: Firestarter no longer blocks your phone after betraying Songbird, and Just Another Story no longer traps you in a call you cannot save out of.

Guide details

FactDetails

Mod version

1.21.3, updated 21 November 2026

Game version

Cyberpunk 2077 2.0 or higher; developed and tested on 2.12-2.5

Mod page

Nexus Mods 29152, Immersion Patch - Cyberpunk Story Quest Fixes

Author

anygoodname

Required

ArchiveXL (not 1.28.0) + Cyber Engine Tweaks; RED4ext for ArchiveXL

Optional

Codeware 1.14.0 or higher for runtime patches

Phantom Liberty

Includes fixes for Phantom Liberty quests

What this guide covers

  • Install steps, requirements, and the ArchiveXL 1.28.0 warning

  • Main quest fixes, including two that can block progress

  • Side quest and gig fixes, grouped by quest

  • Phantom Liberty fixes

  • How it works with Minor Activities Quest Fixes, conflicts, and uninstall rules

How to install Immersion Patch

  • Install the requirements first: ArchiveXL and Cyber Engine Tweaks. ArchiveXL needs RED4ext to run. Do not use ArchiveXL 1.28.0 — pick any higher or lower version that matches your game version.

  • Optionally install Codeware 1.14.0 or higher. Some fixes in this mod are also shipped as runtime patches that only work with Codeware. Without it, those patches stay inactive and the rest of the mod still works.

  • Install the mod itself with Vortex (automatic), or by hand: drop the extracted folders into your Cyberpunk 2077 game folder and allow overwrites if asked.

  • If a fix does not seem to work, check the requirements first. Without ArchiveXL or CET, some fixes in this mod will not activate at all.

  • Before uninstalling, make sure none of the quests listed below has started without finishing. Then remove the mod files with Vortex, or delete the archive, .xl and CET plugin files by hand.

Requirements and versions

ItemWhat you need

Game

Cyberpunk 2077 v2.0 or higher. Developed and tested on 2.12-2.5. Earlier

2.x versions were not tested.

ArchiveXL

Required. Version 1.28.0 is NOT supported — use any higher or lower version for your game version. Needs RED4ext.

Cyber Engine Tweaks

Required. Any stable version compatible with the supported game versions.

Codeware

Optional. Version 1.14.0 or higher enables the runtime patch versions of some fixes.

Main quest fixes

  • Lightning Breaks: the electric discharge sound no longer keeps playing forever after you leave the power plant control room.

  • Old Friend and Search and Destroy: Takemura's small-talk choices no longer all show in yellow. Looping dialogue now shows in blue, as it should, so you can tell which options you have already picked.

  • The Space in Between: Fingers' cigarette animation stays in sync with his hand, the dead prostitute's body pose is fixed, the anaesthetic gun no longer floats after Fingers, and one of Johnny's cut-off comments is restored.

  • Automatic Love: the large Yakuza bouncer no longer slides across the corridor in the Clouds VIP area clue scene.

  • The Pickup: Royce's gun-pointing animation in the Flathead deal stays in sync, the blue light on Dum Dum's head stops flickering unnaturally, and one of Brick's cut-off lines is fixed.

  • The Rescue: your car no longer drives out of the H10 garage while V is still getting out of it, and Jackie now has his pistols in hand while guarding the bathroom door.

  • The Heist: the Delamain cab no longer rolls forward while V is getting out at Konpeki Plaza, and the Afterlife briefing shard animations for V and Jackie are fixed (Codeware version optional).

  • Life During Wartime: gunfire at the AV crash site no longer sounds like it comes from the left when the site is on your right. The sounds now play centred, which the author notes is a compromise for compatibility.

  • Gimme Danger: Takemura's message setting up the reconnaissance meeting no longer arrives after you have already done the reconnaissance.

Two main quest fixes are worth installing for on their own. In Firestarter (Phantom Liberty), betraying Songbird no longer leaves your phone blocked after the quest ends. In Just Another Story, leaving the destination garage too quickly no longer traps you in a phone call you cannot save out of — before this fix, the only way out was to load your last save and redo the job.

Side quest fixes

  • Following the River: V's beer bottle no longer floats above the table during the porch conversation with River.

  • The Hunt: dialogue choices that loop now show in blue instead of yellow, and one of River's emotional voice lines in the barn is no longer cut off mid-sentence.

  • Ex-Factor: Maiko's purse no longer floats in the air and clips through her body while she talks to Judy in her office.

  • A Cool Metal Fire: a leftover crowd NPC no longer overlaps a scene actor while V buys drinks at the bar.

  • With a Little Help from My Friends: Panam no longer walks back and forth while leaving the trailer in the opening scene.

  • A Like Supreme: Denny and Henry no longer get stranded at the Red Dirt bar after the concert.

  • Pisces: the duplicated tablet no longer floats and moves around Maiko's hand after you pick the no-killing dialogue option.

  • Baby Let Me Take You (Phantom Liberty): Muamar no longer appears twice at the dam meeting point.

  • Talking 'bout a Revolution: Tom's soda can now animates when he drinks, and Maiko's purse no longer floats above the table next to the sofa.

  • Coin Operated Boy: dialogue timing fixes for Polish Brendan voice lines, including cut-offs in the final encounter and long pauses in game v2.31 (the pause fixes need Codeware 1.14.0+).

  • Pepe at El Coyote: English and Polish voiceovers no longer cut off early from dialogue timing issues.

Gig and minor quest fixes

  • Backs Against the Wall (Regina's gig): Cpl. Hare no longer slides across the room during the peaceful resolution, and his chair lines up with his idle animation instead of floating.

  • Talent Academy (Mr Hands' gig, Phantom Liberty): the quest music now stops when the quest ends, including after saving and reloading, and V's seating position next to Tommie no longer sinks into the ground.

  • Sparring Partner (Dakota's gig): a duplicated quest objective interaction in one solution path is fixed.

  • Burnaku: dialogue lines no longer show as new when they were already used in the sofa conversation.

  • Dressed to Kill: the floating quest objective vehicle is fixed and now behaves consistently however you approach it.

  • The Show Must Go On (Mr Hands' gig follow-up, Phantom Liberty): crowd NPCs no longer sit in V's seat when meeting Steven Santos in the Wellsprings cafe.

  • Woman of La Mancha (Regina's gig, Nomad lifepath): Anna Hamill now moves to the new Aldecaldos camp after the quest, depending on your choices.

  • Spy in the Jungle (Mr Hands' gig, Phantom Liberty): V no longer gets a message from Ana about the quest long after it is finished.

  • Roads to Redemption (Mr Hands' gig, Phantom Liberty): standing up in the opening scene no longer pushes V into the table.

  • Heaviest of Hearts (Mr Hands' gig): a guest progress dialogue option no longer shows in the wrong colour among the bartender's blue options.

  • Epistrophy: the angry woman in the Delamain reception scene no longer sinks below the ground while walking out.

  • Space Oddity: arriving by vehicle and driving off quickly no longer breaks the opening scene animations, and the quest guidance is no longer overridden by the main quest auto-tracking.

  • I'll Fly Away: Mitch's and Scorpion's parked cars no longer visibly float.

  • Just Another Story (Phantom Liberty courier job): leaving the destination garage too quickly no longer traps you in a call with no way to save. See the main quest note above.

Before: Cpl. Hare slides across the room in Backs Against the Wall. Image: anygoodname via Nexus Mods.
After: Cpl. Hare stays in place in Backs Against the Wall. Image: anygoodname via Nexus Mods.

Phantom Liberty fixes

  • Firestarter: the phone is no longer blocked after completing the quest when you betray Songbird.

  • Somewhat Damaged: animation and sound desynchronisation in the Songbird birthday party scene is fixed.

  • Black Steel in the Hour of Chaos: flames and sparks at the ambush site no longer remain after the quest is done.

  • Talent Academy, The Show Must Go On, Spy in the Jungle, Roads to Redemption, Baby Let Me Take You and Just Another Story are covered in the gig and side quest sections above.

Fixes shared with Minor Activities Quest Fixes

Three fixes in this mod also appear in the author's Minor Activities Quest Fixes mod: Trevor's Last Ride (a floating license plate in front of Trevor's car), Freedom (a quest vehicle left in the middle of a road, plus a restored scene on entering the first quest site), and These Boots Are Made for Walkin' (the floating Galena Rattler quest car). The two mods share this subset on purpose. They are aware of each other and decide between them which one handles these fixes, so you can run both without duplicate processing. Installing this mod does not replace Minor Activities Quest Fixes, and the author says all of their quest and scene bug fixing mods complement each other.

Note: some of the shared fixes need Codeware 1.14.0 or higher. That is not a hard requirement — if Codeware is missing, the mod adjusts and those patches stay off.

Conflicts, load order, and limits

  • This mod mixes directly replaced game files, ArchiveXL edits and CET runtime scripts. Other mods that change the same quest data in the same way can override it, or be overridden by it. For file replacers, load order decides; for ArchiveXL and CET changes, load order does not matter.

  • File replacers in this mod are designed to load first, so they usually win over other mods touching the same files. If you prefer another mod to win, use a load order tool such as the Archive Conflict Checker Tool.

  • Some file replacer fixes are also shipped as runtime patches (marked on the mod page). With Codeware installed, those patches merge with files already changed by other mods, so both sets of changes can apply.

  • Because the mod targets specific quest data in specific quests, the author states it cannot cause general issues with other mods. Any conflict would be limited to those data changes.

  • The author is clear about scope: this mod fixes the most outstanding immersion-breaking issues, not everything. Some quest details were designed years ago and no longer fully line up with later game updates, and restoring full consistency would take major work that a future update could undo.

  • More fixes may be added later. The mod page lists this work as in progress.

FAQ

Do I need Phantom Liberty to use Immersion Patch?

Yes. Most fixes are for base game quests. The Phantom Liberty fixes only apply if you own the expansion; they do nothing without it.

Can I install it mid-playthrough?

The mod page gives no blanket mid-playthrough promise. The safe rule it does give is for uninstalling: only uninstall when the listed quests have neither started or are already completed. Back up your saves before installing any mod that edits quest scenes.

Do I need Codeware?

No. Codeware 1.14.0 or higher is optional. Without it, the runtime patch versions of some fixes stay inactive and the rest of the mod still works. With it, those patches apply and can merge with other mods that replace the same scene files.

Does it replace Minor Activities Quest Fixes?

No. The two mods share a small subset of fixes and are built to run together. Install both if you want the full coverage from this author.

What if a fix does not work?

Check the requirements first — without ArchiveXL or CET, some fixes will not activate. Then confirm the mod and its requirements are on the latest supported versions, and test with other mods disabled except the requirements before reporting an issue.

Was this helpful?Your vote is stored on this device only.