Maps

Export a map to Roblox Studio

The BloxMaps Cloud plugin puts your map in Studio. You install it once, sign it in with a code, turn on one Studio beta, and then every map builds with one click.

1. Install the plugin#

1. Download the plugin (you can also find it on your account page).
2. Drag the file into your Roblox Plugins folder:
   • Windows: %LOCALAPPDATA%\Roblox\Plugins (paste it into the File Explorer address bar)
   • Mac: ~/Documents/Roblox/Plugins (Finder: Go > Go to Folder)
   • Or in Studio: the Plugins tab > Plugins Folder opens it for you.
3. Restart Studio.

2. Turn on the CreateAssetAsync beta (one time)#

1. In Studio open File > Beta Features.
2. Tick CreateAssetAsync Luau API.
3. Press Save and restart Studio.

Roblox needs it to upload the map's models to your account. Without it the plugin says Roblox's upload feature is switched off in this Studio and shows these same steps.

3. Sign in with a code#

1. Open Plugins > BloxMaps Cloud > Cloud Maps. The panel opens on the right.
2. Press Sign in. The plugin shows an 8-character code (like KQ4M-7ZTP) and the page to type it on.
3. Open the link page in your browser, sign in to BloxMaps if it asks, type the code and press Check this code.
4. The site shows where the request came from. Tick the box that says you pressed Sign in yourself, then press Link this Studio.
5. Go back to Studio. The plugin signs in by itself in a few seconds.

Codes expire after 10 minutes. If yours did, press Sign in again for a new one. The first time the plugin connects, Studio asks if it may make HTTP requests to the BloxMaps website: allow it.

4. Build your map#

The panel has tabs: Create, My maps, Build and UIs.

1. Pick a map. Under My maps, press Open next to one you made on the website (press Refresh if it's new). Or make one right here under Create with the same options as the website, then press Build this map.
2. On the Build tab, press One-click build. If the map isn't exported yet, the button says Export + one-click build: it exports first, which uses 1 export (the panel shows how many you have left).
3. Wait. The plugin downloads the models, uploads them to your Roblox account and builds the map. The status line tells you what it's doing.

Building a map you already exported is free, as often as you like. Each model uploads only once: later maps that use the same models reuse your earlier uploads, so they build faster. If the place belongs to a group, the uploads go to that group.

The Build tab also has:

• Pink boxes where a model is not imported yet: a see-through pink box stands in for any model that could not be uploaded, so you can see what's missing.
• Make obby pieces playable (adds a small script): adds the script that makes kill bricks, checkpoints and moving pieces work when you press Play.
• Clear map: removes the built map.

What you'll see in the Explorer#

Workspace
  BloxMap                 the map (a Folder)
    <one folder per area>  buildings, props, paths...
    Markers                spawns, checkpoints, bounds and other markers
    BloxMapGameplay        the obby script (only when the map has playable pieces)
  Terrain                 the ground, water and BloxMapClouds
Lighting                  the map's lighting, plus BloxMapAtmosphere, BloxMapSky...
ServerStorage
  BloxMapAssets           the uploaded models, one folder per type
Teams                     one Team per map team (only if the place had no Teams)

• Workspace.BloxMap holds everything the map placed. Building another map clears the old BloxMap first, so keep your own things outside that folder.
• ServerStorage.BloxMapAssets is your model library. Leave it there: the plugin looks here first and only uploads what's missing.
• Lighting gets the map's time of day and look. See Map lighting.
• Markers are invisible parts your scripts can find. See Markers and spawn points.
• Maps from a world build into Workspace.BloxWorld instead, one folder per section. See Worlds.

The whole build is one undo step: press Ctrl+Z once to go back.

If something goes wrong#

Open Output (View tab) to see the plugin's messages. They start with [BloxMaps].

• "Roblox's upload feature is switched off in this Studio": turn on the beta (step 2), restart Studio, open the place and press One-click build again. It carries on where it stopped.
• Uploads refused, or pink boxes everywhere: make sure you're signed in to Studio with the account that owns the place, and the place is saved to Roblox (File > Save to Roblox). Check the plugin came from the file in your Plugins folder. Then press One-click build again.
• A few models failed: their names are in Output. Press One-click build again to retry them.
• "Your Studio link was revoked or expired": press Sign in again.