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

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

Summary

Created: January 22 2025 by Last documented update: January 22 2025 by

This page contains reusable content! Editing anything below will change it across the wiki, so please handle with care!

This page is a stub

Yaml editing warning

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

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.

Summary

Published: Feb 11 2024 by Last documented update: Nov 10 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)

Why you should edit the wiki

Wikis are the most open source thing since the invention of democracy, because everyone can edit them (that includes you!). They gather and share knowledge, facilitating all kinds of beautiful change — like the library of Alexandria before it was DDOSed by fire.

In terms of our wiki, that means:

• Everyone can learn how to make mods for Cyberpunk 2077 You don't know shit about Netrunning? Doesn't matter, !

• We don't have to research stuff all over . Want more than that? Here's where you can start digging...

• You can easily find people who can help you Published: Feb 11 2024 by If you make any progress on this, please contact on Discord

Unfortunately, most people don't edit the wiki.

Of course there are plenty of good reasons, so let's go over them one by one (open the box)

How to edit

Before you can edit, you need to (no way around it). It's integrated with github, so you can use that or your google log-in.

As of today (March 2024), I've never received a single spam mail from them.

Change requests

You can't edit without a change request (which is a snapshot of the wiki as-it-is that you can fuck around with to your heart's content).

Until you complete the steps under and a wiki admin merges your changes, nothing of what you do will go live, so you can safely break everything.

Your edits will be saved in your change request, so that you (or somebody else) can resume editing later. See

Creating a new change request

You can create one by clicking the Edit button in the upper right corner:

If you want to know more, you can check for this, or read the TL;DR below:

Browsing existing change requests

In the top left of your

Clicking on "Change Requests" to the left opens a side bar panel where you can browse existing change requests:

Creating new change requests

Click the "Edit" button to create a new change request:

Uploading files

You can upload images by either pasting them, or drag-and-dropping them into the article. Please make sure to

Requesting reviews

When you're done editing, you can request a review. The button is on the topright where the Edit button used to be:

... and that's it. After requesting a review, you don't have to do anything — your MR either gets merged directly, or the reviewer may change some things around (usually scatter some links), or they'll get back on you to clear things up.

Editing guidelines

Please check the page for a few basics on wiki editing!

Optional Parameters for meshes

Example Command:

Summary

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

This page gives you an overview about lights at a glance.

Wait, this isn't what I want!

For a guide how to add lights to AMM props, check

For an overview and explanation of lights, check (currently WIP)

Reference lights

Fluorescent lamp

base\gameplay\devices\lights\indestructible\fluorescent_lamp_b.ent

Recolourable via AMM panel. Has a Light and a LightGlow component, no flicker

Candles

for candle > .ent

Fixed colour, flickering light, soft natural glow

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

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.

This page collects cheat sheets for weapon tweaks. It does not contain information on its own; please check the child pages in the wiki's file tree.

Summary

Created: Nov 10 2024 by Last documented update: Nov 10 2024 by

This page contains our wiki editing guidelines.

Wait, this is not what I want!

• If you would rather learn how to edit the wiki, please check The Wiki -> How to edit

Basics

1. Name your merge requests

The first thing you should do after clicking the "Edit in Change Request" button is to give your merge request a title. Not only will future you be grateful, nothing is more annoying than returning to something like this:

2. Add a header on new pages

Please give your wiki page a header (see Summary). You can find a template to copy and paste under Page Header: Summary.

3. Name your images

You can add images into the editor by either pasting from clipboard or drag-and-dropping a file.

Unfortunately, gitbook's default name is as helpful as the NCPD customer feedback box:

Please name your images. As of November 2024, you can find the "Files" section on the left, in a tab behind the "Pages" tree:

Styleguide

Content (what it is)

KISS: Keep it simple, stupid

Keep guides short and concise.

1. It's easier to follow a numbered list than to read a long paragraph

2. Use bold text to highlight stuff that is important.

3. For anything extra, check Put extra info into expandables.

Presentation (how it looks)

Put important stuff in boxes

You probably read the box "Your guides should be easy to read..." first. That's why I put it in a box: I wanted you to!

Use headings to split content

You can link to headings, which makes them quite useful to split up long guides into manageable content. Here's how I (manavortex) use them:

• Heading 1 marks the beginning of a section

• Heading 2 marks the beginning of a subsection within a section

• Heading 3 splits subsections into individual parts

Put extra info into expandables

Anything that's not immediately relevant to the guide (but too interesting to cut out) can go into an expendable box.

Use images for clarity

The right image can sum up several paragraphs of writing. Make sure to use the right images.

If you include screenshots of anything, make sure to highlight the important parts (e.g. by drawing boxes and arrows). You can use any graphic editing program (such as Greenshot) for this.

Summary

Created: Jun 13 2024 by Last documented edit: Aug 18 2024 by

This page will give you an overview about psiberx's mod RedHotTools, give you an Installation guide, and link you to more detailed documentation on the sub-pages.

What does it do?

Integrated with Cyber Engine Tweaks, Wolvenkit and VisualStudio Code, RHT offers an invaluable toolikit for mod developers:

World Inspector

This CET widget lets you inspect the world around you, as well as the player and their equipment. Read more about it under RHT: The world inspector

Inspect the player

Via World Inspector: Watch (the player) you can see the player puppet's component in both first and third person, seeing changes to their appearance in real time.

Ink inspector

This CEt widget lets you inspect the game's interface. Read more about it under RHT: Ink Inspector

Hot Reload

This feature allows reloading mod files without restarting the game. You can use the CET widget to trigger it at any time, or rely on the integration with WolvenKit.

For more information, read RHT: Hot Reload

Script checking

This feature is enabled automatically

• See scripts validation and binding errors

• Prevent game from starting if scripts compilation fails

Installation guide

You can download RedHotTools on psiberx's github:

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

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

Summary

Created: Jan 19 2025 by Last documented update: Jan 19 2025 by

This page lists some known launch parameters use from game launchers like Steam, GOG and Epic, but may work for other launchers like Heroic.

Wait, this is not what I want!

• If you are trying to get your modded Steam Deck to work, check Modding on Linux

Parameters

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.

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.

Interior

• base

• steering_wheel

• pedals

Exterior

• base

• bumper_f

• bumper_b

• hood

• trunk

• door_fl

• door_fr

• door_bl

• door_br

• fuelcap

• fuelport

Wheel

• wheel

Summary

Published: ??? by Last documented edit: February 04 2024 by LadyLea

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: The unofficial .

• WolvenKit CLI: The of WolvenKit. (Formerly CP77 Tools)

• CP77 Tools: The original Cyberpunk 2077 modding Command Line Tools. (Renamed and moved to WolvenKit CLI)

• Noesis: (obsolete) A 3d viewer with plugin support for Cyberpunk 2077's file extensions. While Noesis can import and export 3D models, animations, and images, you should use Wolvenkit instead.

• 010 Editor: (obsolete) A hex-editing software that can be paired with a custom template to parse REDengine resource files and access its content. You can use Wolvenkit instead.

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:

  • Uncooked: After using the Official Witcher 3 Modkit to import an FBX to W2MESH, this file is uncooked. Rather than calling these files imported, the uncooked terminology is derived from the cooked (compressed) file state.

