In this section, you can look up information like "what is the material name for skin color type 3 again" or "where are the Mantis blade arms".

Detailed information should go in other sections and be interlinked.

The pages following this aim to give a detailed view of the resources that make up each vehicle in the game, with the hope that you'll be able to create (not just modify) vehicles for the game.

This section collects

• look-ups about equipment (preview pictures and spawn codes)

• documented variants per item

Please use the wiki page tree to find the section's content, or click on the next link at the bottom of this page.

Appearance Menu Mod has its own documentation at…

You can find help on their Discord.

redmod resource-export -depot=<depot> -input=<resource-path> -output=<file> -<optional parameters>

PARAMETERS

    -depot=<depot>                  - directory-path to the depot (e.g. "C:\depot")

    -input=<resource-path>          - resource path of the file to export (relative to depot)

    -output=<file>                  - absolute path to the output file

REDmod can export REDengine .xbm files to several raw formats for editing.

dds: DirectDraw Surface bmp: Windows Bitmap jpg: Joint Photographics Experts Group tga: Truevision Targa png: Portable Network Graphics

XBM PARAMETERS

    -bitmap-mipmap=<uint>           - mipmap selection

    -bitmap-source=<bool>           - export uncooked file (default = false)

    -bitmap-flip=<bool>             - flip texture (default = false)

    -bitmap-gamma=<bool>            - forced gamma setting (default = false)

redmod resource-export -depot="M:\" -input="base\test\example.xbm" -output="M:\base\test\example.png" -bitmap-flip=true

Optional Parameters for meshes

-lod=<uint>           - Defines mesh's lod to be exported
-mesh-skinning=<bool> - export skinning (armature data) default is false

Example Command:

redmod resource-export -depot="M:\" -input="base\test\example.mesh" -output="M:\base\test\example.fbx" -lod=1 -mesh-skinning=true

This is the dedicated repository for modding guides, resources and know-how.

If you're browsing this in github: Please head to instead!

MO2 (Mod Organizer 2) is a free mod manager widely used in modding Bethesda games like Skyrim or Fallout. It supports Cyberpunk and is easy to use.

Installing mods

• Install MO2

• Install CET and Red4ext manually (or with rootbuilder). These mods are script extenders and must be in the roor game folder.

• Install the rest of the mods simply with the Nexus "install with manager" button

That's all. Using MO2 leaves your base game directory untouched, and you can easily install and uninstall mods, update old mods or use profiles.

To dowload the tool and know more about it, go to the WolvenKit Wiki:

WolvenKit is an open-source modding tool for Cyberpunk 2077 and The Witcher 3: Wild Hunt. Our vision is to develop a standalone software which can read and write all REDengine file formats, simplify and accelerate modding workflows, and help you create great mods for great games.

Added:

1. Load mod load order from a text file. by Auska

   • RedMod deploys a list of mods in order - passed through the command line.

     This change now makes it you don’t have to pass the names in the command line but read it from file.

     We can specify load order of archives in another load order file.

2. Fix mesh Export paths and allow exporting to non-base resource paths. by Mana Vortex

   • The fbx importer would throw an error if in the resource path there wouldn't be base

--- Example:

❌/environment/decoration/industrial/pipes/entropy_pipe_01/entropy_pipe_01_module_small_l020_a.mesh

✅base/environment/decoration/industrial/pipes/entropy_pipe_01/entropy_pipe_01_module_small_l020_a.mesh

Introduction

From the website: Noesis is a tool for previewing and converting between hundreds of model, image, and animation formats. It utilizes a robust plugin system, with support for native extension modules and Python scripts.

Noesis is considered one of Cyberpunk 2077 Modding's cornerstones for its ability to open .mesh files and convert it into a wide variety of other 3d file extensions (like GLB and FBX) thanks to alphaZomega's CP77 Python script that makes that possible.

Download

Noesis

Download Noesis from Rich Whitehouse's website

alphaZomega's CP77 Python plugin

Download the plugin from here \

Setup

After installing Noesis, put the fmt_CP77mesh.py file in the python folder located inside the plugins folder, and make sure that oo2ext_7_win64.dll is placed next to the plugin in folder.

Basic export/import process

Exporting

Open your .mesh file in Noesis64.exe, then right click on it inside the app and press Export, from there you will be given file extensions to export into, .FBX is the go-to for any usual process and for easier importing into 3D Apps like Blender and 3DS Max.

