Setting up Redscript and VSCode

How to configure your setup

Created by HJHughJanus on github, moved here for better maintainability

1. Install redscript

1. Download redscript from github:

The zip file will contain the following folders:

- engine
- r6

2. Extract it directly into your directory, so that the folders merge with the ones already there.

3. Start the game so that redscript can set itself up.

4. Check the folder Cyberpunk 2077\r6\logs : if redscript has done its thing, you will now see a file named redscript_rCURRENT.log

You can now put your redscript mods into Cyberpunk 2077\r6\scripts and they will be automatically loaded when the game starts.

2. Setting up VSCode

1. Download and install VSCode.

2. After starting it, click on the Extensions icon in the left menu bar:

3. Search for redscript and install the Redscript Syntax Highlighting extension. Do not close the tab yet.

4. Download the redscript extension from github:

5. In VSCode, click the … symbol in the topright of the extension manager and select Install from VSIX…:

6. Navigate the file picker to your downloads folder and install the file from step 4.

7. Your extension manager will now show both addons as installed. If it does not, restart VSCode.

8. Click on the cog menu next to redscript-ide-vscode:

8. Set up the path to your cyberpunk install in VS Code preferences.

9. Save the settings

3. Testing the tools

You need to restart VSCode before the redscript language server will start working

1. Create a mod development folder somewhere (example: D:\Cyberpunk\redscript_modding)

2. Inside the folder, create a plain text file with a .reds extension (e.g. MyMod.reds)

3. Open VSCode and click Open Folder, then point it at your mod development folder from step 1

4. On the left, you should see the file you created in step 2. Open it and paste the following (incorrect) code snippet:

//add field to NPC class
@addField(NPCPuppet)
let testField: bool;

5. Save the file (Hotkey: Ctrl+S).

6. You should see an error, because bool should be Bool.

7. Hover your cursor over the error, you should see something like this:

8. Correct the code:

//add field to NPC class
@addField(NPCPuppet)
let testField: Bool;

9. Save again — everything should work now.

If you want to make a redscript mod, you can check out How to create a hook (originally by HJHughJanus on github)