Setup Guide

From installation to your first asset transfer in 5 steps

0

What You Need to Know

Before setting up MotionForge Pro, here's a quick explanation of the two things you'll need: your Roblox cookie and an Open Cloud API key.

๐Ÿ“‹ What is a Roblox cookie?

โ–ผ

When you log into Roblox, your browser stores a small piece of text called a cookie โ€” specifically, the .ROBLOSECURITY cookie. Think of it like a temporary password that keeps you logged in.

MotionForge Pro uses this cookie to:

  • โœ… Download assets from your Roblox account
  • โœ… Verify who you are (so we know which assets belong to you)
  • โŒ Never share it with anyone โ€” it stays on your computer only

๐Ÿ”’ Is it safe to put my cookie into MotionForge Pro?

Yes. Your cookie is stored locally on your computer, encrypted at rest. It never leaves your machine โ€” we don't have servers that store it. The app uses it only to talk directly to Roblox's servers from your computer, the same way your browser does.

Important: Never share your cookie with anyone else, and never paste it into websites or Discord DMs. Only use it in trusted desktop apps like MotionForge Pro that run on your own computer.

๐Ÿ”‘ What is an Open Cloud API key?

โ–ผ

Roblox provides an official API called Open Cloud that lets developers upload assets programmatically. An API key is like a special password that gives MotionForge Pro permission to upload assets to your Roblox account.

Think of it this way:

  • Cookie = lets you download assets (proves you own them)
  • API key = lets you upload assets to your inventory (proves you have permission)

You create the API key yourself in your Roblox Creator Dashboard, and you control exactly what permissions it has. MotionForge Pro only needs "Asset: Read" and "Asset: Write" permissions.

๐Ÿ’ก Why not just use the cookie for everything?

Roblox deprecated the old cookie-based upload methods. The Open Cloud API is the modern, officially supported way to upload assets. It's more reliable, has better error messages, and won't break randomly.

1

Get Your Roblox Cookie

MotionForge Pro needs your cookie to download assets from Roblox. Here's how to get it.

1.1 Open Roblox Studio

  1. Launch Roblox Studio
  2. Make sure you're logged in to the account that owns the assets you want to transfer
  3. Open any place or create a new one (the plugin needs Studio to be running)

1.2 Open Developer Tools

  1. In Studio, go to View โ†’ Developer Tools (or press F12 / Cmd+Option+I on Mac)
  2. A panel will open at the bottom or side of Studio