• Packed: CDPR games do not load loose files, but rather compress resources into archives. This compression process is called packing. The Witcher 3 uses ".bundle" files, while Cyberpunk 2077 uses the ".archive" file format.

• Raw: Generic term used to refer to non-REDengine files that have a resource counterpart. The raw format of the REDengine XBM texture format can be TGA, PNG, DDS, etc. e.g. "Do you have the raw texture?" - This is an inquiry about the TGA/PNG/DDS counterpart to a game texture file.

• Resource: A technical term for a REDengine asset file (e.g. .xbm, .mesh, .env).

• W2RC/CR2W: The file magic number for REDengine files. REDengine resource files are commonly referenced as W2RC/CR2W files for shorthand.

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.

• Legacy: Techie slang for "the old system". Note that the new system doesn't have to be better, just newer.

Mods

Core Mods

: Cyber Engine Tweaks, a utilized by the majority of mods.

: a core , which allows modders to add new features, modify the game behavior, add new scripting functions or call existing ones in your own plugins.

: is a core that can be integrated with the game and used to add/replace game scripts.

: without touching original game files, thus allowing multiple mods to expand same resources without conflicts. Requires Red4Ext.

: to create mods that modify TweakDB, a proprietary database of REDengine 4, containing essential information about game entities and behavior. Requires Red4Ext.

: is a library and framework for creating redscript and Cyber Engine Tweaks mods. Requires Red4Ext.

Other optional mods that greatly enhance user experience

AMM: is your ultimate Photo Mode helper that allows you to use tools to move NPCs and V around, pose them and further expand your photography portfolio; change the time of day or even teleport to a curated list of locations. Unleash your creativity by changing NPCs looks - now with extended features by using - decorate with endless props, and so much more awaits! Requires CET and Codeware.

: a custom characters framework and QOL tweaks for Photo Mode.

: in regards to clothes transmog system.

: an extender of Cyberpunk's core functionality in regards to cyberware slot expansions system.

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.

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 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

Summary

Created: Aug 18 2024 by Last documented edit: Aug 18 2024 by

This page describes RHT's World Inspector, telliung you what you can do with it.

World Inspector: Inspect

Here, you can inspect world nodes and their properties:

World Inspector: 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:

World Inspector: Lookup

