DOLPA

ArchiveXL MOD for Cyberpunk – Installation Guide(Linux + Steam + Proton)

A practical guide to installing ArchiveXL for Cyberpunk 2077 on Linux with Steam and Proton. Learn how to set it up correctly, verify it through logs, and troubleshoot common issues to ensure advanced mods load and work reliably.

ArchiveXL MOD for Cyberpunk – Installation Guide(Linux + Steam + Proton)

If you’re diving deeper into modding Cyberpunk 2077, you’ll quickly encounter mods that require direct access to the game’s archives. That’s where ArchiveXL comes in. Unlike visible mods with menus or overlays, ArchiveXL works quietly behind the scenes, allowing advanced mods to patch textures, audio, and gameplay data safely.

ArchiveXL is a vital modding tool for Cyberpunk 2077. It allows mods to patch or replace in-game archives (.archive files), enabling more complex mods that directly modify game data. Without ArchiveXL, many advanced mods simply won’t load.

This guide walks you through installing ArchiveXL on Linux with Steam and Proton, explaining each step in detail, showing how to verify the installation, and giving tips to troubleshoot the most common issues. Whether you’re adding new content or enabling complex mods, this setup ensures your game is ready for deeper customization.

1. Requirements

Before installing ArchiveXL:

  • Cyberpunk 2077 has been installed and launched at least once
  • Running via Proton
  • (Recommended) Cyber Engine Tweaks installed – ArchiveXL works with it for better mod support (installation guide is here)
  • Proton version that supports vcrun2022 and DXVK (Proton GE recommended)

2. 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/

Tip: Double-check that Cyberpunk 2077.exe exists in bin/x64/. This is where most mod files will be placed.

3. Download and Extract ArchiveXL

  1. Download the latest release of ArchiveXL from the official repository.
  2. Extract the archive. You should see a folder structure like:
r6/
red4ext/
  1. Make sure your extracted files are ready to merge into the game directory.

4. Copy Files to Game Directory

  1. Navigate to Cyberpunk 2077/.
  2. Copy all ArchiveXL files into the game folder.

After installation, the folder should look like this:

Cyberpunk 2077/r6/config/redsUserHints/
Cyberpunk 2077/ed4ext/plugins/ArchiveXL/

And the DLL file ArchiveXL.dll should be placed in: Cyberpunk 2077/red4ext/plugins/ArchiveXL/

Important: Folder structure must be preserved.

5. Proton Setup

ArchiveXL requires some Windows runtime components to work properly.

Run the following with Proton Tricks:

flatpak run com.github.Matoking.protontricks 1091500 vcrun2022 d3dcompiler_47
  • 1091500 = Steam AppID for Cyberpunk 2077
  • vcrun2022 = Visual C++ 2022 runtime
  • d3dcompiler_47 = Required for shader compilation

This ensures compatibility with most mods that depend on ArchiveXL.

6. First Launch

  1. Launch the game via Steam.
  2. There will be no visible UI—ArchiveXL works silently in the background.
  3. If installed correctly, mods that require ArchiveXL will automatically load.

7. Verify Installation

Option 1: Check log file

Navigate to:

Cyberpunk 2077/red4ext/plugins/ArchiveXL/ArchiveXL-***.log

You should see entries like:

[INFO] ArchiveXL initialized
[INFO] Loaded 3 archives successfully

Option 2: Test with a dependent mod

Install a simple mod that requires ArchiveXL, such as a texture replacement. If the mod works in-game, ArchiveXL is functioning.

8. Troubleshooting

8.1 Game crashes on startup

Causes:

  • Wrong DLL location
  • Conflicting mod
  • Outdated redscript/CET

Fixes:

  • Re-copy ArchiveXL to Cyberpunk 2077/
  • Temporarily disable other mods
  • Ensure Proton GE and vcrun2022 are installed

8.2 ArchiveXL.log missing

Cause:

  • Installation folder incorrect

Fix:

  • Make sure ArchiveXL.dll is in Cyberpunk 2077/red4ext/plugins/ArchiveXL/
  • Ensure folder structure matches the archive

8.3 Mods fail to load

Cause:

  • ArchiveXL installed but scripts disabled
  • Mod placed in the wrong directory

Fix:

  • Enable scripting in CET overlay
  • Verify mod files are in correct folders (r6/scripts/ or r6/mods/)

8.4 Compilation errors or corrupt archives

Cause:

  • Outdated ArchiveXL version
  • Game update changed archive structure

Fix:

  • Download latest ArchiveXL release
  • Reinstall and remove older versions
  • Check mod compatibility with current game patch

9. Best Practices

  • Always backup your game before installing ArchiveXL
  • Keep ArchiveXL and CET updated with game patches
  • Install mods one at a time to isolate conflicts
  • Use Proton GE for the smoothest modding experience
Share Share Share Share Share Email

Read next