If you’ve already started exploring mods for Cyberpunk 2077, you’ll quickly notice that some of them simply refuse to work without a proper scripting layer behind the scenes. That’s where redscript comes in. Unlike more visible tools such as Cyber Engine Tweaks, it operates quietly in the background, enabling deeper gameplay changes and system-level modifications.
This guide walks through installing redscript on Linux using Steam and Proton, with a focus on doing it correctly the first time—and knowing exactly how to troubleshoot it when things don’t go as planned.
Here is a detailed, structured installation guide for redscript, written in the same clear and practical style, with extra attention to troubleshooting.
1. What is redscript?
redscript is the scripting layer that allows deeper gameplay and system-level mods to function.
If Cyber Engine Tweaks handles Lua-based mods, redscript handles compiled game scripts.
In practice, this means:
- Many gameplay mods will not work without it
- It modifies how the game loads internal logic
- It runs automatically in the background (no UI)
2. Requirements
Before installing redscript, make sure:
- Cyberpunk 2077 is installed and launched at least once
- Running via Proton
- (Optional but recommended)
- Cyber Engine Tweaks installed (the installation guide is here)
3. Locate Game Directory
Flatpak Steam:
~/.var/app/com.valvesoftware.Steam/.local/share/Steam/steamapps/common/Cyberpunk 2077/
Native Steam:
~/.steam/steam/steamapps/common/Cyberpunk 2077/
4. Install redscript
- Download the latest redscript release
- Extract the archive
You will typically see:
engine/
r6/
red4ext/
- Copy Files
Copy everything into the game root:
Cyberpunk 2077/
Allow folder merging when prompted.
5. Expected Structure
After installation, you should have:
Cyberpunk 2077/r6/scripts/
Cyberpunk 2077/engine/config/
Cyberpunk 2077/red4ext/
If these folders are missing → installation is incorrect.
6. Proton Notes (Important)
Unlike CET, redscript usually does NOT require extra DLLs, but it depends on a working Proton environment.
Still, if you already use:
flatpak run com.github.Matoking.protontricks 1091500 vcrun2022 d3dcompiler_47
—keep it. It improves compatibility across all mods.
7. First Launch
Launch the game from Steam.
You will NOT see:
- Any menu
- Any overlay
- Any prompt
This is expected.
redscript works silently.
8. Verify Installation
Since there is no UI, verification is done through logs.
Check Log File
Navigate to:
Cyberpunk 2077/r6/logs/redscript.log
Open it:
cat redscript.log
✅ Successful Output Example
You should see lines like:
[INFO] redscript initialized
[INFO] Compiling scripts...
[INFO] Compilation successful
❌ Failure Example
[ERROR] Failed to compile scripts
This means something is wrong (see troubleshooting below).
9. Troubleshooting
9.1 Game crashes on startup
Possible causes:
- Incorrect file placement
- Conflicting or broken mod
- Outdated redscript version
Fix:
- Reinstall redscript cleanly
- Remove recently added mods
- Ensure version matches your game patch
9.2 redscript.log is missing
Cause:
- redscript not installed correctly
Fix:
- Re-copy files into:
Cyberpunk 2077/
- Make sure the folders are merged properly
9.3 Script compilation errors
Example:
[ERROR] syntax error in script
Cause:
- Broken or incompatible mod
Fix:
- Remove mods from:
Cyberpunk 2077/r6/scripts/
- Add them back one by one
9.4 Mods not working (but game runs)
Cause:
- redscript installed, but no mods using it
- Or mods placed incorrectly
Fix:
- Verify mod instructions
- Check correct folder:
r6/scripts/
9.5 After game update everything broke
This is very common.
Cause:
- redscript version mismatch
Fix:
- Download latest redscript version
- Replace old files
10. Final Notes
- redscript is invisible but essential
- It does not provide UI—only backend functionality
- Safe to reinstall anytime
- Must be kept up-to-date with game patches
11. How it Fits Together
In a typical mod setup:
- Cyber Engine Tweaks → UI + scripting
- redscript → gameplay logic
- Native Settings UI → mod configuration menus
Together, they form the core modding stack for Cyberpunk 2077.