Same goes for .xbm files.

Importing

Open your 3d file (like .fbx or .glb) in Noesis64.exe, export and select .mesh - CyberPunk 2077 mesh [PC], when a dialogue box shows up browse and select the .mesh file that is appropriate for your import(for example if it was a shirt you'd probably export over .mesh files that has shirts in them), then click OK.

Summary

Published: Feb 08 2024 by Last documented edit: Feb 08 2024 by

This page will show you how to run Python scripts in Blender. It's not strictly speaking part of the Blender plugin, but I had to put this somewhere, and it's least out of place here.

The Scripting perspective

To run scripts, you need to switch to the scripting perspective. Click the corresponding entry on the perspective toolbar at the very top:

The script panel looks like this:

Running a script

1. Click on the "New Text" button to create a new document:

2. Click into the Text Editor panel directly below it

3. Paste the contents of whatever script you want to run (Hotkey: Ctrl+V)

Troubleshooting

If your script doesn't work, Blender will have generated an exception. To look at it, toggle Blender's System Console:

Copy the contents of the console window, or pull it as big as your screen allows and take a screenshot. Give this information to the Netrunner who told you to run the script and watch as they fix it.

If you don't have a Netrunner (or if you are that person), this is where you hit up Google or (you can skip the steps 1-5 in the linked guide).

Summary

Published: Jan 27 2024 by Last documented update: Jan 27 2024 by

This page will tell you

• what your Cyberpunk 2077 game directory is, with extra information in the expandable box

deploy - Deploys mods to the game by compiling them together

Synopsis

REDmod is a modding framework and a set of command line tools for modding Cyberpunk 2077 that allow you to compile script and tweak source files and allow for sound and animation modding.

To make a tweak mod in REDmod:

1. make a new mod and create a new folder here: <Cyberpunk 2077>/mods/MODNAME/tweaks

2. copy the .tweak file(s) you want to change from <Cyberpunk 2077>/tools/redmod/tweaks

010 Editor is a generic hex editing software which is capable of reading and writing REDengine W2RC files. A custom template for the 010 Editor created by @alphaZomega must be used to parse game files as human-readable.

Download

The 010 Editor can be downloaded from Sweetscape's website

Synopsis

Description

What is TweakXL?

For a detailed guide with many explanations of properties, check the second half of

TweakXL ( | ) is a mod by psiberx. It lets you alter Cyberpunk's , changing properties of NPCs and items or even adding new entries.

To make a script mod in REDmod:

1. make a new mod and create a new folder here: <Cyberpunk 2077>/mods/MODNAME/scripts

2. copy the .script file(s) you want to change from <Cyberpunk 2077>/tools/redmod/scripts

This section contains an overview of things that you might encounter while modding vehicles. For a full list of sub-pages, please check the link tree in the left-hand menu.

Animation Modding - WolvenKit Integration

The REDmod animation import tool can be used as a Plugin in .

• Add the .re

In base\appearance_mappings.json, entity types have their resources defined. The vehicle definition is below:

These are the part names used in filenames for .mesh and .ent files. Each header is their category - base is used in both Interior & Exterior.

REDmod is a command line tool developed by CDPR and Yigsoft, which allows us to interact with game files in a variety of ways.

Modules for mod creators:

Folder Structure

When creating a REDmod, there is a certain file structure that you need to follow to ensure that it can be used by others. You will want to have a folder that is the name of the mod and in this folder you will have a file named info.json. Whether you are doing , , , , or other mods (archive mods), you will also need to have at least one subfolder for the mod files to go into. This subfolder should be located on the same level as the info.json file, and be nested directly inside the folder with the mod name.

An example REDmod might look something like this:

When sharing you mod, you would package the folder that is the name of the mod. You could also package the mods folder with the "mod folder", but it is not necessary and it is assumed one might have other mods in their mods folder anyways.

info.json

For a REDmod to be recognized and loaded by the game engine, you must include an info.json file. This file sits in the root folder of the mod's folder at the same level as the subfolders containing your modded files. There are two required entries and a few optional entries that can be in this json file. At minimum a name field and a version field are needed:

In the above:

• The name field is the mod's name and should generally be the same as the folder the info.json file sits in.

• The version field is the mod's version. The version should generally use "Semantic Versioning"

INFO - Semantic Versioning is a method of versioning where each number gives meaning for a release based on their position. It uses the format MAJOR.MINOR.PATCH where a MAJOR release change is one which will break workflows, MINOR could break a workflow but is generally safe and might introduce deprecations, and a PATCH is a small non breaking change that all users on the same MAJOR and MINOR can update to without any issues.

The auto-refitter is a tool developed by that automates the tedious process of refitting meshes for the various body mods.

If you need a tutorial for manual refitting, check R&R: Refitting (step by step) or follow the links from there.

How to auto-refit

With a mesh selected, you can find it in the Mesh Tools section of the CP77 panel. Use the dropdown to select a target body, then click the button to apply the changes:

Modifier cannot be applied to a mesh with shapekeys

Future versions of the plugin will make this process much easier. For now:

1. Duplicate the mesh (Hotkey: Shift+D, Esc)

2. from one of the meshes

3. Delete the modifier from the other mesh

1. Select the mesh without shapekeys (the one you changed by applying the modifier)

2. Switch to the Data tab and create a modifyer by hitting the + button

3. Name your new shapekey Basis. This is how it's supposed to look when no shapekeys are active.

1. Repeat the process with all other shapekeys

2. You can now delete the original mesh.

It shrinks too far!

OK, that's a bit nasty, because it means you'll have to either merge the shapekeys, or create (which is easier than it sounds like).

If you want to merge, select the shapekey that you want to change, and set its value as high as you can without clipping. Then, select the "New Shape from Mix" entry in the dropdown menu (see the screenshot above).

You can now delete your original shapekey and rename the newly-created one (which will be called "Key 2" or something like that) to the original's name.

The body I want is not supported!

The lattice modifier has to be created from hand and added to the Wolvenkit Blender IO suite.

TODO: This section will eventually document the steps how you can

• add a body mod to your local version of the plugin

• share that edit with everyone else by having it added officially

You can find specific instructions for Installing the Wolvenkit Blender Plugin on the corresponding wiki page.

For the plugin's original readme, check github.

Compatibility

Usage

As soon as you have a mesh or armature selected, the viewport toolbar (keyboard shortcut to hide/unhide: n) will show you the CP77 Modding tab:

Features

Animation Tools

In the animation tools, you can find

• shortcuts for playing, renaming and deleting existing animations

• shortcuts to add new actions and insert keyframes

You can load one of Cyberpunk's default armatures at any time:

If you import an .anims file, selecting any armature will give you the option to play any existing animation:

Mesh Tools

Transfer Vertex Weights

Lets you transfer from one collection to the other (please read the info box below):

For documentation of the autofitter, see the .

Modifiers

Lets you change the armature target (the skeleton that'll move and deform your mesh)

Material Export: Hair

Lets you export a hair profile. For documentation, see

UV Checker

With the press of a button, you can switch out the currently active material to a coloured and numbered grid for easier UV mapping.

If the UV checker is currently assigned, pushing the button again will restore the original material.

Collision Tools

The collision tools and -generator can

• generate of convex colliders with the exact shape of your mesh The number of vertices to sample should be set to match the number set in the .phys file in order to ensure successful export

• generate box and capsule colliders with either user specified sizing or sized automatically to match the selected mesh

• export edited collision bodies back to .phys ***currently requires a wolvenkit converted .phys.json file

Summary

Published: Apr 19 2024 by Last documented update: Apr 19 2024 by

This page will tell you how to resolve error messages from the Wolvenkit Blender IO Suite.

Assign weights before exporting

This should only happen for meshes with armatures.

• Switch to the Data tab (the green triangle)

• If you don't have vertex groups, add one

• If you already have vertex groups, select the one named to the bone closest to your ungrouped vertices

Ungrouped vertices found

This should only happen for meshes with armatures. You can check the screenshot under for references.

1. Switch to the Data tab (the green triangle)

2. The plugin should have switched your viewport to Edit Mode (if not, do it yourself - hotkey: Tab)

3. Find out which vertices are the problem by moving them around in the edit view

No armature objects are selected

You are trying to export a pose, but you didn't select your armature. Click on the armature object in the outliner:

No meshes selected

You're trying to export something, but you haven't selected any meshes. Select everything that you want to export in the outliner (top-right panel) - the armature parent will be auto-selected for you.

Meshes must have UV layers

For Cyberpunk material assignments to work, your mesh must have UV maps.

Switch to the Data tab and add one:

You should now be able to export, but your material will most likely look funky. To remedy this, refer to ->

All faces must be triangulated before exporting

Triangulation means that faces must have exactly three corners.

1. The plugin should have switched the viewport to Edit Mode. If not, do it yourself (Hotkey: Tab)

2. Triangulate faces (Hotkey: Ctrl+T). The default settings are fine.

3. You should now be able to export.

Vertex groups not assigned to a bone

You have vertex groups in your mesh that don't have a corresponding bone in the armature. to delete them:

Armature missing

The armature (rig, skeleton) is the thing that makes your mesh move in-game.

If your mesh isn't supposed to move, check

If your mesh is supposed to move with the body, check

AMM props: You don't need an armature

It's enough to check the "Export as Static Prop" box during export, and the error will go away.

Equipment: You need an armature

You should have an armature in your .blend file because you're importing over an original Cyberpunk mesh. If you don't, you might want to refer to a guide such as and follow the steps.

Open the Modifiers tab (the orange wrench) and repeat the following steps for each mesh:

1. Make sure that there is exactly one Armature modifier present. If there is none, click Add Modifier and add one.

2. Click into Object and select the armature that your mesh is parented to.

Each submesh must have less than 65,535 vertices

If your submesh has >= 65,535 vertices

If your submesh has < 65,535 vertices

That's due to . The only thing you can do to avoid the issue is to make sure that no two vertices share the same UV coordinate.

1. switch to the UV editing perspective ( -> )

2. Turn on UV Sync Selection:

1. Once you have found an overlapping vertex, select linked (Hotkey: Ctrl+L)

2. Move the entire UV island by a whole tile in any direction (Hotkey: e.g. G -> X -> 1)

Tools

red4-conflicts

Check a folder with .archive files for conflicts (which files modify the same resource)

1. Download from

2. Extract somewhere

3. call via command line: red4-conflicts.exe "c:\Path\to\Cyberpunk 2077\archive\pc\mods"

Blender Plugins

Blender Scripts

A comprehensive list of jargon you might see on this Wiki or around our community. This glossary is not alphabetical, so be sure to use your browser search function to find what you're looking for. (CTRL+F for most applications)

General

• GitHub: A website which hosts code and helps programmers collaborate on projects. The source code for e.g. WolvenKit or Cyber Engine Tweaks is hosted there. You can compile the WolvenKit source code yourself, or for non-developers you can find WolvenKit releases here first.

• REDengine: The proprietary video game engine developed by CD Projekt Red for The Witcher 3 and Cyberpunk 2077. Witcher 3 uses REDengine 3 (RED3), Cyberpunk 2077 uses REDengine 4 (RED4).

Modding Tools

• Official Modkit for The Witcher 3 (WCC): An official CDPR command-line tool for modding The Witcher 3. Legacy WolvenKit makes extensive use of the Modkit. If you want to mod the Witcher, you're in the wrong wiki, choom!

• REDmod: An for .

WolvenKit

• masklist: The masklist file is a custom .txt document used as a helper file to generate new mlmasks using the Import/Export tool.

• Material json: Material json files are used by the Import/Export tool during for the mesh I/O process. The json will be named after the mesh file then suffixed with .Material.json (i.e. judy_01.Material.json)

Game Files

• Cooked/Uncooked: Whether a file is compressed by the REDengine build process.

  • Cooked: Files extracted with the Asset Browser using WolvenKit (including Legacy) are cooked files. See also:

Modding

• Reference: A string value in a resource that exists in another resource, and it is used to chain resource together as they are loaded into the game. Some examples are a DepotPath that points at another resource, a list index that points at a material entry, and an appearance that points at a component.

• Vanilla: Original or unmodified i.e. Johnny Silverhand's vanilla appearance can be changed with a DLC.

Mods

CET: One of Cyberpunk's core mods, .

Red4Ext: One of Cyberpunk's core mods, the (not to confuse with ).

SomethingXL, e.g. , : One of Cyberpunk's core mods (by modder psiberx). Requires Red4Ext.

SomethingEx, e.g. CyberwareEx, EquiipmentEx: An extender of Cyberpunk's core functionality (usually by modder psiberx).

AMM: . Advertised as a mod "for virtual photography", but that's like calling an orbital laser a toaster. Requires CET.

EBBWTFBBQ: Probably a body mod. Seriously, who can even keep track?

Installation guide

You can download RedHotTools on psiberx's github:

To install it, extract both downloaded files directly into your Cyberpunk 2077 game directory.

What does it do?

Integrated with Cyber Engine Tweaks, Wolvenkit and VisualStudioCode, it offers the following features:

Hot Reload

RHT can reload archives, scripts and tweaks for you at runtime without having to restart the game.

For documentation on how to do this, check

Script checking

• See scripts validation and binding errors

• Prevent game from starting if scripts compilation fails

Game object inspection

With the RHT overlay for Cyber Engine Tweaks, you can inspect game objects at runtime:

Inspect

Here, you can inspect world nodes and their properties:

Scan

Here, you can scan for any nodes around you:

If you expand the node properties, you can simply hide them at run-time, or use the integration with to create permanent presets:

Lookup

Reverse search of world nodes and spawned entities

Inspecting chunkmasks

RedHotTools lets you look up chunk masking of existing items at runtime.

Components

For player or NPC clothing, you can use the Watch tab. Find the component in the corresponding puppet's component array:

Entities

TBD

Editors

WolvenKit

The open source tool we all know and love, which is getting better with every bug you file.

Notepad++

010 Editor

Assets

Blender

3ds Max

Maya

Substance

Gimp

Krita

Paint.NET

Photoshop

Archived (legacy)

These tools are no longer maintained/supported

Summary

This page tells you how to set the launch options for Steam under Linux. If you have trouble after an update and have exhausted , make sure to double-check them — sometimes, Steam helpfully deletes them for you to make sure that your game crashes on startup. For GoG or Epic Games Store, the steps are the same, but the location to set the launch options are different.

TL;DR

You need to

• Install d3dcompiler_47

• Install vcrun2022

• Adjust the Steam launch option to be: WINEDLLOVERRIDES="winmm,version=n,b" %command%

If you can't get it to work, follow the steps below to apply the launch options via Protontricks, or search the #red4ext-support channel on the to find out what else you can do.

Protontricks: Setting up

To configure the necessary parameters, you can use the app Protontricks, which you can download through the built-in app browser "Discover":

1. Open Protontricks (you can search for this by selecting start menu)

1. When Protontrick opens, select Cyberpunk:

1. Choose "Select the default wineprefix":

1. Add an override: Check both of the checkboxes below

Apply via "OK". You may receive an error below or similar. If you do, click "Yes" to continue the installation.

Steam: Launch Options

Switch to steam and make sure that the launch options are set as below:

If this still doesn't work, check the for additional instructions, or find us on in #mod-troubleshooting.

Lutris: setting up

Taken from

1. Open Lutris

2. Right click on the game > Settings > Runner options

3. While newer versions of Lutris can use Proton, it is advised you use Wine-GE instead. Make sure you're using at least lutris-GE-Proton8-1

1. Scroll down to DLL overrides, click on Add to add a key. Add the following keys:

GOG: Launch Options

You can find the launch options for GOG in the game's config menu under Manage Installation -> Configure...

As under Steam, you have to add the following:

Summary

Published in August 23 by

OK, so what is this?

ArchiveXL ( | ) is one of the of Cyberpunk 2077 modding. Together with TweakXL, It allows you to add things to the game, such as

• and

• world sectors ( and additions)

This page will document how to set item properties via tags & suffixes (the vanilla way), or via dynamic switching (new, cool, version >= 1.5).

Let's dive right in.

Variants and suffixes

What are variants, what do I need them for?

When adding items, you will normally offer multiple (variants), for example, the same shirt in black, white, and red. This is what you're modding for, after all: making cool things.

And what are suffixes?

On top of having different colours, you also have different circumstances – for example camera states: not even Johnny Silverhand wears his sunglasses in first person perspective.

CDPR deals with this by using , which are tedious to use. psiberx has since created a better system ( or conditions), which are much easier to use.

For more detail on this, please see the sub-page

Tags

Tags are a way to add extra information to entities or appearances. They are defined on their own sub-page:

Dynamic appearances

If you have ever tried to make ten colour variants of an item for two body genders with four different states of feet, then you're familiar with the struggle. Version 1.5.0 of ArchiveXL solves this problem by introducing dynamic variants, allowing you to define rules to hook up your yaml straight to the mesh entity. picking components and even appearances dynamically.

You can find more detail about this on the sub-page ->

• For a tutorial about this, check

• If you are a mod user and want to dynamically recolour an item, check the guide -> sub-page Emissive ->

Dynamic Appearances: the diagram

Here's an overview of how the dynamic variants work. By comparison, is the old diagram. Especially for items with many appearances, the new way is much faster.

Referenced from base\appearances_mappings.json, base\vehicles\vehicle_filename_parsing.json contains a regex string is defined that outlines the allowable file names for .ent files (play around with this regex here):

For a filename like v_sport2_mizutani_shion__ext01_body_01.ent, this would match the following groups:

• Group 1: sport

• Group 2: mizutani

• Group 3: body

Group 3 has no mapping, is of the type partType.

Curiously, this regex doesn't work for vehicles such as the Type 66, or the 911, since numbers aren't permitted in Group 2. It's unknown if this is even used, or if there is replacing done at some point.

What is an asset?

An asset is a specific, objectified concept in the game that can be highly detailed like a blade of grass, or larger like a building, or intangible like sound effects. Unity defines an asset as, "Shorthand for anything that goes into a video game – characters, objects, sound effects, maps, environments, etc." Every asset is defined in a set of normalized asset files that describe its relationship to the game, other assets, and itself.

Visual Asset-Related File Formats

The following list contains file formats that are used to compose visual assets such as vehicles and weapons.

MESH

3d models

XBM

2d textures

ENT (entity)

Parent file for most visual assets which is directly linked by the

APP (appearance)

Sets up appearances for assets such as NPCs and vehicles referenced by

MT (material template)

Base shader files for REDengine

MI (material instance)

Instanced shaders for mesh materials

MLMASK (multilayered mask)

Mask component of the

MLSETUP (multilayered setup)

Material setup component of the

MLTEMPLATE (multilayered template)

Pre-defined tiling surface component of the

HP (hair profile)

Color ramp data to set colors for meshes using the hair

Visual Asset Graphs

Vehicles

This is the documentation for the .

Summary

Published: Feb 11 2024 by Last documented edit: Feb 11 2024 by

This page gives you some intel on how the wiki works and why you should start contributing.

To skip the pep talk, you can jump directly to or (github/Google account required)

For more information about TweakDB modding, follow the links under TweakXL.

To make your new vehicle available in-game, add its record to the flat Vehicle.vehicle_list.list

To unlock a vehicle at the start of the game, add the record to Vehicle.vehicle_list.initially_unlocked_list

This page does not contain any information. Please check its child pages in the Wiki navigation or click on the "Next" link at the bottom of the page

Summary

While it is possible to install mods by hand (and many modders do in fact exactly that), we recommend using a mod manager.

This guide will walk you through installing and configuring your game. If you have already done that, you can configure the mod manager of your choice:

• How to install mods with

• How to configure

Before you get started

Make sure you have all the required programs to operate mods and their managers; these are separate from modding framework requirements, but just as important.

This guide assumes that you have already bought Cyberpunk 2077 on the platform of your choice (Steam, GOG or EPIC).

Installing the Game

In order to set up your game to be best suited for mods, you'll want to keep a few things in mind:

For the purpose of this guide, we will assume the following install paths:

Performance

Like everything else, Cyberpunk will run significantly faster from an SSD rather than a HDD.

Permissions

By default, all three platforms (GOG, Steam, and Epic) want to install the game to their own install location, which defaults to C:\Program Files. That wouldn't be a problem if not for Windows and what it will permit there, which is not much.

This can (but doesn't have to) cause problems in two different spots by "protecting" the Cyberpunk install dir from modding tools such as mod managers (like our recommendation ) or even CDPR's own REDmod launcher. But hey, at least things are very secure.

You likely won't run into any of these problems, but you can rule them out altogether by installing Cyberpunk to a directory other than C:\Program Files or C:\Program Files(x86), like C:\Games\Cyberpunk 2077

Now we will go through the install options to use on each platform to accomplish this, and the recommended settings for modded Cyberpunk 2077.

Installing Cyberpunk: GOG

Open GOG Galaxy, click on "Owned Games" in the left sidebar, and scroll until you find Cyberpunk. Single click on its picture to display the main Cyberpunk page.

1. Click the button at the top of the page labeled "Install".

2. In the pop-up window, choose your install location:

   • Click the drop-down box

1. Press "Install"

2. Wait until GOG has done it's thing, then proceed to the next section.

Configuring Cyberpunk: GOG

Once the game has installed, we want to make it run with mods. Click the button to the right of the play button (formerly the install button) pictured below.

From there, select "Manage Installation" and then "Configure". A window will pop up where you can change your desired settings:

• Installation (first tab): Disable auto-updates

• Features (second tab): Enable mods

• DLC (third tab): Select at least Cyberpunk 2077 REDMod

That's it, you are done with your install of the game! You can now move on to .

Installing Cyberpunk: Steam

To be done

Configuring Cyberpunk: Steam

To be done

• Navigate to Cyberpunk 2077

• Click Play

• Click the Settings button and Enable mods

That's it, you are done with your install of the game! You can now move on to .

Installing Cyberpunk: Epic

To be done

Configuring Cyberpunk: Epic

To be done

• Navigate to Cyberpunk 2077

• Click Play

• Click the Settings button and Enable mods

That's it, you are done with your install of the game! You can now move on to .

You may now move on to mod manager and mod installation.

REDmod is a command line tool developed by CDPR and Yigsoft which can be used to stage installed mods to work with a modded game.

Why would I want this?

REDmod preloads any mods on its list, loading them as if they were a part of the game's regular structure. Preloading requires the game to be started via launcher (or Vortex) and will add a short delay, but the loading times during gameplay will be much faster.

Why is that not the default?

• Compatibility: Not all mods can be easily converted. Some outright break in the process.

• Especially modders don't like the extra delay during startup

• While the mods are precompiled, a console window will be visible. This scares many users.

Using Mods

The game loads redmods from this path: <Cyberpunk 2077>/mods/<name>.

EXAMPLE: REDMod: C:\GoG\Cyberpunk 2077\mods\<name>\archives\<name>.archive Legacy: C:\GoG\Cyberpunk 2077\archive\PC\mod\<name>.archive

How do I deploy?

You can handle deployment and load order with

• the REDlauncher that comes with the game

• Vortex Mod Manager from NexusMods

• REDmod WolvenKit integration and manage your mods easily from within the WolvenKit Mod Manager

What is deployed?

Activating mods

GOG Galaxy

• Open GOG - Cyberpunk 2077

• Click Manage Installation -> Configure ...

• Open the Features Tab

Steam and Epic

• Navigate to Cyberpunk 2077

• Click Play

• Click the Settings button and Enable mods

Conflicts and Load Order

Conflicts are handled on a per-file basis, but can be handled by specifying a specific load order. The rules here are the opposite of e.g. Skyrim: the first mod to change a file wins.

Example:

modA contains a script file Cyberpunk 2077\mods\modA\scripts\cyberpunk\player\player.script. modB contains a script file with the same name: Cyberpunk 2077\mods\modB\scripts\cyberpunk\player\player.script

This will discard all changes modB made, since by default, REDmod and the game loads mods alphabetically (modA overrides changes in modB).

However, you can specify a load order with REDmod, which the game will respect.

Troubleshooting

If a REDmod is giving you trouble, you can force a redeploy by either of the following means:

1. Either of

   1. Delete the content of r6/cache/modded in your Cyberpunk directory or

   2. Uninstall the mod

If that doesn't do it, you can consult the for advice.

Advanced Topics

Deploying Mods - Automatically

REDMod's redeploy is triggered on either of these changes:

• mods change: You added or removed a mod

• A mod's version changes: The version number in the info.json was changed.

• A mod's files change: You added or removed archives

Deploying Mods - Manually

The REDmod deploy command stages installed mods to work when the game starts with the modded flag.

Deploying Mods - WolvenKit Integration

• Open the WolvenKit Mod Manager.

• Click the Deploy Mods button in the toolbar.

You will see all installed mods in your game. Enable the mods you would like to play with.

Handling Conflicts - Manually

You can specify a specific load order with the -mod parameter:

This will override changes to \cyberpunk\player\player.script that modA makes in favor of modB. It will also tell the game to load modB before modA and modC.

Handling Conflicts - WolvenKit integration

• Open the WolvenKit Mod Manager.

• Adjust the load order by dragging and dropping rows.

• Click the Deploy Mods button.

You can adjust the load order by dragging and dropping the installed mods inside the mod manager.

When you click the Deploy Mods button, the current load order will be forwarded to redmod.exe and mods will be deployed and loaded in this order.

Starting a Modded Game - Manually

To start a modded game that loads mods deployed by REDmod use the -modded flag on Cyberpunk2077.exe

Example:

This however will skip the initialization process that should be done after any new REDmod mod install.

INFO The executable is located at <Cyberpunk 2077>\bin\x64\Cyberpunk2077.exe

A list of framework logfiles

This section has a list of log files by framework. If you've arrived here from one of the troubleshooting channels on Discord, the file you're supposed to find is most likely in this list.

If you aren't looking for a particular log file, please proceed to the next section.

Finding the log files

If you don't want to download and run script files from the internet, you can go and complete the steps by hand. Otherwise:

1. Go to DocPresto's and download the .bat script you find there:

1. Move it to your Cyberpunk game folder

2. Double-click it

Alternatively: By hand

Browse to your Cyberpunk game folder and use the windows search to search for *.log.

The list of results should look like this:

With a few exceptions, log files have the name of their mod. If they don't, check what folder they're in.

There's too many of them!

If you're drowning in log files and have no idea how to filter them, you can delete or remove them. Don't worry, they will be re-created on next launch.

Now, restart your game and do whatever you did to make the error appear. Then, search the Cyberpunk directory for *.log again.

Finding the relevant log file

1. Sort the files by size (if you just deleted them) or by date modified (if you didn't)

2. Open each of the files in a text editor (such as Notepad, it's installed with Windows). The relevant information will be at the very bottom.

Making sense of them

Error

Errors look like this:

An error in the log files almost always means that something exploded in a way that nobody has planned for.

• If the file is directly in bin\x64\plugins\cyber_engine_tweaks, that means CET is broken and you need to .

• If the file is in a subfolder of bin\x64\plugins\cyber_engine_tweaks, you have found a broken mod, but CET mods won't break the game. In this case, treat it like a .

Warning

If your warning isn't listed below, use your own best judgement.

Field with this name is already defined

This might indicate that a Redscript mod is loaded twice. Search the Cyberpunk root folder the mod name and make sure that you have no duplicates. If you're uncertain about this, try the on your r6 folder.

Audio Modding - WolvenKit Integration

The REDmod sound import tool can be used in a WolvenKit project.

• Add the .wav sound files you wish to import to your /customSounds folder in your mod project

• Click Tools > Sound Modding Tool

• In the Sound Modding Tool, choose which event to mod from the list of game sound events

• Adjust the in the bottom right

• Click Save

Audio Modding - Manually

Place raw .wav audio files inside <Cyberpunk 2077>/mods/<name>/customSounds. Include a info.json file with your mod (<Cyberpunk 2077>/mods/<name>/customSounds/info.json) where you sepcify how to use your custom sounds.

Example

Parameters

• name - the game audio event to override

• type - the sound type. Options are:

  • mod_skip: do not play this sound event

Step 0: Uninstall the old version

1. Open the Blender Preferences (Toolbar: Edit -> Preferences) and select the AddOns tab

Complete either of the options below:

Click the Remove button

The build-in Blender way. Should work. If it doesn't check the second option

Delete the files on your disk

Check the plugin's file entry. It will usually be something like this:

Navigate there with your Windows Explorer (Hotkey: Windows+R, paste the path above after changing your Blender version), and delete everything — either the entire folder, or all files inside.

Step 1: Install the plugin

Download the latest version of the plugin from github:

1. On the page, find the most recent release

2. Scroll past the change notes to the Assets section

3. Download the zip file with the plugin:

1. Start Blender

2. Open the Blender Preferences (Toolbar: Edit -> Preferences) and select the AddOns tab

1. Click the "Install" button and select the zip file you downloaded in step 2

Step 2: Enable the plugin

After you have successfully installed the plugin, you can now use the search bar to find it:

Make sure the box is checked and restart Blender.

Troubleshooting

I can't (un)install the plugin!

You can do both by hand. Find your Blender install's plugin folder, the path will look something like this (replace 3.6 with your Blender version):

Inside the plugins folder, the Wolvenkit Blender IO Suite will be installed to the subfolder i_scene_cp77_gltf.

To uninstall the plugin, delete the entire folder.