Reverse search of world nodes and spawned entities by their node IDs (e.g. if you're browsing a sector in Wolvenkit)

World Inspector: Watch (the player)

The world inspector's Watch tab lets you inspect the player puppet and all of their components at runtime.

deploy - Deploys mods to the game by compiling them together

Synopsis

Description

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

• archives from <Cyberpunk 2077>/mods/<name> are staged to load

• scripts in <Cyberpunk 2077>/mods/<name>/scripts are compiled into a modded script blob

• tweak files in <Cyberpunk 2077>/mods/<name>/tweaks are compiled into a modded tweakDB blob

• sound files in <Cyberpunk 2077>/mods/<name>/customSounds are staged to load

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

Arguments

• -root=<path>

  the game root folder for which the deploy command is run.

INFO - this needs to be <Cyberpunk 2077>

Options

• -mod=<modA dirname> [<modB dirname> ...]

  stage only the mods in the given directory names (without the leading mods\), in left to right load order precedence. You must escape any spaces by enclosing the argument in double quotes (for example Mod With Space should be given as -mod="Mod With Space".)

• -modlist=<filename>

• -?|-h|--help

  Prints out a description of how to use the command.

Examples

• redmod deploy -root="C:\Gog\Cyberpunk 2077"

  Stages all installed mods under C:\Gog\Cyberpunk 2077\mods for loading

• redmod deploy -root="C:\Gog\Cyberpunk 2077" -mod=modB modA modC

  Stages only the three mods C:\Gog\Cyberpunk 2077\mods\modA\, C:\Gog\Cyberpunk 2077\mods\modB\ and C:\Gog\Cyberpunk 2077\mods\modC\ for loading. In this case, modB will override both modA and modC, and modA will override modC (in case any of them modify the same asset paths.)

• redmod deploy -root="C:\Gog\Cyberpunk 2077" -modlist="loadorder.txt"

  Same as above, but will load the mods from the file loadorder.txt instead.

Summary

Created: Jan 28 2024 by Update: Jun 29 2024 by Latest update: Feb 20 2025 by Current Version: 2.2

City Center Vendors:

(Corpo Plaza)

Vendors.cct_cpz_cloth_02 Vendors.cct_cpz_food_01 Vendors.cct_cpz_food_02 Vendors.cct_cpz_medic_01

(Downtown)

Vendors.cct_dtn_cloth_01 Vendors.cct_dtn_cyber_01 Vendors.cct_dtn_food_01 Vendors.cct_dtn_food_02 Vendors.cct_dtn_guns_01 Vendors.cct_dtn_medic_01 Vendors.cct_dtn_ripdoc_01

Heywood Vendors:

(The Glen)

Vendors.hey_gle_cyberware_store_01 Vendors.hey_gle_foodshop_01 Vendors.hey_gle_foodshop_02 Vendors.hey_gle_gunsmith_01 Vendors.hey_gle_junkshop_01 Vendors.heywood_glen_armorsmith_01

(Vista Del Rey)

Vendors.hey_rey_cyberware_store_01 Vendors.hey_rey_foodshop_01 Vendors.hey_rey_foodshop_02 Vendors.hey_rey_foodshop_03 Vendors.hey_rey_foodshop_04 Vendors.hey_rey_gunsmith_01 Vendors.hey_rey_junkshop_01 Vendors.hey_rey_netrunner_01 Vendors.heywood_del_rey_armorsmith_01

(Wellsprings)

Vendors.hey_spr_clothingshop_01 Vendors.hey_spr_foodshop_01 Vendors.hey_spr_gunsmith_01 Vendors.hey_spr_junkshop_01 Vendors.hey_spr_medicstore_01 Vendors.hey_spr_ripperdoc_01 Vendors.heywood_springs_armorsmith_01

Pacifica Vendors:

(Coastview)

Vendors.pac_cvi_clothingshop_01 Vendors.pac_cvi_cyberware_store_01 Vendors.pac_cvi_foodshop_01 Vendors.pac_cvi_medicstore_01 Vendors.pac_cvi_melee_01 Vendors.pac_cvi_techstore_0110

(West Wind Estate)

Vendors.pac_wwd_clothingshop_01 Vendors.pac_wwd_cyberware_store_01 Vendors.pac_wwd_gunsmith_01 Vendors.pac_wwd_melee_01 Vendors.pac_wwd_ripperdoc_01 Vendors.pacific_view_armorsmith_01 Vendors.pacific_west_armorsmith_01 Vendors.pacific_west_armorsmith_02

(Dogtown)

Vendors.BlackMarketer_HUB Vendors.cz_con_clothingshop_001 Vendors.cz_con_foodshop_01 Vendors.cz_con_gunsmith_01 Vendors.cz_con_junkshop_01 Vendors.cz_con_medic_01 Vendors.cz_con_netrunner_01 Vendors.cz_con_ripdoc_01 Vendors.cz_monument_foodshop_01 Vendors.cz_monument_ripperdoc_anderson Vendors.cz_monument_ripperdoc_farida Vendors.cz_stadium_clothing_001 Vendors.cz_stadium_food_01 Vendors.cz_stadium_food_02

Santo Domingo Vendors:

(Arroyo)

Vendors.std_arr_clothingshop_01 CU Vendors.std_arr_cyberware_store_01 Vendors.std_arr_foodshop_01 Vendors.std_arr_foodshop_02 Vendors.std_arr_foodshop_03 Vendors.std_arr_foodshop_04 Vendors.std_arr_gunsmith_01 Vendors.std_arr_medicstore_01 Vendors.std_arr_melee_01 Vendors.std_arr_ripperdoc_01 Vendors.std_arr_techstore_01

(Rancho Coronado)

Vendors.std_rcr_clothingshop_01 Vendors.std_rcr_cyberware_store_01 Vendors.std_rcr_foodshop_01 Vendors.std_rcr_gunsmith_01 Vendors.std_rcr_medicstore_01 Vendors.std_rcr_ripperdoc_01 Vendors.std_rcr_techstore_01

Watson Vendors:

(Arasaka Waterfront)

Vendors.wat_awf_foodstore_01 Vendors.wat_waterfront_armorsmith_01

(Kabuki)

Vendors.wat_kab_clothingshop_01 Vendors.wat_kab_foodshop_01 Vendors.wat_kab_foodshop_02 Vendors.wat_kab_foodshop_03 Vendors.wat_kab_foodshop_04 Vendors.wat_kab gunsmith_01 Vendors.wat_kab gunsmith_02 Vendors.wat_kab_junkshop_01 Vendors.wat_kab_medicstore_01 Vendors.wat_kab_netrunner_01 ER Vendors.wat_kab_ripperdoc_01 Vendors.wat_kab_ripperdoc_02 Vendors.wat_kab_ripperdoc_03 Vendors.wat_kab_techstore_01 Vendors.wat_kabuki_armorsmith_01

(Little China)

Vendors.wat_ich_clothingshop_01 Vendors.wat_Ich_cyberware_store_01 Vendors.wat_Ich_foodshop_01 Vendors.wat_Ich_foodshop_02 Vendors.wat_ich_foodshop_03 Vendors.wat_Ich_gunsmith_01 Vendors.wat_Ich_medicstore_01 Vendors.wat_Ich_melee_01 Vendors.wat_Ich_melee_02 Vendors.wat_ich_netrunner_01 Vendors.wat_ich_ripperdoc_01 Vendors.wat_little_china_armorsmith_01

(North Side)

Vendors.wat_nid_clothingshop_01 Vendors.wat_nid_cyberware_store_01 Vendors.wat_nid_foodshop_01 Vendors.wat_nid_foodshop_02 Vendors.wat_nid_gunsmith_01 Vendors.wat_nid_medicstore_01 Vendors.wat_nid_medicstore_02 Vendors.wat_nid_ripperdoc_01 Vendors.wat_northside_armorsmith_01

Westbrook Vendors:

(Charter Hill)

Vendors.wbr_hil_clothingshop_01 Vendors.wbr_hil_cyberware_store_01 Vendors.wbr_hil_foodshop_01 Vendors.wbr_hil_foodshop_02 Vendors.wbr_hil_ripdoc_01

(Japantown)

Vendors.wbr_jpn_clothingshop_01 Vendors.wbr_jpn_clothingshop_02 Vendors.wbr_jpn_cyberware_store_01 Vendors.wbr_jpn_foodshop_01 Vendors.wbr_jpn_foodshop_02 Vendors.wbr_jpn_foodshop_03 Vendors.wbr_jpn_foodshop_04 Vendors.wbr_jpn_foodshop_05 Vendors.wbr_jpn_gunsmith_01 Vendors.wbr_jpn_jig_bar_01 Vendors.wbr_jpn_junkshop_01 Vendors.wbr_jpn_junkshop_02 Vendors.wbr_jpn_junkshop_03 Vendors.wbr_jpn_medicstore_01 Vendors.wbr_jpn_medicstore_02 Vendors.wbr_jpn_medicstore_03 Vendors.wbr_jpn_melee_01 Vendors.wbr_jpn_netrunner_01 Vendors.wbr_jpn_netrunner_02 Vendors.wbr_jpn_ripperdoc_01 Vendors.wbr_jpn_ripperdoc_02 Vendors.wbr_jpn_techstore_01

(North Oak)

Vendors.wbr_nok_cyberware_store_01 Vendors.wbr_nok_foodshop_02 Vendors.wbr_nok_medic_01

Badlands Vendors:

Vendors.bls_ina_se1_clothingshop_01 Vendors.bls_ina_se1_foodshop_01 Vendors.bls_ina_se1_foodshop_02 Vendors.bls_ina_se1_foodshop_03 Vendors.bls_ina_se1_gunsmith_01a Vendors.bls_ina_se1_gunsmith_02 Vendors.bls_ina_se1_junkshop_01 Vendors.bls_ina_se1_junkshop_02 Vendors.bls_ina_se1_medicstore_01 Vendors.bls_ina_se1_ripperdoc_01 Vendors.bls_ina_se1_ripperdoc_02 Vendors.bls_ina_se5_cyberware_store_01 Vendors.bls_ina_se5_foodshop_01 Vendors.bls_ina_se5_gunsmith_01 Vendors.bls_ina_se5_junkshop_01 Vendors.bls_ina_se5_melee_01

Apply the effects to an item like this:

Weapon damage types

Testing

To test the applied effects, you can use . Simply copy the code into a new file inside of /r6/scripts/, e.g. debug_damage_types.reds. After starting up the game and hitting people with your weapon, you can see the log output via CET.

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 ❗ preserving the folder structure!

3. add a info.json file to <Cyberpunk 2077>/mods/MODNAME/tweaks with some mod info

✅ Done. To test, launch the game with REDmod.

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

010 Editor Template for Cyberpunk 2077

alphaZomega's CP77_CR2W.bt 010 template can be downloaded from the following link:

Setup

1. Install 010 Editor and run it.

2. install alphaZomega's template by navigating to Templates > View Installed Templates, then click Add and add CP77_CR2W.bt.

3. Navigate to your Cybeprunk 2077 installation, locate the oo2ext_7_win64.dll file, then copy and paste the DLL to the same location as the BT template file.

Scripts

Unkarkify and Rebuild

Unpack and pack the compressed "KARK'd" data within a CP77_CR2W file

Erase

Deletes an entire name and value's worth of a section inside the aforementioned formatted file

changeMatHdrs

Changes all the Material headers' numbers inside a file to be a universal one with zero offsets

insertMatHdrs

Creates a new material header inside a file

This page doesn't contain any data, it only groups subpages. Please check the wiki's file tree for the individual types of record.

General

General BaseStats:

Weapons

Weapons BaseStats:

Weapon Sounds

Vendors

Vendors ID's

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.

Appearances

For the documentation on .app files (appearance definitions), see or check the subpage.

Entity Files

For the documentation on .ent files, see .

An example entry for a vehicle entEntityTemplate from a vehicle's .ent file looks like this:

Summary

Created: Aug 18 2024 by Last documented edit: Aug 18 2024 by

This page describes RHT's Ink Inspector and tells you how to analyze Cyberpunk's UI

Ink Inspector: Inspect

This tab lets you see the UI's entire hierarchy.

If you highlight a row, an overlay will appear on the corresponding parts of the screen.

Ink Inspector: Pick

By binding a custom hotkey, you can analyze any widget on the game's default interface:

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

RedEngine - WolvenKit

The open source CP77 lynchpin we all know and love, which is getting better with every bug you file!

Text - Notepad++

Hex - 010 Editor

3D Graphics

Blender

Open Source 3D modelling

See Also

3ds Max

Maya

Substance

Noesis

Convert .mesh files into a wide variety of other 3d file extensions (like GLB and FBX)

2D Graphics

Gimp

Open source Photoshop alternative.

Krita

Paint.NET

Free 2D image software with alpha layer support - great for basic editing and preformatting of images to be used in Inkatlas files for UI etc.

Photoshop

MLSetupBuilder

Edit multilayered materials

See Also

Archived (legacy)

These tools are no longer maintained/supported

Synopsis

Arguments:
  -gameRoot=<depot>
  -inputPath=<file>
  -animset=<resource-path>

Options:
  -outputPath=<resource-path>
  -animationRename=<name>
  -h, --help 

Description

The import command imports an .re animation file into an existing .anims animation set file.

Optional parameters include specifying an existing animation name to rename inside the animset file (otherwise the filename of the .re animation file is used) or specifying a different output path (default is overwrite).

INFO - It is best to name .re animation correctly even if you replace an existing animation, because the imported animation will always have the filename of the .re file.

Arguments

• -gameRoot=<path>

  directory-path to the depot for animset and output (e.g. C:\modding\depot)

INFO - this is the base depot from which relative <resource-paths> are loaded

INFO - You need to have the .rig file used by the .anims animationset present in your depot path.

• -inputPath=<file>

  absolute path to the animation .re file

• -animset=<resource-path>

  resource .animset file to use

INFO - resource path must start with base\ (e.g. base\animations\npc\generic_characters\male_average\open_world\generic_male_average__stand__rh_cane_lh_cigar__01.anims)

Options

• -outputPath=<resource-path>

  resource .anims file name to write, default is to overwrite the input animset (resource path must start with base\)

• -animationRename=<name>

  parameter representing the old name of animation to be replaced by the new animation (default is the filename of the .re animation file)

INFO - the imported animation will always have the filename of the .re file even if you specify the animationRename parameter.

• -?|-h|--help

  Prints out a description of how to use the command.

Examples

• redmod import -gameRoot="E:\modding\depot" -input="E:\raw files\animtest1\macarena_long (1).re" -animset=base\animations\npc\generic_characters\male_average\open_world\generic_male_average__stand__rh_cane_lh_cigar__01.anims -output=base\out\new_test.anims -animationRename=stand__rh_cane_lh_cigar__01__smoke__02"

  Imports the animation file E:\raw files\animtest1\macarena_long (1).re into the animset file E:\modding\depot\base\animations\npc\generic_characters\male_average\open_world\generic_male_average__stand__rh_cane_lh_cigar__01.anims and replaces the animation with the name stand__rh_cane_lh_cigar__01__smoke__02 with the name macarena_long (1). The result is saved to to E:\modding\depot\base\out\new_test.anims.

Summary

Last documented edit: Sep 08 2024 by

This page will tell you the following things:

• What is REDmod, and what does it do?

• How to install REDmod

Wait, that's not what I want!

• If you just want to turn it on, check here.

• If you're looking for the log, go to your Cyberpunk 2077 game directory and find it under tools\redmod\bin\REDmodLog.txt

• If you are a mod developer, check REDmod for mod devs

What is REDmod, and what does it do?

REDmod is a modding framework with a set of command line tools to precompile mods before launch.

If you don't speak Netrunner: During game launch, the modded content will be added to the game's regular file. Your in-game loading screens will be much faster.

When do I need it?

As of September 2024, the only thing we can't do without REDmod is adding new sounds (replacing existing sounds is fine). The Audioware mod attempts to mitigate that.

How to install REDmod

REDmod is shipped as free DLC with the game. You need to add it inside the platform store (GOG, Steam, Epic). You can click the link below, or find more detailed instructions further down on the page.

• DLC Link on GOG

• DLC Link on Steam

• DLC Link on Epic

GOG

Steam

When REDmod is installed correctly you will find a new folder tools/redmod inside your game root directory, with subfolders: bin, scripts, tweaks.

Summary

Published: 22.09.2024 by Last documented update: 22.09.2024 by

This guide will show you how to download and install the Wolvenkit Blender IO Suite from github source. You only need this if you want the newest features and fixes.

Step 1: Download from github

1. Head to the Wolvenkit Blender IO suite's github repository

2. Click the green Code button

3. Click "Download ZIP" at the bottom

1. You should have downloaded a file called Cyberpunk-Blender-add-on-main.zip.

Step 2: Finding the install location

2.1: Find the correct install path

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

2. Search for cyberpunk

3. See the current install path under File. It should be something like this:

C:\Users\USERNAME\AppData\Roaming\Blender Foundation\Blender\VERSION\scripts\addons\i_scene_cp77_gltf\__init__.py

1. Everything before the __init__.py is the path to the current install (replace VERSION with your Blender version, e.g. 4.4)

2. Open an Windows Explorer there As a shortcut, you can press Windows+R, paste %APPDATA%\Blender Foundation\Blender into the box, and press Enter.

2.2: Delete the old install

1. Navigate your Windows Explorer to the path you found in 2.3 (Shortcut: Windows+R, type %APPDATA%, confirm, then browse from there)

2. Delete the whole i_scene_cp77_gltf folder.

3. Leave the explorer window open, you need it for Step 3!

Step 3: Extract the download

1. Open Cyberpunk-Blender-add-on-main.zip that you downloaded in step 1.

2. Find the folder named i_scene_cp77_gltf. This is the blender add-on:

1. Copy or drag the folder to the addons folder from step 2.2.

Step 3: Restart Blender

After restarting Blender, you now have the very latest version of the plugin. If you want anything more recent, you have to become a developer yourself.

Happy modding!

Summary

Published: ??? by Last documented edit: Feb 12 2024 by

The auto-refitter is a tool developed by that automates the tedious process of refitting meshes for the various body mods. This wiki page will show you how to use it.

Wait, this is not what I want!

• If you want to manually refit an item, 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. Delete the shapekeys from one of the meshes

3. Delete the modifier from the other mesh

4. After the shapekeys are gone, apply the modifier:

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.

4. Select the mesh with shapekeys (the one with the original shape)

5. Switch to the Data tab, select the second shapekey in the list, and transfer it:

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 Garment support from scratch (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

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):

(?:v_)?([a-zA-Z]+|av)\d?_([a-zA-Z]+)_(?:[a-zA-Z]+(?:_[a-zA-Z]+)*)__(?:int|ext)\d{2}_([a-zA-Z]+(?:_[a-zA-Z]+)*)_\d{2}.*\.ent

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.

Tools

red4-conflicts

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

1. Download from Fuzzo's github

2. Extract somewhere

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

4. Profit

SoundDB

Web tool allowing you to search for voice-overs, music and sound effects of the game. Available on https://sounddb.redmodding.org/.

See the Finding audio page for a usage guide:

Python Helper Scripts

Create Inkatlas files, error checking and more.

https://github.com/DoctorPresto/Cyberpunk-Helper-Scripts

Blender

Blender Plugins

Blender Scripts

Summary

Created: May 04 2077 by @you Last documented update: May 05 2077 by @you

This page contains a reusable header template that you can copy/paste into new wiki pages. It is a part of Editing guidelines, but can be used standalone.

Wait, this is not what I want!

• If you want to [do something else] instead, you can check [link]

• Or maybe you want to see [the corresponding cheat sheet]?

Requirements

To complete this guide, you need the following tools:

Summary

Written & Published: Nov 22, 2023 by

This page will explain to you what Load Order is and how it works, then tell you how to influence it.

TL;DR

You're not supposed to manage load order conflicts outside of .archive mods and REDmods. If you ever feel the need to do that, a modder fucked up. An exception to this are Tweak mods, as the tweakDB is also a database of static values, conflicts can happen (e.g. two mods both edit the weapon stats of the Masamune).

• For REDmods, see

• For .archive mods, use Fuzzo's Archive Conflict Checker Tool ().

• There currently is no tool to check tweak conflicts

What is Load Order?

Unless two mods are changing the same file, you don't need to bother about this at all. Unfortunately, the moment you're using frameworks or anything body modding related, you will run into this scenario.

In Cyberpunk, conflicts inside .archive mods are one per-file basis, whatever mod modifies a file first will win – unlike e.g. Skyrim, where esps may overwrite each other.

Example

There are two mods that change boob size (and both mods modify the same file, e.g. a rig or mesh):

Since i_know_nothing_about_back_problems will load first, the conflicting file inside realistic_boobs_DDDDDDDDD_cup does nothing.

How are mods ordered?

The game loads mods in the following order (higher wins):

1. Legacy mods

All .archive files in Cyberpunk 2077/archive/pc/mod in alphabetical order (see below).

This means the game will load modb before moda, even though the filenames are not in alphabetical order. This allows for conflict management without renaming the physical files.

2. REDmods

Anything in Cyberpunk 2077/mods. All REDmod archives are loaded strictly after all archive files found inside /archive/pc/mod.

Load order: ASCII sort

The game reads mods in ASCII-alphabetical order (REDmods by folder name, .archive files by archive file name).

This is ASCII ordering:

Example

How to use this?

You can re-name your folders and .archive files following the rules under to influence in which order the game will load your mods, or you can use Fuzzo's Archive Conflict Checker Tool ().

More Examples

If you are creating a compatibility mod (something that modifies the files of another installed mod), then yours needs to load first.

For example, if you want to do a custom recolour of the mod , then your Wolvenkit project could be named _00_ArchiveXL_Netrunner_Variants, or _ArchiveXL_Netrunner_00_Recolour.

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 .

Wait, this is not what I want!

You can also check for less addon-specific mesh troubleshooting

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

• If you aren't already, switch to Edit Mode (Hotkey: Tab)

• Click the "Assign" button under the vertex groups panel

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

4. In the list of vertex groups, select the armature bone closest to your ungrouped verts

5. Click the "Assign" button under the vertex groups panel

6. Rinse and repeat the process for all submeshes until the plugin lets you export

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

You need to reduce the vertex count.

If your submesh has < 65,535 vertices

That's due to . See for how to remedy this.

Summary

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

This page contains troubleshooting options for the .

If the plugin gives you error messages on export, please check instead.

If you can't solve your problem with these steps, feel free to reach out on in the #blender-add-on channel.

Version compatibility

Seeing the Blender version

You can see the exact Blender version in the lower right corner of the program:

Seeing the plugin version

You can find the current supported version in the table above (under ), or check the .

1. Open the preferences from the menu (Edit -> Preferences)

2. Switch to the AddOns tab in the bar on the left

3. In the filter field at the top right of the list, search for cyberpunk

4. Expand the entry and find the Version field

General Troubleshooting

Steam

If you installed Blender via Steam, stay on the stable stream and make sure to keep Blender up-to-date.

Check the console output

See if Blender encountered any errors by checking the console output. From the menu, select View -> Toggle System Console.

Failed to import materials

Make sure that your Wolvenkit is up-to-date

Make sure that your Depot is not outdated

The plugin needs your Wolvenkit Depot to a) exist and b) be more or less recent.

