> For the complete documentation index, see [llms.txt](https://wiki.redmodding.org/cyberpunk-2077-modding/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://wiki.redmodding.org/cyberpunk-2077-modding/for-mod-users/users-modding-cyberpunk-2077/getting-started/vortex-mod-manager.md). # Vortex Mod Manager Installing and setting up Vortex Mod Manager, the recommended way to install, manage, and upgrade mods. ## Summary **Last documented update:** September 5th, 2026 by [minnierylands](mailto:undefined) {% hint style="danger" %} **Windows 10 or higher is required to use Vortex mod manager. If you are not using Windows, see our Manual Install page.** {% endhint %} Vortex is a multi-game mod manager developed for and by [Nexus Mods](https://www.nexusmods.com/), the website where most [Cyberpunk 2077 mods](https://www.nexusmods.com/cyberpunk2077) are hosted. Here you can download mods manually or with Vortex and keep track your download history. {% hint style="info" %} To use Vortex, you need an account there. If you don't have one, you can sign up [here](https://users.nexusmods.com/register) – don't worry, it's free. {% endhint %} *** ## Why do I need this? Technically speaking, you don't. You can [install mods manually](/cyberpunk-2077-modding/for-mod-users/users-modding-cyberpunk-2077.md#manual-install) or use [Mod Organizer 2](https://www.modorganizer.org/) (but without our support, sorry, choom). However, Vortex for Cyberpunk is the most beginner-friendly way of managing your mods and will save you a lot of hassle. {% hint style="success" %} If you have PTSD from modding Skyrim or Fallout with Vortex, be assured that Vortex for Cyberpunk is integrated **extremely** well. Go ahead, give it a try! If you run into issues with Vortex that aren't addressed in this guide, you can contact [Nexus support](https://github.com/Nexus-Mods/Vortex/wiki) or join our [Discord](https://discord.gg/redmodding) and find (volunteer) help in the #vortex-support channel. {% endhint %} *** ## TL;DR * Your staging folder **must** be on the same drive as your game installation * Your staging folder **must be separate** from your game install directory * Vortex has [a lot of options](#settings). If you put wrong options, mods can go brr. *** ## Download Once you're signed in on Nexus, it's time to download Vortex Mod Manager. {% hint style="info" %} If you can download it on your own, you can skip to the [Install](#installation) or [Setup](#setup) section of this guide. {% endhint %} 1. Click [this link](https://www.nexusmods.com/site/mods/1), it will take you directly to the download page 2. Select the "Manual Download" option on the first entry:

3. You'll now see a download page. If you don't have Nexus Premium: 1. Select "Slow Download" 2. Wait through the five seconds cool down 4. Optional, depending on your browser: * Select your download location for files that you don't want to keep 5. Wait until the installer is downloaded {% hint style="success" %} Nice, now the installer should be downloaded! You can proceed with the steps in the next section. {% endhint %} *** ## Installation {% hint style="info" %} This guide will assume that you install Vortex to `C:\Program Files\Black Tree Gaming Ltd\Vortex`. You can install it wherever you want, but then you need to adjust accordingly. {% endhint %} 1. Run the installer by double-clicking it. 2. If Windows shows you a prompt now, select **yes** — you want the setup to make changes on your device, it's supposed to install Vortex. 3. Click through the setup and finish its instructions! {% hint style="success" %} Congrats! You've finished installation! Vortex should launch automatically and you can now move onto setup. {% endhint %} *** ## Setup Here is where we get into the weeds, the particulars of Vortex setup before we can use it. {% hint style="info" %} If you can setup Vortex on your own, skip to the [Settings](#settings) section of this guide. (Why are you reading this?) {% endhint %} #### Logging In To Nexus Mods {% hint style="success" icon="exclamation" %} If you are already logged in, proceed to the next section: [Adding Cyberpunk](#vortex-adding-cyberpunk) {% endhint %} 1. If Vortex didn't open by itself, open it from the start menu 2. Log into Nexus Mods by clicking on the red circle in the top right of your client

3. This should open a browser window that looks like this:

{% hint style="warning" %} If you see the below error message instead, copy the URL in the box at the bottom and open the browser window yourself. {% endhint %}

If your browser doesn't open automatically, copy the url starting with users.nexusmods in the box

4. Allow Vortex to access your Nexus Mods account by clicking "Authorize":

6. Click "Log in to Vortex":

7. Instead of the blank/red icon, you should now see your profile picture and username from Nexus Mods. *** ### Managing Cyberpunk This section will tell you how to add Cyberpunk to Vortex's managed games. 1. On the sidebar on the left side of your dashboard, click "`Games`" 2. In the page that shows up, type "`Cyberpunk`" into the search bar 3. Hover over its thumbnail and click "`Manage`" 4. You will now see a popup complaining about "`Game support not installed`". Don't panic, this is expected! 5. You will require the vortex extension for Cyberpunk 2077. You can download this through Vortex on the Extensions tab. 6. Search for Cyberpunk 2077 and click install. 1. Your Vortex extension should now be installed, and should say `0.13.0` (or whatever the latest version is on Nexus Mods) in the `Version` column.

7. If your extension is not the latest version, [you can download the Cyberpunk 2077 Vortex Extension here](https://www.nexusmods.com/site/mods/196?tab=files). 8. Click `Mod manager download` - this will download it straight to Vortex. 9. **You need to restart Vortex** – agree to the prompt if there is one. If not, manually close Vortex and re-open it. {% hint style="success" icon="exclamation" %} If Vortex was able to auto-detect your game install, you're all set and can proceed to the [Settings](#settings) section! {% endhint %} 10. Vortex will tell you that it couldn't detect your game install and prompt you to set it manually. Click "`Continue`". 11. In the explorer window that pops up, navigate to the folder containing your Cyberpunk exe (e.g. `C:\Games\Cyberpunk 2077\bin\x64`) 12. Once you are in the correct folder, click "`Select Folder`" {% hint style="success" icon="face-smile-beam" %} Vortex can now manage your game! Proceed to the next section, [Settings](#settings). {% endhint %} *** ### Vortex General Settings This section tells you how to set the recommended settings in Vortex, grouped by tab. This guide won't go through every setting available, only the ones relevant to modding Cyberpunk. If a tab isn't covered, there are no specific recommendations - you can choose what you'd prefer. {% hint style="info" icon="exclamation" %} Start by clicking "`Settings`" in the left sidebar of your Vortex Dashboard, then select the first tab. {% endhint %}

#### Interface

This section controls how Vortex looks and behaves. If this is your first time using Vortex, just leave it at the defaults and scroll down to "`Automation`". #### Interface -> Advanced

#### Interface -> Automation The settings here tell Vortex what to do with your mods as it gets them. Here's a screenshot of the recommended settings with an explanation below:

To put a mod in the game, Vortex requires you to complete four steps. The folders for these are configured in the [Mods section](#mods). 1. Downloading: Putting the mod into Vortex's download cache, either by clicking the button on Nexus or by dragging-and-dropping a file onto the Vortex window. The archive will now live in Vortex's **download directory**. 2. Installing: Unpacks the mod and copies it to Vortex's **staging** directory. 3. Enabling: This mod should be included in the next deploy 4. Deploying: The mod has been copied from Vortex's **staging** directory to your Cyberpunk **game** directory.


Deploy mods when Enabled	Automatically deploys each mod as you enable it, merging step 3 and 4. We recommend enabling this, as it saves you a click.
Install Mods when downloaded	Automatically completes step 2 when you download a mod. We recommend disabling this as it lets you address issues and popup one after the other
Enable Mods when installed	Automatically completes step 2 when you install a mod. We recommend enabling this, as it saves you a click.
Run Vortex when my computer starts	Starts Vortex with Windows - disable or enable at your discretion

{% hint style="info" %} In theory, you can configure Vortex so that you hit the download button on the website and it will download, install, enable and deploy for you. The downside with that is that you might not notice errors as they pop up in the background, which is why we recommend doing that one single click by yourself. {% endhint %} #### Downloads Where Vortex stores downloaded archives. Can be wherever you like, even on a different drive.

{% hint style="info" icon="exclamation" %} We recommend keeping an extra folder in there for manually downloaded mods, as Vortex can manage these as well – you just have to drag-and-drop them into the Vortex window. {% endhint %} *** #### Cyberpunk Specific Settings You can find the game specific settings by clicking the Cyberpunk 2077 image on the left hand sidebar, then clicking "`Game Settings`"

*** #### V2077 Settings There is only one option under V2077 Settings:

It is recommended to keep this toggled **off -** turning it on could mean you miss potential issues with mods being installed. *** #### Mods This section controls Vortex file storage. It's mostly a matter of personal preference and your disk space availability.

#### Mods -> Mod Staging Folder This is where Vortex keeps mods, ready to deploy them into the Cyberpunk game directory. {% hint style="danger" icon="exclamation" %} This folder: * **must** be on the **same drive as your game installation**, or deploy will fail * **must not** be your [game install directory](/cyberpunk-2077-modding/for-mod-users/users-modding-cyberpunk-2077/the-cyberpunk-2077-game-directory.md) (where your game files are) {% endhint %} The default folder location is `{USERDATA}\{GAME}\mods`, which translates to:\ `C:\Users\YourUsername\AppData\Roaming\Vortex\cyberpunk2077\mods` You can keep it as this, or you can make a folder for it in a place you can easily access it, such as:\ `C:\Games\Mods`. {% hint style="warning" icon="thought-bubble" %} Wherever you decide, you want to make sure it is accessible and you can remember it in case of issue. {% endhint %}

#### Mods -> Deployment Method Make sure the Deployment Method is set to "`Hardlink Deployment`" - this should be the default setting.

*** ### Tools Along the sidebar, you should see a heading labelled "`Tools`". You should at least see four things, the last of which will be disabled:

These are different options to launch the game via Vortex. In most cases, you won't have to mess with any of these options at all. *** ## Installing mods This section will teach you how to install mods. Keep reading! {% hint style="danger" %} You can browse different mod collections [on Nexus,](https://next.nexusmods.com/cyberpunk2077/collections) but caution: collections tend to be **outdated** or **abandoned**. Collections require constant upkeep, and most collection makers just don't do that. You **can** use collections as a reference list, though. Just download the mods you want individually; that way you definitely have the latest versions of them all. {% endhint %} *** ### Mod Manager Download On Nexus, you download mods from the `FILES` tab on mod pages. {% hint style="warning" %} When you open a mod's page, make sure to read the description first; most mod authors will give detailed instructions for how to download, which optional files are available, and what to expect in game. {% endhint %} Since you're using a mod manager, you get to use the handy `Mod manager download` button! Since you've linked your Nexus account, clicking this will send the files straight to Vortex. It doesn't get much easier than this.

This is the `FILES` tab for Redscript - all the important parts of the page have been highlighted for you!

{% hint style="warning" %} Don't download anything just yet - we'll get to that next moment, promise! {% endhint %} *** ### Installing the Core Mods {% hint style="success" %} The game should always be able to launch with just the core mods enabled. If it doesn't, head over to the [troubleshooting page](/cyberpunk-2077-modding/for-mod-users/user-guide-troubleshooting.md#troubleshooting-first-steps) and make sure that you can launch and start a new game. {% endhint %} {% hint style="danger" %} Check if you have an up-to-date version of the **core mods**. Outdated collections can include earlier versions. If you update them, there's a good chance that everything will work. {% endhint %} The following mods are **requirements** for many other Cyberpunk mods. We recommend you install their latest version and keep them up-to-date, since you will run into them sooner or later. **The Core Mods:** * [Cyber Engine Tweaks](https://www.nexusmods.com/cyberpunk2077/mods/107) * [RED4ext](https://www.nexusmods.com/cyberpunk2077/mods/2380) * [redscript](https://www.nexusmods.com/cyberpunk2077/mods/1511) * [ArchiveXL](https://www.nexusmods.com/cyberpunk2077/mods/4198) * [TweakXL](https://www.nexusmods.com/cyberpunk2077/mods/4197) * [Codeware](https://www.nexusmods.com/cyberpunk2077/mods/7780) For more information on the core mods, check [Core Mods explained](/cyberpunk-2077-modding/for-mod-creators-theory/core-mods-explained.md) {% hint style="warning" %} Some mods that depend on **redscript** may say they require [cybercmd](https://www.nexusmods.com/cyberpunk2077/mods/5176), but it's unnecessary to install.**RED4ext** performs the same functionality (and more). {% endhint %} Let's download Cyber Engine Tweaks together, and then you can repeat the same process for the other mods listed above! {% stepper %} {% step %} **Find The Mod** First, you need to go to the [Cyber Engine Tweaks mod page](https://www.nexusmods.com/cyberpunk2077/mods/107). You'll see this page many times as you download mods, with their own information, content, and requirements. Make sure to check them! {% endstep %} {% step %} **The Files Tab** Now, we need to go to the `FILES` tab, next to the `DESCRIPTION` tab on the mod page.

A full picture of the top of a mod page, so you can see where these tabs are

{% endstep %} {% step %} **Download The Mod** Now that you're on the `FILES` tab, you'll see a section that says `Main Files` - this is where the file you need to download lives. Navigate to the top file listed and click the `Mod manager download` button.

You need to click the first big orange button at the bottom

{% hint style="warning" %} Most downloads will have a pop-up box at this point with a **list of required mods** - this is to remind you to download them! It's good practice to **check the `Requirements` tab** on the `Description` page before you download mods! Cyber Engine Tweaks **doesn't have any requirements**, so it won't pop up this time, but it will for most other mods! {% endhint %} There will be a pop-up - cilck `Slow Download`. This will give a short timer before your mod begins downloading. {% endstep %} {% step %} **Back To Vortex** {% hint style="danger" %} Sometimes, Vortex will bring up a screen saying a mod may need manual adjustment, or that there was an unexpected file layout. Make sure to read these pop-ups, as they usually tell you exactly what the issue is! If you ever get one that you're not sure about, or it just leaves you confused, [head on over to our Discord](https://discord.gg/redmodding) and someone will help you figure it out! {% endhint %} Now, if you kept the default `Bring Vortex to foreground when starting downloads in browser` setting enabled, Vortex should pop up on your screen. If you turned that setting off, you can click on Vortex. {% hint style="success" %} There should now be a `1` next to `Downloads` on the left side of Vortex! {% endhint %} {% endstep %} {% step %} **Start The Game** If you left the Vortex settings as default, the mod should already be enabled and deployed! {% hint style="warning" %} If you changed any of these settings, you'll have to click `Enable` button on the mod in the `Mods` tab, and then the icon of a linked chain along the top bar to `Deploy` it. {% endhint %} Before you start the game, check the bell in the top right corner next to your profile picture. Click it to expand the notifications. What you want to see is all green or blue. Any red or orange issues will need to be resolved before starting your game.

Notifications are ordered with most recent at the top, which means there was a successful REDmod deployment notification AFTER the failure, so the failure can be safely dismissed.

{% hint style="success" %} If all went well, you should see a prompt to bind an overlay key for **Cyber Engine Tweaks** (CET)! (If it does not, [check here](/cyberpunk-2077-modding/for-mod-users/user-guide-troubleshooting.md#cyber-engine-tweaks-isnt-working)). You can assign whatever you like, this button will hide or unhide the CET overlay. This means everything is working, and you've successfully installed your first mod! {% endhint %} {% endstep %} {% step %} **Download The Other Core Mods** Now that you've downloaded and successfully installed Cyber Engine Tweaks, you know how to download the other core mods! To make life easier, you can click the links below to take you straight to the mod pages! * [RED4ext](https://www.nexusmods.com/cyberpunk2077/mods/2380) * [redscript](https://www.nexusmods.com/cyberpunk2077/mods/1511) * [ArchiveXL](https://www.nexusmods.com/cyberpunk2077/mods/4198) * [TweakXL](https://www.nexusmods.com/cyberpunk2077/mods/4197) * [Codeware](https://www.nexusmods.com/cyberpunk2077/mods/7780) {% hint style="warning" %} If you get stuck, go back over the steps above with the mod you're trying to download - it gets easier the more you do it. {% endhint %} {% endstep %} {% endstepper %} *** ### Manual Download Sometimes, you'll go to download a mod and won't see the `Mod manager download` button. Mod authors sometimes disable mod manager integration for a variety of reasons. In these cases, you'll need to click `Manual download` and add the mod to Vortex yourself. Usually, Vortex can handle these files just fine – if not, it will complain about it, and loudly so. {% hint style="warning" %} It may seem odd to manually download a mod and then still put it into your mod manager, but it's to make your life easier in the future. Mixing manual and mod manager downloads is *not* recommended, and can make potential troubleshooting way harder than it needs to be. {% endhint %} Let's download a mod that only allows for manual download and add it to Vortex, so you can get used to the steps involved. Don't worry, it's not too different from what you're used to already! {% hint style="danger" %} This guide assumes you have also followed the [#mod-manager-download](#mod-manager-download "mention")guide - it's important as it lays the groundwork for installing mods through Vortex! {% endhint %} {% stepper %} {% step %} **Find The Mod** For the sake of this guide, we'll say you've found [Meluminary's Kimber Space Buns](https://www.nexusmods.com/cyberpunk2077/mods/19255) hair mod. {% hint style="warning" %} Again, it's important to read the mod description and check for any requirements on *any* mod you download, including this one. {% endhint %}

{% endstep %} {% step %} **The Files Tab** Navigate to the `FILES` tab. You'll immediately notice that the main file only has one download option - \`Manual download\`.

Before you download the mod, it's worth pressing the `Preview file contents` text underneath the download button. This can show you if there's multiple files included in the download, if it comes with the proper folder structure, or, for this mod, which hair slot it replaces. {% hint style="warning" %} Sometimes, mods that don't come in pre-defined folder structures can end up in the wrong places. For now, you don't need to worry about that, but if you want to check what this means, [you can read more about it here](/cyberpunk-2077-modding/for-mod-users/users-modding-cyberpunk-2077.md#fixing-broken-mod-file-paths). {% endhint %}

This shows us the mod author, which hairstyle slot it replaces (Hair 5), and the name of the mod!

{% endstep %} {% step %} **Download The Mod** Just as before, download the mod. This time, it'll be `Manual download` - which means Vortex won't pop up on your screen. Instead, it'll download directly to your computer. {% endstep %} {% step %} **Back To Vortex** Open your Vortex window back up and navigate to the `Downloads` tab on the left side.

You should see a box at the bottom that says `Drop URL(s) or File(s).` You can drop the zip file you just downloaded into this box.

If that doesn't work, there is another way! 1. Click on the Cyberpunk image on the sidebar. 2. Navigate to the `Mods` tab. 3. Along the top bar, you should see a button that says `Install From File` - click this and select the zip file you just downloaded.

{% endstep %} {% step %} **Start The Game** Make sure the mod is enabled and deployed before you launch the game! {% hint style="warning" %} If you changed any of these settings, you'll have to click `Enable` button on the mod in the `Mods` tab, and then the icon of a linked chain along the top bar to `Deploy` it. {% endhint %} Start a new game and select a female-bodied V. In the character creation screen, go to the `Hairstyle` category and select hair 05, which normally looks like this:

It's pretty, but it's not quite space buns, is it?

{% hint style="success" %} If all went well, your V should now have space buns! {% endhint %}

If V doesn't have spacebuns, you'll need to try installing the mod again. {% hint style="warning" %} Most of the time, a mod will have more than just a singular `.archive` file. Occasionally, a mod author won't set up the correct structure for files to end up where they need to be. This one worked because it was a single `.archive` file, and the Cyberpunk Vortex extension is smart enough to fix it for you when you install the mod. If you're running into constant issues with a mod not showing, even after making sure you've done every step correctly, you might have to do a little bit of adjustment yourself.\ [To find out how, check here!](/cyberpunk-2077-modding/for-mod-users/users-modding-cyberpunk-2077.md#fixing-folder-paths-in-vortex) {% endhint %} {% endstep %} {% endstepper %} Congratulations! You know how to use Vortex! --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://wiki.redmodding.org/cyberpunk-2077-modding/for-mod-users/users-modding-cyberpunk-2077/getting-started/vortex-mod-manager.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.