Weppy Roblox MCP WEPPY

WEPPY

Roblox Studio Plugin Installation Guide

How to connect the Roblox Studio plugin automatically or manually after installing MCP.

How to install the plugin that connects Roblox Studio to the AI agent.

If the MCP server installation is complete, the plugin is installed automatically. No separate download or file copying is needed.

How It Works

  1. The first time the MCP server runs, it automatically places the plugin file (WeppyRobloxMCP.rbxm) in Roblox Studio’s Plugins folder.
  2. When Roblox Studio starts, the WEPPY button appears in the Plugins tab.

Connecting

  1. Open any project in Roblox Studio
  2. Click the top Plugins tab → WEPPY

WEPPY button

  1. Click the Connect button in the plugin window
  2. When “Connected” status is shown, the connection is complete

Plugin main screen

If automatic installation doesn’t work, proceed with the manual installation below.

Manual Installation

Use this when automatic installation doesn’t work, or when you need to install a specific version directly.

1. Download the Plugin

  1. Open GitHub Releases
  2. Download weppy-roblox-mcp-v{version}.zip
  3. Extract the ZIP — it includes the roblox-plugin/WeppyRobloxMCP.rbxm file

2. Install the Plugin

  1. Launch Roblox Studio
  2. Click the Plugins tab in the top menu
  3. Click the Plugins Folder button
  4. Copy WeppyRobloxMCP.rbxm from the extracted folder into the opened Plugins folder
  5. Restart Roblox Studio

3. Verify Installation

After restarting, the WEPPY button appears in the Plugins tab.

WEPPY button

4. Connect

Click the Connect button following the same steps in the “Connecting” section above.

Settings (Optional)

Click the settings button in the top-right of the plugin to change various options.

Settings screen

  • Auto Connect: Automatically connect to the MCP server when Studio starts
  • Auto Reconnect: Automatically retry when the connection is lost
  • Auto Camera Focus: Automatically move the camera to newly created objects
  • Language: Change the plugin UI language

Tier Notes

  • Basic installs the same plugin package and operates under the Basic policy (Studio → Local one-way Sync).
  • Activating a Pro subscription license enables bidirectional Sync and a broader range of advanced tool features.

Troubleshooting

Plugin Not Visible

  • Fully quit Roblox Studio and restart it
  • Check that the file was properly copied to the Plugins folder
  • Confirm the .rbxm file is not corrupted

Connection Fails

  • Confirm the MCP server is running in your AI app
  • Click the Connect button in the plugin again
  • Check whether port 3002 is in use by another program

Connection Drops Frequently

  • Enable the Auto Reconnect option in settings
  • Restart your AI app