If you don't know what that is, or aren't sure how old your depot even is, it might be time to regenerate:

1. From the Tools menu, select the Depot generator

2. Click the Migrate Files button at the bottom and wait until WKit is done

3. Re-export your .mesh with materials and check if your problem goes away

If it does not, you can simply nuke the entire depot, as it will be re-generated whenever necessary:

1. From the Tools menu, select the Depot generator

2. Click the first button (Open Depot Folder) to open the folder in Windows Explorer

3. Delete everything there

4. Re-export your .mesh with materials

5. Your problem should be gone now

Summary

Published: ??? by Last documented update: Nov 29 2024 by

This page will show you how to install the Wolvenkit Blender Plugin from a github release or tag. If you want to install the bleeding edge, please check instead.

Compatibility

Optional: Uninstall the old version

Step 0: Download the plugin

Download the latest release 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:

Step 1: Install 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.

To install the plugin, find the folder in your downloaded zip file that contains the file __init__.py, move it here, and rename it.

Now, restart Blender.

Summary

Last documented update: June 06 2025 by

REDmod allows you to add new and override existing audio events. Note that any events added or overridden will use a different Wwise event, removing any special parameters and Wwise logic attached (e.g. overriding a gun sound event will result in it no longer receiving time-dilation effects processing).

Audio Modding - WolvenKit Integration

