At a glance
The short version
- Game
- Cyberpunk 2077
- Guide type
- Mods & Extensions
- Read time
- 12 min read
- Last updated
- Nov 22, 2026
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
| Fact | Details |
|---|---|
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
| Item | What 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.
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.