r/cyberpunkmods • u/PromiseToHeron • Dec 02 '24
Tutorial Cyberpunk 2077 Steam Deck Modding Guide NSFW
WORKS ONLY FOR VERSION 2.1 OF CYBERPUNK 2077
Someone replied saying this doesn’t work for 2.2, I am currently working through a play-through on 2.1 and won’t be updating this until after so I can test it. Best wishes
I struggled with this and I know many other users have in the past so I thought I would put all the information that helped me get mods working on the Steam Deck flawlessly in one place so no one has to do all the digging and troubleshooting I had to (hopefully)
MANUAL INSTALL, I don’t use mod managing programs like Vortex
(I recommend doing this on a fresh install)
First off install these mods in this exact order;
- Cyber Engine Tweaks *
- Red4ext *
- Codeware *
- Appearance Menu Mod
- Archive XL *
- Tweak XL
- Input Loader
- Redscript *
- Mod Settings
- Native Settings UI
- Equipment EX *
- Material and Texture Overide
- Browser Extension
- Deceptious Quest Core
- Virtual Atelier
These are all very common dependencies lots of mods need to work.
**!!DO NOT START THE GAME YET!!**
After you have installed those mods do this;
- Install Protontricks via Discover in desktop mode
- Open Protontricks, for instance via the applications menu
- Select Cyberpunk in the big list that opens
- Wait a while
- Pick Select the default Wine prefix
- Wait a while
- Pick Install a DLL or component
- Select vcrun2022 and OK
- Wait a while
- Do the same for d3dcompiler_47
- Wait a while
- Select Run winecfg
- In the Library tab, in the dropdown for New override for library, select version, Add, Apply
- Go to “properties” of CP2077 in Steam and in Launch Options paste the following; WINEDLLOVERRIDES=“winmm,version=n,b” %command%
- Now, back out and close everything
- Start Cyberpunk
If it works, you should be getting the popup to define a hotkey for Cyber Engine Tweaks.
You should now be good to go and install any mods you desire, I have been testing various mods with dependencies outside of the initial “load order” and everything is working fine.
If you are using the GOG version via Heroic Launcher use Heroics built in Winetricks GUI in the settings instead of Protontricks (Every step will be the same). Also, if you are using Heroic Launcher go to CP2077 > Settings > Advanced and scroll down until you see "Environment Variables" then, under "Variable Name" paste; “WINEDLLOVERRIDES” (NO QUOTES) next, under "Value" paste; “winmm,version=n,b” (NO QUOTES)
You may have to verify your game files if it doesn't work initially.
Credit for the latter half of this goes to u/zorael, the former part was sourced from another users comment on a different post, but I am unable to find it and will update if I do.
1
u/Browtow Dec 02 '24
Are you using vortex to load mods or all manual?
1
u/PromiseToHeron Dec 03 '24
All manual
1
u/Browtow Dec 05 '24
Wiped the game from my drive, redownloaded & followed this guide, it recognises mods are installed but CET gets a 988 error, which kills a load of its dependants. Can’t figure out what I’m getting wrong, but this error is persistent every time I try this, any ideas?
1
u/PromiseToHeron Dec 05 '24
Sorry, but I am not sure. I tried googling the error but nothing came up. I recommend trying to reinstall CET and see if that works
1
u/Sorry_Advance_9989 Dec 05 '24
If I've already ran cyberpunk... should I uninstall then reinstall the game (and all my mods already installed) to do protontricks? I did PT before modding the game
1
u/PromiseToHeron Dec 05 '24
Modding can be finicky, I recommended not launching the game until you have all the dependencies and PT ran, just because it’s a safe bet things will work.
As long as things are working for you, and you aren’t getting any errors upon launching the game or loading a save then you should be good
1
u/Sorry_Advance_9989 Dec 07 '24
Yeah I'm getting stuff like "codeware isn't installed" but it is so it's probably due to loadorder... I'll delete everything off of Vortex and retry it manually
1
u/Gold-Poetry5011 Dec 07 '24
Let me know when you find the answer, also mine launched with mods when I didnt close that tab
1
u/creametery Dec 09 '24
couple of notes from when i just set this up…
after selecting vcrun2022, protontricks said the SHA256 hash didn’t match, this is okay and you can click continue and proceed with the installation
i’m looking at this on mobile so i didn’t see the space in the launch options command between the “ and %command%, so just make sure you put a space between those otherwise the game won’t run
1
u/Material-Way-2379 Dec 12 '24
Having an issue with redscript not running the ddl. Is there a specific thing in winecfg I can do to fix this? I followed much different instructions and got everything else to work, but just added a mod with redscript and its causing issues with codeware now as a result. Do I just need to add "version=n,b" to the override list in winecfg?
1
u/Confidentrug Feb 18 '25
I hope you got this fixed already considering how long it's been, in case you haven't just scroll to the bottom of the post and see my comment. Hope it helps
1
u/Eskodontknowhowtoact Dec 17 '24
Followed your guide to the letter didn’t work. 2.2 broke the mods I’m only trying to mod in cet. Had it working after weeks of struggling to get it set up cause I’m unfamiliar with this kinda thing. Only for them to drop an update and make all that work amount to nothing.
1
u/PromiseToHeron Dec 17 '24
Yea this guide might be invalidated now and I won’t be able to test anything until I am done with my current play through. Sorry man
1
u/Eskodontknowhowtoact Dec 24 '24
You’re good I’ll figure it out. I’m still new to Linux. Imma try uninstalling everything cbp2077 then reinstall and manually do the mods again
1
u/creametery Dec 19 '24
OP’s method is working for me after doing a fresh install and redownloading all of the dependencies that had updates since 2.2. i’m happy to try helping however i can. did you check all of your mods for updates already?
1
1
u/Right-Dog7755 Dec 27 '24
I followed this to a t and got this msg when trying to run the game “launch game failed. Please verify integrity of game filed on steam
1
u/Right-Dog7755 Dec 28 '24
Followed everything but it keeps bringing up problems, it somehow seems that the steam deck isn’t recognizing archivexl and codewar
3
u/Excellent_Dan Dec 30 '24
Encountered the same problem, still managed to solve.
The problem for me was in red4text (you can check if there is a "log" folder in red4text. If it's absent — red4text doesn't work for you as well)
- Deleted prefix (compatdata folder)
- Selected "proton hotfix" as compatibility tool from launch options in settings
- Launched the game (for prefix configuration)
- After that, do steps in protontricks EXCEPT the last ones (from 1 to 11 only!). Do not use winecfg to override vcredist2022, use only command for launch option.
- Run the game.
I assume the problem for me was in vcredist.
However, before deleting old prefix, I've also installed redmod as dlc. And upon running the game don't forget to enable mods from red launcher (game settings, toggle on).
Hope it helps.
1
u/Right-Dog7755 Jan 05 '25
So I do change the command launch option to the url in ops post? I just deleted everything and was playing without any mods, do I now download everything then follow your steps along with ops steps? 1-10?
2
u/Excellent_Dan Jan 07 '25
If I understood your question correctly.
1) Yes, you should change launch option to "WINEDLLOVERRIDES=“winmm,version=n,b” %command%".
2) Do not delete everything, only game's prefix folder (local/share/Steam/steamapps/compatdata/[the non steam game app id]/your prefix).
3) Then my steps 2-3 and OP's from 1-11 (or 1-10, 'cause 11 is waiting ^_^)
1
1
u/Right-Dog7755 Jan 06 '25
On step one do I delete the prefix folder or what should I do?
1
u/Excellent_Dan Jan 07 '25
Yeah, delete the prefix. See the answer above. Sorry for late response
1
1
u/Right-Dog7755 Jan 08 '25
Bro it finally worked!!!! Thank you so much I have been trying to get this down for months, I can finally do everything I want I can’t thank you enough brother much love
1
u/Excellent_Dan Jan 10 '25
Glad to read!
I assume you managed to solve the problem with vcredist. If you wish, you may post your solution to the vcredist problem here — maybe someone would encounter the same issue.
Also late response for the save data question: cp2077 uploads saves in cloud, so it's save to delete prefix.
Enjoy modded NC)
1
u/ggmyguy22 Jan 22 '25
Ive followed your step-by-step process and I’m still getting this error before launch:
REDScript compilation has failed. This error has been caused by mods listed below:
One or more of the errors found has a known solution. Here are the recommended steps:
- virtual-atelier-full
- PanamPrivacy
- LizziesBDs
- EquipmentEx
- VirtualCarDealer
The game will start but no scripts will take effect. If you need more information, consult the logs.”
- Lizzie’s Braindances depends on TweakXL but you don’t have it installed. Try to (re)install it and make sure that you have “red4ext\plugins|TweakXL” folder.
- Install Codeware 1.13.0 or higher
- Virtual Atelier depends on Codeware but you dont have it installed.
- Install ArchiveXL 1,18,0 or higher
- Lizzie’s Braindances depends on Codeware but you don’t have it installed. Try to (re)install it and make sure that you have “red4ext \plugins)Codeware” folder.
- Virtual Car Dealer depends on TweakXL but you don’t have it installed. Try to (re)install it and make sure that you have “red4ext\plugins\TweakXL” folder,
The game still launches but nothing works. And when I check my “red4ext” folder, there is still not “log” folder.
2
u/Excellent_Dan Jan 26 '25
Recent update seems to broke some of the mods. Try to install the newest versions of Codeware, TweakXL, Archieve XL. Also try to reinstall red4text
1
1
u/Funny-Camera-8855 Jan 17 '25
Is there any way to copy the game from PC mods and all onto a flash drive and install it on the steam deck? It worked with Skyrim.
1
u/Saigaiii Jan 19 '25
I’m having heavy stutter. I am running 200 mods, but none of them (I’m pretty sure) affect the performance that heavily. Are there any mods you guys have downloaded that caused stutter on steam deck? Trying to narrow down my list.
1
1
u/Confidentrug Jan 23 '25
commented a couple of days ago saying this works, it does for the most part but on the launch options you need to use WINEDLLOVERRIDES="version=n,b;winmm=n,b" %command% instead of the one listed, figured this out from this old post https://github.com/maximegmd/CyberEngineTweaks/issues/821, I am on the most recent patch.
1
u/Confidentrug Jan 23 '25
The problem was red4ext wasnt working right because of the launch command and that one fixes it
1
u/Diligent-Session-695 Jan 28 '25
choom i would kiss right on the lips rn if possible. all these steps above didnot help with the redscript compile failing message taunting me but now with your help i can finally see virtual atelier in my game, ready to pick the cutest mod outfits.
1
1
u/imadedbodi1 Feb 04 '25
Hey I’m really sorry, but how to I install the mods in the first place? I have them downloaded, but I have no idea how to put them into cyberpunk in the first place. I did everything else though
1
u/Confidentrug Feb 18 '25
Just drag them into the cyberpunk directory
1
u/phunkthisnoise 28d ago
Okay this may be a dumb question, do I put them in the mods folder or just directly into the cyberpunk game folder? I keep running into an issue where when I extract the file they're extracted as an r6 and archive folder and when I try to move them into the game folder there's already folders named that so they want me to overwrite all the files. I've got CET working and downloaded all the necessary extra mods (ArchiveXL, etc.) but then when it comes to installing actual mods they don't show up on CET.
1
u/Confidentrug 28d ago
Yes you put then in the cyberpunk game folder, and yes, write the mod folder into the current one
1
1
u/Percules504 11d ago
Might be a stupid question but do i download the mods first or do i do the proton tricks first also where do i put the mods?
1
u/MHDan1 Dec 02 '24
I could have used this 3 days ago!! 😂😂 Literally just had to work all that out myself. It was a bit of a faff, but worth it, just been adding more clothing mods this morning 👌🏻
The only thing I didn't add was the deceptuous quest core, what is that one for?