The REDmod sound import tool can be used in a 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. You may use nested folders with \\ (see last entry in example).

Example

Parameters

• name - String The game audio event to override.

• type - String The sound type. Options are:

  • mod_skip: Do not play this sound event

  • mod_sfx_2d: Will be played without any positions / attenuation

  • mod_sfx_city: Has a longer attenuation that is suitable for city sounds

  • mod_sfx_low_occlusion: Has a long attenuation that isn't occluded much e.g. a VO or quest sound that you don't want to be muffled

  • mod_sfx_occlusion: Medium attenuation with normal occlusion

  • mod_sfx_radio: Needs to be tuned to a broadcast channel (e.g. radio)

  • mod_sfx_room: Has a shorter attenuation suitable for something that can be heard across a room

  • mod_sfx_street: Has a medium attenuation, good for something to be heard down a street

  • mod_sfx_ui: For menu and UI sound replacement

• file - String The .wav file to use (inside /customSounds)

• gain - Float How loud the sound is; ranges from 0 to 1.

• pitch - Float The amount of pitch variance applied to the sound; ranges from 0 to 1.

Redmod can be used to import a large variety of files into REDengine formats for use in your mods.

Summary

Published: Apr 27 2024 by , based on research by Last documented update: Dec 17 2024 by

AcceptedWeaponConfig

You can use this to spawn .

poseStateConfig

You can use this to .

Unless indicated otherwise, none of the pose states below are available when swimming.

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.

You can also check the section of the console command list to see their names and spawn codes.

List of all vehicle records

