1
Get Your Open Cloud API Key
This is the most important step. Without it, uploads won't work.
1.1 Go to Roblox Creator Dashboard
Visit: create.roblox.com/dashboard/credentials
1.2 Create an API Key
- Click "Create API Key"
- Name it:
MotionForge Pro - Under "Access Permissions", select:
- ✅ Asset: Read
- ✅ Asset: Write
- Under "Security", add your IP or leave unrestricted
- Click "Create Key"
- Copy the key immediately — Roblox only shows it once
⚠️ Important
Save this key somewhere safe. If you lose it, you'll need to create a new one.
1.3 Add the Key to MotionForge Pro
- Open MotionForge Pro
- Go to Settings tab
- Paste your key in the "Default API Key" field
- Click Save
2
Install the Roblox Studio Plugin
2.1 Install from MotionForge Pro
- In MotionForge Pro, go to Settings tab
- Click "Install Plugin"
- The plugin copies to Roblox Studio's Plugins folder automatically
📍 Where it goes
Mac: ~/Library/Application Support/RobloxStudio/Plugins/
Windows: %LOCALAPPDATA%\RobloxStudio\Plugins\
2.2 Enable in Studio
- Open Roblox Studio
- Go to Plugins → MotionForge Pro
- The plugin panel appears
💡 Not seeing it?
Try restarting Studio or reinstalling the plugin from Settings.
3
Add Your Roblox Account
MotionForge Pro needs your account to download assets.
3.1 Auto-Detect (Recommended)
- Make sure Roblox Studio is running and you're logged in
- In MotionForge Pro, go to Accounts tab
- Click "Add Account"
- Click "Detect from Studio"
- Your account appears in the list
3.2 Manual (If Auto-Detect Fails)
- In Studio, open Developer Tools (View → Developer Tools)
- Go to Application → Cookies → https://www.roblox.com
- Find
.ROBLOSECURITYand copy its value - In MotionForge Pro, paste it in the Manual tab
4
Scan Your Assets
4.1 Open Your Game in Studio
- Open the game/place containing assets you want to transfer
- Wait for it to fully load
4.2 Scan from MotionForge Pro
- Switch to MotionForge Pro
- Click "Scan from Studio" button
- The plugin scans your entire game tree
- Assets appear in the Asset Explorer
⏱️ Large games
May take 10-30 seconds. The plugin yields periodically to avoid freezing Studio.
5
Select and Transfer
5.1 Select Assets
- In the Asset Explorer, check boxes next to assets you want
- Or use "Select All" per asset type
5.2 Configure Transfer
- Go to Transfer tab
- Select your account from dropdown
- Choose upload target (your inventory or a group)
- Select asset types to include
5.3 Start Transfer
- Click "Start Transfer"
- Watch progress in the output log
- Pause or cancel anytime
📦 What happens
Download: Assets fetched from Roblox CDN
Upload: Each asset uploaded via Open Cloud API
Replace: New IDs pushed back to Studio (if Auto-Replace is on)
?
Troubleshooting
"No API key configured"
Go to Settings → Open Cloud → paste your key. See Step 1 above.
"Studio Offline" status
- Make sure Roblox Studio is running
- Check that the plugin is enabled (Plugins → MotionForge Pro)
- Try clicking "Scan from Studio" to trigger connection
"API key unauthorized"
- Your key may be missing permissions
- Go to create.roblox.com and verify it has Asset: Read and Asset: Write
- Create a new key if needed
"No assets detected"
- Make sure your game is fully loaded in Studio
- Try clicking "Scan from Studio" again
- Check that assets are actually in the game (not just referenced)
Plugin not appearing in Studio
- Reinstall from MotionForge Pro Settings
- Restart Roblox Studio
- Check the Plugins folder path is correct