Collaboration

Creating a high-quality experience demands many skills such as modeling, scripting, user interface design, and audio production. It's unlikely that one person has all of these skills, which makes collaboration between different roles an essential part of the development workflow.

With Studio's built-in collaboration tools, creators can contribute to experiences independently on their own time, or work together with their team all at the same time.

Three creators working together in a collaborative session, each with differnt color markers to demonstrate what objects they're currently editing in the environment.

Managing Collaborators

To collaborate with others, you first need to add collaborators to your experience. You can then edit their permission settings which correspond to their level of access to the experience.

Adding Collaborators

When you're ready to collaborate on an experience, click the Collaborate button in the upper-right corner of Studio:

Studio's menu bar with the Collaborate button highlighted.

Type into the search bar at the top to search for a collaborator to add. A dropdown will appear listing any collaborators that match your entry. Select the collaborator to add them and click Save for your collaboration settings to take effect.

A close up view of the search bar searching for a user named cherpl. A picture of the user displays in the dropdown.

In user-owned experiences, the search bar shows both users and groups to add as a collaborator. If a user is your friend, you see a friend icon to the right of their username. In group-owned experiences, you can only add users, not groups, as collaborators.

Editing Permissions

Collaborators you add to an experience have permission settings that correspond to their level of access to the experience. Here's a complete list of the different permission settings a user can have and a description of the permissions they have:

PermissionDescription
OwnerUser is the owner of the experience and has permission to configure other users' permissions.
EditUser has permission to edit the experience. This also grants the user Play permission.
PlayUser has permission to play the experience privately.
No AccessUser does not have either Edit or Play permissions.

There are some small differences when managing collaborators in user-owned experiences vs. group-owned experiences.

User-Owned Experiences

For user-owned experiences you can grant Play access to any user or group, but you can only grant Edit access to users that are friends with you. To give Edit permissions to individual collaborators for an experience that you own:

  1. With the experience open in Studio, click the Collaborate button in the upper right corner of Studio.

    Studio's menu bar with the Collaborate button highlighted.
  2. Select Edit from the permissions dropdown for the individual.

    A close up view of a collaborator's tile with the permission dropdown menu highlighted.

Group-Owned Experiences

For group-owned experiences, only the owner of the group can manage which roles have Edit permissions. You can add individual collaborators to group-owned experiences, however they can only have Play access, not Edit access. There are two ways a group role can have Edit access: changing the permissions for all group experiences, and changing the role for a specific group experience.

All Group Experiences

To manage which roles in a group have editing permissions for all group experiences:

  1. Navigate to the Groups page and select the group.

  2. Click the button in the upper-right corner and select Configure Group.

    A close up view of an experience tile with both the ellipis button and Configure Group menu item highlighted.
  3. In the left column, select the Roles tab.

  4. For each group role that you want to give editing permissions to, enable Create and edit group experiences.

    A close up view of an group role settings. The Create and edit group experiences setting are highlighted.

In the Manage Collaborators dialog, these roles display Edit access but are grayed out to indicate that you can't change the access level from Studio.

A close up view of the Manage Collaborators dialog. The Admin role Edit access dropdown menu is highlighted.
Specific Group Experiences

Group owners can grant Edit access to specific experiences to roles without the Create and edit group experiences permission enabled. With a group-owned experience open, click on the Collaborate button. Then select the role, which is No Access by default, and set the access level to Edit. All users within this role should now have Edit access for this experience only; this won't grant them access to other group experiences.

A close up view of the Manage Collaborators dialog with the Member role Edit access dropdown menu expanded. The Edit menu item is highlighted.

Users outside of a group can't have Edit access to the group's experiences, but you can grant them Play access.

A close up view of the Manage Collaborators dialog with two collborators highlighted without Edit access.

Accessing a Session

Those who have permission to edit an experience can join a Team Create session as follows:

  1. Close all currently open places in Studio, or restart Studio.

  2. Select the Shared With Me tab for user-owned experiences, or the Group Games tab if it's a group-owned experience.

    A close up view of Studio's landing page with the Shared With Me tab highlighted.
  3. Click the desired tile to begin editing.

Collaborative Building

All collaborators can manipulate objects, and the changes automatically appear for other collaborators.

User Color

Each collaborator in a session has a color behind their avatar in the Team Create window.

The Team Create window open with two collaborators in the session. Each collaborator has a different color behind their avatar.

When a collaborator selects an object, a selection box in their color appears around the object in the 3D view. The Explorer window also indicates when a collaborator selects an object.

A viewport view of a block part pyramid. The parts near the top of the pyramid are highlighted in green to signify that the collaborator with the green color has the parts selected in their Studio instance.
A close up view of the three block part objects in the Explorer window. There is a green circle near the objects to signify that the collaborator with the green color has the parts selected in their Studio instance.