(Dumped as of 2.12a)

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❗ preserving the folder structure!

3. add an info.json file to <Cyberpunk 2077>/mods/MODNAME/scripts with some mod info

✅ Done. To test, launch the game with REDmod.

Overview

Who doesn't know it? Your modded game is working, then there's an update, and from one moment to the next everything is a smoking crater. Unfortunately, that's normal: as long as you're living on earth, things fall down when you let go of them, and game updates break mods.

This page will give you a brief overview on what you can do in the situation described above by linking to the corresponding sections of the troubleshooting guide.

What can I do?

The first step is to update your core frameworks. Check every mod on this page — make sure that you have a version from after the update.

There are no framework updates!

You're too fast, choomba: modders haven't gotten around to updating the frameworks yet. That leaves you with two options:

• remove all mods and play vanilla until the updates arrive

• downgrade your game

I updated my frameworks, but the game is still crashing!

Your game and the core frameworks need to be version-compatible. You can make sure of that by

1. resetting your install

2. One by one, installing all of the frameworks you need

3. Restoring your mods from the backup

What other options do I have?

If these instructions didn't help you, there probably are no updates yet and you'll just have to wait. You can find warnings about version mismatches in these log files.

Of course, you can always

• look around in the troubleshooting guide or use your browser's search function there (Ctrl+F and type)

• check a list of known problem children and disable them for now

• further troubleshoot your installation

• Reset your installation:

  • Fall back to a clean state (via mod | precise | nuclear: fast | nuclear: very fast)

  • Enable all core mods and make sure that the game starts

  • Re-enable your other mods (check bisect for how to do it fastest)

• Find help on Discord in #mod-troubleshooting

Summary

Last documented edit: Sep 07 2024 by mana vortex

This page tells you how to use REDmod for mod creation.

Wait, that's not what I want!

• If you want to know what REDmod does, check here

• If you're a mod user, check the REDmod page in the Mod Users section

What is REDmod? (Developer version)

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:

resource-export  - Export REDengine files to raw format for editing
resource-import  - Import raw files to REDengine formats for use in your mod
animation-import - import .re animation files to an animset
util-hash        - Hashes paths/string with given hash algorithm
help             - Displays helpful info about the other avaliable modules (use -h or -help on any command)

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 Animation Modding, Script Modding, TweakDB Modding, Audio Modding, 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:

 * root_folder
 * | -📁 mods
 * | |-📁 <Mod Name>
 * | | |-📁 archives
 * | | |-📁 scripts
 * | | |-📁 tweaks
 * | | |-📁 customSounds
 * | | |-📄 info.json

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:

{
    "name": "MODNAME",
    "description": "Description for the mod.",
    "version": "1.0.0",
    "customSounds":    [ ]
}

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"

• The description field is optional for all mods, but it is generally suggested one should include it so other tools have something to display for a given mod.

• The customSounds field is semi-optional. It is required for Audio Modding.

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.

Summary

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

This page will tell you

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

• how you can find the game folder

• how to use Windows Search to delete leftover files from a mod

What is the game directory?

The game directory is called Cyberpunk 2077 (unless you re-named it). It's the place where Windows put everything that it needs to run the game when you click on the icon — that includes mods.

How can I find the game folder?

Unless you changed the default settings, your game is installed here:

You can open a Windows Explorer in the game folder like this:

1. Press Windows+R to open the Run dialogue

