@netrodev/howtofix-roblox-bridge
v0.1.8
Published
Localhost bridge between HowToFix and Roblox Studio. Serves every open Studio window on one port.
Readme
@netrodev/howtofix-roblox-bridge
The localhost server Roblox Studio connects to.
npx @netrodev/howtofix-roblox-bridgePrints the port and the token. In Studio, enable Allow HTTP Requests (Game Settings → Security), then point the plugin at that port and token.
Options
| flag | meaning |
| --- | --- |
| --port <n> | Bind a specific port. Default 0, which asks the OS for a free one so two projects can run at once. |
Environment
| variable | meaning |
| --- | --- |
| HOWTOFIX_ROBLOX_TOKEN | Use a fixed token instead of generating one. |
| HOWTOFIX_AGENT_DIR | Where the port and token are written. Default ~/.howtofix/agent. |
Why it is a local server, not a client
Studio is a GUI application with no headless entry point, so an outside process cannot call into it. The plugin dials this bridge on loopback and holds the socket open; tool calls are pushed down it.
Because loopback is shared, the token is checked during the HTTP upgrade, before WebSocket framing — every process on the machine can reach the port otherwise.
One bridge serves every open Studio window at once. A request names the window it is for; a request that names none resolves only when exactly one is connected, and with two or more it is an error rather than a guess.
