RAGE Script Manager

Write, push and run Lua inside a running RAGE game on a jailbroken PS4 — without restarting the game.

The editor talks to a GoldHEN plugin over its control channel. Save a file, press Ctrl+Alt+R, and the script is on the console and running before you have let go of the key. Errors come back as squiggles on the line that raised them.

This extension is only the editor half. It needs the Luma plugin running on the console. Luma is a single plugin that serves both games, listening on a different port for each:

The plugin is a separate project from this extension and is not published yet, so there is nothing to link to. Without it running on the console there is nothing for this extension to talk to.

One extension serves both games for the same reason one plugin does: it speaks the protocol and sends relative paths, and the plugin resolves them under whichever game's data root it detected at boot. Nothing here is game-specific except the port you point it at.

Getting started

1. Deploy the plugin and start the game (see that project's README).
2. Set rageScriptManager.host to your console's IP, and rageScriptManager.port to the port from the table above. Both are workspace settings, so a GTA V workspace and an RDR2 workspace can sit open side by side.
3. Run RAGE: Connect.

Commands

All under the RAGE: category in the Command Palette.

Push & Restart decides where a file belongs by its path: something under resources/<name>/ is written there and that resource is restarted, anything else goes to scripts/ and reloads the script directory.

Settings

Two things worth knowing

The channel serves one client at a time. Run Disconnect before pointing another tool at the same port, or the second connection is accepted and then never answered — which looks exactly like a hang.

There is no authentication unless you add it. Anyone who can reach the port can run arbitrary Lua in the game. That is the same trust level GoldHEN's FTP already grants on the same network: fine on a home LAN, not fine anywhere else. Write a secret to the plugin's token file and set rageScriptManager.token to match, and the channel refuses everything else.

Type definitions and autocomplete

Autocomplete for the game's natives comes from the plugin project, not from this extension: each project generates a lua-defs/ folder and wires it up through .luarc.json. It needs the sumneko.lua extension. The definition files are large (tens of thousands of lines), which is why they live with the game they describe rather than being bundled here.

The extension knows about them only well enough to refuse to push one to the console — a type stub in scripts/ would be run on every boot from then on.

Licence

MIT.