2. type explorer (don't forget the space)

3. Copy and paste the game path from the table above into the text box

4. Press Enter or click OK

It's not there!

If you don't know your game directory, you can find it in your client:

Steam

Right-click on the game in your library, then select Manage -> Browse local files

GOG

With the game selected in your library, click on the More button, then on Manage Installation and Show folder…

Epic

Right-click on your game in the list and select Manage. Then, click on the folder icon:

Copying the folder path

1. Select the folder path by clicking on the empty bit to the right of the explorer's path bar:

1. The entire path will be highlighted (if it's not, you can do that by pressing Ctrl+A)

2. Press Ctrl+C to copy it to your clipboard

Deleting residual files with Windows Search

Once the Cyberpunk folder is open in your Windows Explorer, you can use the Windows Search bar in the upper right corner (Hotkey: Ctrl+F) to find files by name.

For example, if you have trouble with atelier and have decided to do a clean reinstall, you can search for atelier:

You're seeing the atelier install folder (good) and a bunch of atelier stores (bad, these are innocent). You can either double-click on the virtual-atelier-full folder (first item) to navigate there, or use any of the following options.

Finding the folder path in the search results

If you right-click on a folder or file, you will see a menu entry "open folder/file location". This will open a new Windows Explorer window in the folder containing the item you selected, letting you browse and delete.

Deleting from the search results

Select multiple items from the list by holding the Ctrl key while you click.

Once you have selected everything that you want to delete, simply press the delete key, or right-click and select Delete.

Preventing the game from auto-updating

GOG Galaxy

In GOG Galaxy, this can be done as a global setting — you disable auto-update for all of your games — or as a per-game option for some games like Cyberpunk 2077.

Only disable updates for CP2077

Open the GOG Galaxy page for Cyberpunk 2077 and click the manage icon next to the big play button, then Manage installation and Configure... Disable the Automatically update to the newest version checkbox. Optionally, select the game patch you want to play on here.

Globally disable updates

Open the settings and select the entry Game features in the sidebar, then uncheck the box for Auto-update games.

Epic

In the EPIC launcher, this is a global setting — you can only disable auto-update for all of your games.

Open the settings menu and scroll down to MANAGE GAMES, then disable auto-updates.

Steam

Unlike the competition, Steam will not give you any control about auto-updating. For that reason, you need to forbid it from writing to a specific file on disk, without which it will be literally unable to update. Here's how:

1. Find the steamapps folder (:

   1. Right-click on Cyberpunk 2077 in your Steam Library and select Properties

   2. On the side bar, click on Local Files

   3. Select Browse. This will take you to Cyberpunk's install directory, which is inside the folder we want (e.g. C:\Steam\steamapps\common\Cyberpunk 2077)

   4. Navigate two levels up (in windows explorer this is done by clicking the up arrow at the top left of the window, next to the file path, or by using the shortcut Alt + Up Arrow Key)

2. Find the file appmanifest_1091500.acf

3. Set the file to read-only:

   1. Right-click on the file and select Properties

   2. At the bottom of the dialogue, check the Read-only box

Downgrading

GOG

1. Disable auto-updates

2. Head to the Cyberpunk game detail page

3. Find the settings button next to the Play button

4. Select Manage Installation -> Configure…

5. Select the game version

Epic

Sorry, choomba, you're fucked. No downgrading possible.

Steam

Since 2.2, Steam supports downgrading to version 1.63 or 2.13

Right-click on the game in Steam and select Properties, then go here:

For downgrading to other versions, see the expandable box below.

In 1.6.8, the MLSetupBuilder library has been completely overhauled. This page will tell you how to find things there.

The model browser of 1.6.7 has been transformed from a tree with sub-branches into a table with many capability. One of those capability is tags filtering.

How does this work?

Filtering will only consider an item's name, but not its visual appearance:

Tags are displayed to the right, but are written text-like in the Database. Every keyword is divided from the other with a space. As the caption says, the selected line tags is written like : base man massive head

Why is this important ?

It is important because there are some rules to this syntax that will help you atomize the search of one model into the 40K+ models paths stored in the Database. The most important rule is that every model starts with :

• base - for Vanilla Cyberpunk 2077 models

• PL - for Phantom Liberty ONLY models

How do i start using tags filters ?

In the Models Library panel, click on the tags filter button in the header of the table

Example

Let's say we wanna search only in the models of the Phantom Liberty expansion for man models. We will add a first condition specifying in the options that our tags Starts with the word PL

Then we can click on Add Condition and specify that the tags need to Contains the word man with a space before the word man The space is NEEDED since the also the keyword woman contain the word man

You will see that for every condition you add, the datas will be filtered in realtime. You can remove and add tags filtering condition as you like. Clicking to the little x in the right upper corner of the tags filtering panel you can toggle the panel and access the list you got.

You can combine the tags filtering with the basic search field in the table interface to find what you need.

List of the actual TAGS used with Tags System

• base

• PL

• player

• man

• woman

• child

• big

• fat

• massive

• animals

• gloves

• arms

• head

• item

• legs

• shoes

• torso

• vehicle

• mechanical

• weapons

• firearms

• melee

• explosives

• environment

Details about the keyworks:

• player identify all those materials that by model name are for sure assigned to the game player

• animal identify the models related to the Animals Gang member body size

A more complex example

Tag filtering ca be combined with the default path search to display only legs models related in this case to jeans

What's a BaseID?

Each item is uniquely identified by this string. You can use it to spawn items via with the following command:

Game.AddToInventory("Items.money", 5000)

Items.money is the baseID for eddies, and the 5000 will stuff 5 grand into your pocket.

Lists of Base IDs

A selection of lists for looking up item codes. Alternatively, you can browse through the game's files, or search the web.

Step by step

Step 1: Finding the right item

1. Head to the fandom wiki and search for your item. For this guide, we'll be using the Reinforced Puffer Vest.

2. In the box on the left, find the Technical section. This will list your base ID:

The naming scheme

Usually, the base ID consists of two parts: the item name, and the item's appearance.

• Vest_17 is the name of the item. You can use this to find its control files (see Step 2 below).

• basic_01 is the variant name. This is used inside the control files to load a specific appearance.

Step 2: Finding the .app file

1. Open WolvenKit and use the Asset Browser to search for the item's app file: vest_17 > .app

1. You should now have at least one .app file, where the item's appearances are defined.. To learn more about this, check Appearance: .app files. This is not necessary for this guide.

   • If you have more than one file, hover over them to view their file paths, and pick the one that's inside a player folder.

   • If you can't find any files, check Alternative methods of finding an item below.

2. Open the .app file (right-click, "Open without adding to project")

Step 3: Finding the mesh

1. Inside the .app file, open the appearances array

2. You will see something like this:

1. Ignore camera mode and open the appearance that you want (basic_02_w)

2. Open the components array and find the component that has mesh in its name:

1. You want mesh file's DepotPath. This is where Wolvenkit stores the 3d object, which contains the materials.

You found the item, what now?

Now that you've found your mesh, you can edit it.

• To use it for the base of a new in-game item, check the Adding new items guide

• To change its materials, check the Changing materials, colors and textures guide

Alternative methods of finding an item

Some items don't obey The naming scheme, for example Q005_Johnny_Pants. So how can you find these kinds of items?

The Tweak Browser

1. Find and open the and wait for it to initialize. As of Wolvenkit 8.14, it is pinned to the right side of the viewport

2. Search for your item, e.g. Q005_Johnny_Pants

3. Select one of the entries from the list on the left

4. In the detail panel with the item's properties, find the appearanceName.

   • If you don't have a detail panel, make the Tweak Browser window wider

1. The appearance name will be something like l1_pants_16_q005_johnny_. Does this look familiar?

2. Time to proceed with Step 2: Finding the .app file

The Wolvenkit Search

Depending on what you are looking for, you can check and dig directly for the mesh file. This might be tedious, but you'll also discover a lot of things on the way, so it's definitely worth a try!

Summary

Published: Aug 18 2024 by mana vortex Last documented edit: Aug 18 2024 by mana vortex

This page describes Red Hot Tools's Hot Reload mechanism.

How it works

Although there is a CET overlay, Hot Reload is fully integrated with Wolvenkit and Visual Studio Code — you don't have to do anything except pushing the right button.

The theory

As you know, Cyberpunk 2077 loads its mods from archive/pc/mod. While you run around in Night City, it will keep them open and use the files inside as it needs them.

By placing .archives inside the hot folder, you put them under the control of RHT, which will add them to the game's internal pool of never-changing content:

But the folder is always empty!

That's because RHT moves the file into mods and splices them into the game's resource pool.

But my changes don't show up!

Red Hot Tools invalidates the game's resources and loads your changes, but things that are already spawned won't be affected. Here is how you can trigger change detection:

• Loading a save (always works)

• Spawning a new copy of your item via CET and equipping that (usually works)

• Despawning and respawning the NPC or world entity you're modifying (usually works)

• Respawn the UI widget (usually works)

• Unequipping and re-equipping your item (sometimes works)

Integrations

Wolvenkit

Simply push the "Hot Reload" button in your toolbar:

Visual Studio Code

You can download the RHT plugin red-hot-vscode-x.x.x.vsix from github:

Install the extension via Extension Manager's ... menu (Install from VSIX...) and restart VScode. Now you can see the following actions:

The CET overlay

Hot Reload is integrated with . Depending on your workflow, you don't need these buttons.

Archives

Here, you can manually trigger a reload of archive extensions (read: .xl files). You only have to do this if you edit an .xl file in archive/pc/mods.

Scripts

Here, you can manually trigger a reload.

You can do this via by running "Hot Reload Scripts" from Visual Studio Code

Tweaks

Here, you can manually trigger a reload.

You can do this via by running "Hot Reload Scripts" from Visual Studio Code

Summary

This page will give you an explanation of requirements (). After that, you will find a guide on debugging a dependency chain to troubleshoot a mod.

The example will use , but the same principle applies to each and any mod.

Theory: What is a requirement?

It is something that your mod needs to work; for that reason, requirements are also called dependencies. The game will load them first.

Most of them are other mods.

Can't I download a mod and be done with it?

Unfortunately, that is not how computers work.

More detail

Cyberpunk 2077 offers native modding support via , but it is limited — if we

Guide: Debugging a mod that's not working

Now that we've gotten the theory out of the way, let's get to the practical part. Below, you find an example of how the process will look – and after that, you find the steps to complete it yourself.

Example

You're trying to get VirtualAtelier to work. There is no log file and you want the full version, so you investigate ArchiveXL.

When you re-do , you can't find a log file for ArchiveXL either, so you look at its dependencies and find that you need Red4ext.

When you re-do with Red4ext, you find an error in its log file that complains about version incompatibility. You realize that you forgot to complete , update Red4ext, and Virtual Atelier starts working.

Rejoice!

Level 1: The mod itself

Situation

You're trying to install a mod — and it's not working. How do we fix this?

Step 0: Open your Cyberpunk game directory

If you aren't there yet, open your Cyberpunk 2077 game folder ("Browse local files" in Epic/Steam/GOG). This is where you installed the game.

Step 1: Try to find its log file

1. Use the Windows Search to find a matching log file (e.g. search for the mod's name - are more instructions if you need them).

2. If you have found a log file, read on under

3. If you have not found one or if it contains no errors or warnings, go to

A log file exists

-> If you can't find one, read on under .

The file is empty

This means that your mod is loaded, but never initialized. Go to

The file has errors

Something is wrong with the mod itself. You can now go and .

The file only has warnings

Your mod is being loaded, so the dependencies are OK (if they aren't, the log file would tell you so).

Warnings in the log file don't necessarily mean that something is outright broken. But since you're here and your mod isn't working, that is probably the case. Proceed with .

There is no log file, or it's empty

The good news: the mod itself is not the problem.

The bad news: you'll have to check its requirements.

: read on under

Level 2: The requirements

Step 1: Finding the requirements

Open the mod's Nexus page and check the Description tab (the first one). You will see something like this:

Step 2: Re-do Step 1 for each requirement

For each of the dependencies, repeat the following steps:

1. Check if it is optional.

   • If there is a condition and you meet it (e.g. "if you are using Codeware" and you are using Codeware), consider it not optional.

2. If it's no optional, install it.

3. If you already have it installed, update it.

Now that you have the requirement installed, it's time to re-do , but do it with the requirement.

This is the documentation for the .

Version Compatibility

CyberCAT is version dependent. If you want a savegame to load with a certain version of the game, you must use the compatible version of CyberCAT.

Usage Instructions

On Windows, save games are stored in

1. Import your savegame

2. Make the necessary changes

3. Export your savegame again. Save it in the same folder.

Appearance Presets

After loading a save, you can export V's appearance as a preset from the Appearance tab. This will create a v2preset file, which you can import via Load Preset.

Adding items

You can add items from the Inventory tab or edit existing items by double-clicking on them.

• Switch inventories in the upper right corner

• Edit items by double-clicking them

• Add new items by using the corresponding button

In the Add Item tab, you can use the dropdown to search the item's base ID. If that doesn't help you, check the top sections of our wiki page on how to find a specific item.

Quest Facts

CyberCAT lets you edit quest facts:

Quest editing: Risks and side effects

While you progress through the main story, Cyberpunk will log your progress by setting quest facts. These are not standardized and will only be checked under specific circumstances, usually when the game is about to trigger the next stage of a quest or event.

Once that moment has passed, there is no way to re-trigger it other than loading an earlier save. This is not an issue of tooling, it's simply due to how Cyberpunk's quest system works.

Can I Change the Outcomes of Quests?

Unfortunately, no. Quest state data is currently not editable with the save editor and there are currently no plans on implementing it.

Can Quest Facts Affect Past and/or Future Quests?

Past: no. Future: Maybe. Almost all quest facts will at best do nothing by setting or changing them and more commonly will break your quest system. There are very few that will work and most are dependent on when they're set.

What Can I Do to Change the Outcome of a Quest?

Your only option is to reload from a previous save and make better choices. If only life worked the same way.

I Really, Really, Really Want to Set a Quest Fact. What Can I Do?

While the save editor currently supports setting them, we recommend using CET commands if you must go down that route. The contains some that might work in very few instances. Again, most of these are not supported and are highly dependent upon when they are set.

Known Issues

• Appearance editor is disabled until its fully fixed.

  • Only gender and voice tone can be changed.

  • Loading / Saving of presets still works

• Item additions might not fully work yet

Troubleshooting

Folder structure

Make sure that you export to a savegame folder. They contain the following files:

• metadata.9.json

• sav.dat

• screenshot.png

CyberCAT needs those files to correctly export the savegame.

Asking for support

Once you have exhausted all other means of support, you can find help in #save-editing on the . Please have the following things handy:

• The original save (before you edited it)

• The altered (damaged) save

• A description of what you did, as concise as possible

• The error.txt (if you have one)

Summary

This page tells you where to find those assets from the E3 demonstrations/trailers that CDPR left in the files.

Female V

E3 2018 Head

In these folders, you will find the assets used for V as seen in the 43-minute 2018 gameplay demo.

2020 Marketing Head

These folders contain the V used in the early 2020 marketing materials and "The World of Cyberpunk 2077", the assets here more closely resemble the final game.

Male V

When compared to female V, male V has fewer remaining assets left over from development (mostly 2018 is missing). However, what we saw of male V in the 2019 Deep Dive demo, early 2020 trailers, and "The World of Cyberpunk 2077" remain behind.

2019 Deep Dive/2020 Marketing

Note that not everything in the foremost folder will be listed, only what's important. There are simply too many assets to list here, most of which are identical to the final game if not straight duplicates.

Textures

Textures for male V here are scattered across two different folders, h0_000_pma_c__basehead and h0_001_ma_c__player respectively.

Melee: audioWeaponConfiguration

guns: audioName

Other

Summary

Published: Dec 31 2024 by Last documented update: Dec 31 2024 by

This page will show you how to find an AMM NPC's files.

Difficulty: You know how to read

Wait, this isn't what I want!

• To change NPC appearances, see

• To create custom NPCs, see

• To create V as an NPC, see

In this guide, we'll go looking for nurse_wa_nurse_wa_01.

We do that by tracking her through AMM's database — an sqlite3 file. Don't worry, this guide will help you navigate it.

Step 1: Find and open the database file

1. Open in a webbrowser

2. Head to

3. Navigate to the subfolder bin\x64\plugins\cyber_engine_tweaks\mods\AppearanceMenuMod

4. Find the file db.sqlite3

5. Drag and drop it on the website

You will now see something like this:

Step 2: Find the entity ID

Variant 1: Copy it from AMM

1. Open AMM's Scan tab

2. Find the Target Info section at the bottom

3. Find the ID field

4. Click the Copy button

Variant 2: Finding it in the database

Find the current appearance

1. Open AMM's Scan tab

2. Find the Target Info section at the bottom

3. Find the Current Appearance under the ID field and write it down:

Find the ID in the database

1. Switch to the website.

2. In the left column, Tables, click on appearances to select the table

3. Optional: Resize the app_name column

4. Type the name into the search field at the top of the column

5. Find the entity ID in the first column, and write it down (green box in the screenshot below)

Step 3: Find the .ent file

Complete the following steps on the sqliteviewer website.

1. In the left column, Tables, click on entities to select the table.

2. Type the entity ID from step 2 into the search field at the top of the first column, entity_id. This should give you one (1) row of data.

3. Optional: Resize fields until you can see the entire entity_path column

4. Find the entity path, and write it down (green box in the screenshot below)

Step 4 (Optional): TweakDBId to entity path

In the entity path column, you will either find a file path (for modded NPCs), or a TweakDB ID (for base game characters).

1. Open Wolvenkit's

2. Pull it wide to make the right panel appear

3. In the search field at the top, search for your TweakDB ID (e.g. Character.NurseFemale)

4. In the property panel at the left, find the entityTemplatePath (the NPC's )

Step 5: Read the

1. Use to find the .ent in the files.

2. Right-click on the file and open it in WolvenKit (you don't need to add it to your project)

3. Find your NPC's appearance in the list: