Help

Troubleshooting

Common issues and how to fix them.

Studio Plugin Shows "Disconnected"

1. Make sure the RoCodex binary is running (check your system tray or terminal)
2. Go to Game Settings > Security and enable "Allow HTTP Requests"
3. Restart Roblox Studio
4. Check that port 48123 is not blocked by your firewall

AI Tools Not Showing Up

1. Restart your coding agent after installation
2. Check that the MCP config file contains the RoCodex entry (see Configuration)
3. Make sure the RoCodex binary path in the config is correct
4. Try running the binary manually in a terminal to check for errors

Execution Times Out

If execute_luau_in_studio times out:

• Make sure Roblox Studio is open with a place file loaded
• Check that the Studio plugin shows "Connected"
• Make sure HTTP Requests are enabled in Game Settings
• Try a simpler command first, like print("hello")

Docs Search Returns No Results

The documentation search requires internet access. Check:

• Your internet connection
• Firewall or antivirus isn't blocking the RoCodex binary
• VPN settings (try disconnecting)

License Issues

If you see "Invalid license key" or "License expired":

1. Check your subscription status at rocodex.net/pricing
2. Delete %USERPROFILE%\.rocodex\license.json and re-run the installer
3. Make sure you're entering the correct license key (check your email)

Installer Fails

If the PowerShell installer fails:

• Run PowerShell as Administrator
• Make sure PowerShell 5.0+ is installed
• Check that TLS 1.2 is enabled (the installer sets this automatically)
• Temporarily disable antivirus and try again

Still Having Issues?

If none of the above fixes your problem, reach out for support:

• Check the Changelog for known issues in the current version
• Join our community for help from other developers