Wiki / REDnode
Settings and controls
Launcher switches
All of REDnode’s settings are at the bottom of the launcher (F10, then the REDNODE tab). REDnode saves them and remembers them across game starts.
Screenshot comingThe launcher's settings
| Setting | Default | What it does | Change it when |
|---|---|---|---|
| GPU sharing | on | Windows reach the game as shared GPU textures, with no copying of pixels. Off, they’re copied through the CPU instead. Switching reopens every window | A window looks wrong (garbage, flicker, stale pictures). If GPU sharing fails, REDnode switches it off by itself for that session |
| Hot reload | off for players | Restarts a mod, or reloads an app’s page, when its files change | You’re making or editing a package, or REDagent is |
| MCP server | off for players | Lets Claude Code and other programs on your PC use REDnode’s MCP tools | You want Claude Code to see and call the game |
| Copy setup | Copies the command that adds REDnode to Claude Code | Once, after switching the MCP server on | |
| Developer mode | off | A debug button on every window’s title bar | You’re debugging a package |
| Space: New, Rename, Delete | one space, Main | Your spaces | You want sets of windows to switch between |
| Theme: REDnode, HUD red, EDGE | REDnode | The look of every UI kit window | To taste |
Per package, in the launcher or the Mod Manager:
| Setting | Default | What it does |
|---|---|---|
| On or off | From the package (open) |
Whether the app is open or the mod runs |
| Pin to launcher | Off for new packages | Lists the package in the launcher |
| Pin to HUD | Off for new packages | Keeps its windows on screen during gameplay |
| Shared process | Off | Runs the Node mod in one process with other shared mods, to save memory |
| Allowed, per permission | Off | Grants a permission the package asks for |
| Space | The space you were in when it first opened | Where its windows show |
| Debug (Node inspector) | Off, not saved | Runs the Node mod with Node’s inspector for debugging |
Keys
| Key | Where | Does |
|---|---|---|
| F10 | In the game | Passive, interactive, hidden, and round again |
| Esc | Interactive mode | Back to passive. Ends a held cursor first |
| Click empty screen | Interactive mode | Back to passive |
| Ctrl+1 to Ctrl+9 | Overlay open | Switch space |
| Ctrl+C, Ctrl+V, Ctrl+X, Ctrl+A, Ctrl+Z | The front window | Copy, paste, cut, select all, undo |
The F10 key can’t be changed yet.
Permissions
What a package can ask for in its manifest’s permissions, and the name you see in the launcher:
| In the manifest | The launcher says it asks for | Gives |
|---|---|---|
mcp |
REDnode’s tools for AI agents (the kernel MCP server) | kernel.mcp(): the MCP tools for its own agent |
agent |
questions to the AI assistant (REDagent); each answer costs you a little | agent.ask |
bridge |
REDbridge, WolvenKit’s engine: reads the game’s archives and files, and can write files where the package asks | kernel.bridge() |
front |
staying above other packages’ windows, with REDnode’s own tools | The tool layer |
solo |
hiding every other package’s windows while it asks (solo mode) | ui.solo() |
Manifest fields
Every field of rednode-app.json:
| Field | For | Means |
|---|---|---|
id |
All | Unique. Lowercase letters, digits, - and _. Settings and positions are saved under it |
name, version, author, description |
All | Shown in the launcher and Mod Manager |
main |
Node mods | The file to run, relative to the folder. .mjs for import syntax |
entry |
Apps | The page to show, relative to the folder |
width, height |
Apps | Window size in pixels at 1080p, 1 to 4096. Needed with entry |
anchor |
Apps | top-left (default), top, top-right, left, center, right, bottom-left, bottom, bottom-right |
x, y |
Apps | Offset from the anchor in 1080p pixels. With bottom-right, x: -40 is 40 px in from the right edge |
kind |
Apps | window (default) or hud: drawn, never focused, never dragged |
hideWith |
Apps | Game states that hide the window: menu, photo-mode, scene, main-menu |
open |
All | Start open or running, until the player changes it |
isolation |
Node mods | process: always its own process, never shared. For mods with native addons |
permissions |
All | Powers to ask the player for (above) |
requires |
All | Other mods it needs, with version ranges. See Requirements |
provides |
All | What it offers other packages. Today only agent, as REDagent does |
Files and folders
| What | Where |
|---|---|
| REDnode | red4ext\plugins\REDnode in the game folder: REDnode.dll, Scripts, host, apps |
| Packages | red4ext\plugins\REDnode\apps, one folder each |
| Settings, positions, spaces, permissions, secrets, packages’ data | %APPDATA%\@rednode\overlay |
| Logs | red4ext\logs in the game folder: rednode-overlay.log, rednode-mods.log, the plugin’s rednode-*.log |
The MCP server’s port, 41820, can be changed as mcp.port in the host’s settings.json in that folder. Close the game first.
For developers: running the host by hand
From a REDnode checkout you can run the overlay host yourself instead of the packaged one, with switches the launcher doesn’t have, such as several apps folders at once or a forced render path. Hot reload and the MCP server are then on by default. The options are in the overlay host README. Only one host runs at a time: one you started first keeps the game’s connection.