Undo and Redo

If multiple creators have made edits to a part or instance, pressing Undo for that object reverts it to the state before you made a change and revert all changes that other editors might have made following your latest edit.

Scripting Using Drafts Mode

If Team Create is on, Roblox stores scripts in a central cloud-based repository that all collaborators can access. This allows creators to:

  • Work on the same script that others are editing using Drafts.
  • Test changes locally before committing them to the cloud.
  • Compare and commit script changes to the cloud when ready.

Drafting Scripts

You can edit scripts while collaborators edit them and playtest scripts locally without affecting the experience for others. After you finish drafting a script, you can commit it to the cloud and Team Test the cloud version with collaborators.

When editing a script, it appears in the Drafts window, accessible from the View tab. Drafts are saved to your local file system and persist between Studio sessions on the same machine.

Studio's View tab with the Drafts button highlighted. The Drafts window with two draft script instances.

Comparing Local and Cloud Scripts

To compare a local draft of a script with the version saved to the cloud:

  1. Right-click the local draft.

  2. Select Compare with server to open the Diff Result window.

    The Drafts window displays a pop-up window when you right-click a local draft. The Compare with server menu item is highlighted.
  3. Compare the line numbers to help determine which to keep. Code that collaborators changed or deleted appears in red. Code that you updated appears in green.

    A close up view of a couple of lines that were edited by different collaborators.

Committing Scripts to the Cloud

To commit your local edits to the cloud:

  1. Left-click a script, or hold Shift and left-click to select multiple scripts.

  2. Click Commit to commit all selected scripts to the cloud.

    The Drafts window with the Commit button highlighted.

Merging Changes

If a collaborator commits to the same script that you're editing, an icon with a green ⊕ symbol appears in the Drafts window.

The Drafts window with the green plus icon highlighted to the left of a draft script.

To merge their changes into your script:

  1. Identify which scripts you need to merge.

  2. Left-click a script, or hold Shift and left-click to select multiple scripts.

  3. Right-click any selected script.

  4. Click Merge from server to open the Merge Tools window. This window shows you how the latest edits relate to your own. If there are conflicting changes, you can pick which code to keep, or make manual edits.

    • Select Draft to keep your changes or leave it unchecked to discard them.
    • Select Server to merge the changes into your draft or leave it unchecked to ignore them.
    • Select Other to manually edit the script and save the changes to your draft.
  5. Once you check the desired options, toggle the Preview Resolution switch to preview how the script will look.

    The Merge Tools window with the Preview Resolution toggle highlighted.

Restoring Deleted Scripts

If a collaborator deletes a script that you're editing, an icon with a red ⊘ symbol appears in the Drafts window:

The Drafts window with the red plus icon highlighted to the left of a draft script.

To restore deleted scripts:

  1. Left-click a script, or hold Shift and left-click to select multiple scripts.
  2. Right-click any selected script.
  3. Click Restore Script. Scripts restore to the place's Workspace and you may need to manually re-parent them back to their original location.

Chatting with Collaborators

To chat with collaborators:

  1. In the View tab, click Chat.

    Studio's View tab with the Chat button highlighted.
  2. Click on the text box and type your message.

  3. Press Enter to send the message.

Saving and Publishing

If Team Create is on, Studio automatically saves the project to the cloud every five minutes. The Output window shows the place name and save location after the save is successful. Additionally, the status bar at the bottom of the Studio window shows when a save is in progress and when it's done.

The Output window with the Status Bar highlighted.

Reverting to Previous Versions

The owners of an experience can revert changes made by other editors. See here for instructions.

Team Create

Team Create is the Studio feature that enables collaboration for your place. Teams of all sizes, including solo creators, can benefit from features such as script version control and place autosaving by enabling collaboration. Workflows that involve the Manage Collaborators dialog will automatically enable Team Create for you when necessary so the collaborative experience is seamless. However, you can still manually enable or disable Team Create if necessary.

Enabling Team Create

Owners of an experience can enable Team Create. There are two ways to enable Team Create manually:

  • Toggle Team Create on when you save or publish to Roblox for the first time.

    The pop-up window that displays when you are saving or publishing your experience for the first time. The Team Create toggle is highlighted.
  • Open the Team Create widget in the View tab and click the Turn On button.

    A view of Studio with the View tab, Team Create button, and the Turn On button in the Team Create window highlighted.

Disabling Team Create

Owners of an experience can disable Team Create. When disabled, Studio forces all other collaborators to exit the session.

To disable Team Create:

  1. At the bottom of the Team Create window, click the button.

    The Team Create window with the ellipsis button in the bottom right corner highlighted.
  2. Select Disable Team Create.

  3. When prompted, click Yes to end the session.