1.3 Find Your Cookie

  1. Click the Application tab in the Developer Tools
  2. In the left sidebar, expand Cookies
  3. Click on https://www.roblox.com
  4. Look for .ROBLOSECURITY in the list
  5. Click on it, then copy the Value field (it's a long string)

๐Ÿ“ Can't find the Application tab?

Try the Storage or Cookies tab instead โ€” different versions of Studio organize this differently. You're looking for any section that shows cookies for roblox.com.

โš ๏ธ Keep it secret

Your cookie is like a temporary password. Anyone with it can access your account. Only paste it into MotionForge Pro โ€” never into websites, Discord, or anywhere else.

1.4 Add It to MotionForge Pro

  1. Open MotionForge Pro
  2. Go to the Accounts tab
  3. Click Add Account
  4. Select the Manual tab
  5. Paste your cookie into the .ROBLOSECURITY Cookie field
  6. Click Add Account

๐Ÿ’ก Auto-Detect (easier method)

If you have the MotionForge Pro plugin installed in Studio, you can click Auto-Detect instead. The app will automatically grab your cookie from Studio โ€” no manual copying needed. See Step 3 for plugin installation.

2

Get Your Open Cloud API Key

This is required for uploading assets. Without it, transfers won't work.

2.1 Go to Roblox Creator Dashboard

Visit: create.roblox.com/dashboard/credentials

Make sure you're logged into the same Roblox account you want to upload assets to.

2.2 Create an API Key

  1. Click "Create API Key" (or the + button)
  2. Name it: MotionForge Pro (or anything you'll recognize)
  3. Under "Access Permissions", select:
    • โœ… Asset: Read โ€” lets the app check what assets you have
    • โœ… Asset: Write โ€” lets the app upload new assets to your inventory
  4. Under "Security", you can leave it unrestricted or add your IP for extra security
  5. Click "Create Key"
  6. Copy the key immediately โ€” Roblox only shows it once!

โš ๏ธ Important

Save this key somewhere safe (like a password manager). If you lose it, you'll need to create a new one โ€” Roblox won't show it again.

๐Ÿ“ What if I don't see "Asset" permissions?

Make sure you're on the Creator Dashboard (create.roblox.com), not the main Roblox website. The Open Cloud API section is in the left sidebar under "Credentials."

2.3 Add the Key to MotionForge Pro

  1. Open MotionForge Pro
  2. Go to the Settings tab
  3. Find the "Default API Key" field under Open Cloud
  4. Paste your API key
  5. Click Save

๐Ÿ‘ฅ Transferring to a group?

You'll need a separate API key for each group. In the Settings tab, scroll to Groups and add the group ID with its own API key. The group owner must create the API key from their Creator Dashboard.

3

Install the Roblox Studio Plugin

The plugin lets MotionForge Pro scan your game and automatically replace asset IDs after transfer.

3.1 Install from MotionForge Pro

  1. In MotionForge Pro, go to the Settings tab
  2. Scroll to the Plugin section
  3. Click "Install Plugin"
  4. The plugin copies to Roblox Studio's Plugins folder automatically

๐Ÿ“ Where it goes

Mac: ~/Library/Application Support/RobloxStudio/Plugins/
Windows: %LOCALAPPDATA%\RobloxStudio\Plugins\

3.2 Enable in Studio

  1. Open or restart Roblox Studio
  2. Go to Plugins tab in the top toolbar
  3. Look for MotionForge Pro in the plugin panel
  4. Click it to open the plugin window

๐Ÿ’ก Not seeing it?

Try restarting Studio completely. If it still doesn't appear, check that the plugin file MotionForgePro-Plugin.rbxmx is in the Plugins folder. You can also try "Install to Custom Dir" in MotionForge Pro settings if Studio is installed in a non-standard location.

4

Scan Your Assets

4.1 Open Your Game in Studio

  1. Open the game/place containing assets you want to transfer
  2. Wait for it to fully load
  3. Make sure the MotionForge Pro plugin panel is visible in Studio

4.2 Scan from MotionForge Pro

  1. Switch to MotionForge Pro
  2. Click the "Scan from Studio" button
  3. The plugin scans your entire game tree
  4. Assets appear in the Asset Explorer

โฑ๏ธ Large games

May take 10-30 seconds. The plugin yields periodically to avoid freezing Studio. You can also click "Run" directly in the Studio plugin panel to trigger a scan.

5

Select and Transfer

5.1 Select Assets

  1. In the Asset Explorer, check boxes next to assets you want
  2. Or use "Select All" per asset type

5.2 Configure Transfer

  1. Make sure your account is selected in the dropdown
  2. Choose your upload target (your inventory or a group)
  3. Select which asset types to include (Animations, Audio, Images, Meshes)
  4. Toggle options:
    • Auto-Replace: Push new IDs back to Studio automatically (recommended)
    • Skip Owned: Skip assets you already own
    • Use Open Cloud: Upload via API key (recommended, required for most transfers)

5.3 Start Transfer

  1. Click "Start Transfer"
  2. Watch progress in the output log
  3. Pause or cancel anytime if needed

๐Ÿ“ฆ What happens during transfer?

Download: Assets are fetched from Roblox's CDN using your cookie
Upload: Each asset is uploaded via Open Cloud API using your API key
Replace: New asset IDs are pushed back to Studio (if Auto-Replace is on)

?

Troubleshooting

"No API key configured"

Go to Settings โ†’ Open Cloud โ†’ paste your key. See Step 2 above. Make sure the key has both Asset: Read and Asset: Write permissions.

"Cookie invalid" or "Unauthorized"

"Studio Offline" status

"API key unauthorized"

"No assets detected"

Plugin not appearing in Studio

"Free tier limit reached"

๐Ÿ”’

Security & Privacy FAQ

Does MotionForge Pro store my cookie on your servers?

No. MotionForge Pro is a desktop app that runs entirely on your computer. Your cookie is stored locally in an encrypted format. We don't have servers that store user data โ€” the app talks directly to Roblox from your machine.

Can someone steal my account if they get my cookie?

Yes โ€” which is why you should never share it. Treat your cookie like a password. Only paste it into trusted desktop apps running on your own computer. Never share it in Discord, email, or websites.

What happens if I lose my API key?

Nothing bad โ€” API keys can only upload assets, they can't log into your account or change your password. Just create a new one in the Creator Dashboard and update it in MotionForge Pro settings.

Does MotionForge Pro work with 2FA enabled?

Yes. Since you're getting the cookie from Studio where you're already logged in, two-factor authentication doesn't affect MotionForge Pro. The cookie already contains your authenticated session.

Is this against Roblox's Terms of Service?

No. MotionForge Pro uses Roblox's official Open Cloud API โ€” the same API Roblox provides for legitimate asset management. We don't use exploits, hacks, or undocumented endpoints.

Can I revoke access later?

Yes. You can delete your API key from the Roblox Creator Dashboard at any time. You can also log out of Roblox Studio to invalidate your cookie. In MotionForge Pro, you can remove accounts from the Accounts tab.

Ready to start?

Get MotionForge Pro โ€” $4.99/mo