REDscript is a statically-typed, object-oriented programming language designed for developing scripts for the REDengine, CD Projekt's game engine used in Cyberpunk 2077. If you want to learn more about the language, visit the official wiki.
To compile your scripts automatically on game startup, follow these steps:
- Download the
redscript-mod-{version}.ziparchive from the latest release. - Extract it into the main
Cyberpunk 2077directory. - When you start the game, successful setup can be confirmed with logs appearing in
Cyberpunk 2077/r6/logs/redscript_rCURRENT.log.
REDscript provides extensive editor tooling, including a language server and a debugger that integrate with many popular editors such as VSCode, neovim, IntelliJ IDEA, Zed, and Helix. For detailed setup instructions, check out the REDscript IDE repository.
This project includes various tools for working with REDscript, such as a compiler, a decompiler, and a formatter. These are organized as modular Rust crates located in the crates directory:
cli- Exposes a command-line interface serving as the entry point for all tools in this project.compiler/frontend- Performs static analysis on REDscript syntax, lowering it to an intermediate representation.compiler/backend- Generates bytecode from the intermediate representation and handles monomorphization for generic functions and types.compiler/api- Provides a high-level API for interacting seamlessly with the compiler.io- Reads and writes binary files in the native REDengine format.scc/cli- Exposes a CLI that acts as a drop-in replacement for the original compiler made by CD Projekt.scc/capi- Exposes a C API with an interface similar to thesccCLI, but with some additional capabilities like source mapping.scc/shared- Contains common code used across the scc C API and CLI.syntax/ast- Defines the Abstract Syntax Tree (AST) for REDscript.syntax/formatter- Formats REDscript source code according to configuration.syntax/parser- Parses REDscript source code into the AST.