Working with Workspaces
Create a workspace, make changes, and merge them back to main
Working with Workspaces
Workspaces are isolated editing environments within a project. Think of them like branches in version control — they let you make changes to your game economy without affecting the base project data. When you're happy with your changes, you merge the workspace back into Main.
Before you can create or edit any game elements, you need to have an active workspace.
Creating a Workspace
Step 1: Load Your Project
Make sure you have a project loaded. If you haven't created one yet, see Creating a Project first.
Step 2: Open the Workspace Switcher
In the top header bar, next to your project name, you'll see a branch icon labeled Main. Click on it to open the workspace switcher dropdown.
Step 3: Click "Create Workspace"
At the bottom of the dropdown list, click the Create Workspace button. A dialog will appear.
Step 4: Name Your Workspace
Enter a descriptive name for your workspace (e.g., "Balance Update Sprint 1"). This is the only required field. Click Create Workspace to confirm.
Step 5: Start Editing
Your new workspace is now active. You'll see a banner at the top of the page confirming you're editing in your workspace. All edit buttons across the platform are now enabled and you can start creating and modifying game elements.
Important: When you're on Main (no workspace selected), all edit buttons are disabled to protect your base project data. Always switch to a workspace before making changes.
Making Changes
With your workspace active, you can freely create and edit game elements — currencies, items, progressions, and more. All changes are contained within your workspace and won't affect Main until you merge.
You can switch between your workspace and Main at any time using the workspace switcher in the header. This lets you compare your changes against the current live state.
Merging Back to Main
Once you're satisfied with your changes, it's time to merge them into Main. The merge process has three steps:
Step 1: Start the Merge
Open the workspace switcher in the header and click Merge to Main. You can also start a merge from the LiveOps > Workspaces page by clicking Merge next to your workspace.
Step 2: Review Changes
The Leap shows you a detailed preview of everything that will change when you merge:
- Changes — Existing elements you modified
- New — Elements you created in the workspace
- Deleted — Elements you removed
- Auto Merged — Changes that were automatically resolved when both Main and your workspace modified the same element in different ways
- Conflicts — Cases where the same field was modified in both Main and your workspace (you'll need to pick which version to keep)
Take a moment to review each section and make sure everything looks right.
Step 3: Confirm and Merge
Add a merge message describing your changes (e.g., "Rebalanced gold rewards for early levels") and click Merge to Main. Your changes are now live in the base project.
Tip: You can manage all your workspaces from the dedicated Workspaces page at LiveOps > Workspaces in the sidebar. This page shows active workspaces, merge history with detailed summaries, and lets you close workspaces you no longer need.
Next Steps
With your workspace active, you can start creating game elements — head over to Creating Currencies to add your first currency.