> For the complete documentation index, see [llms.txt](https://studio-docs.sandbox.game/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://studio-docs.sandbox.game/getting-started/getting-started-with-sandbox-studio.md).

# Getting Started with Sandbox Studio

{% hint style="info" %}
*NOTE: This guide assumes Sandbox Studio is installed and first-launch onboarding is complete.*
{% endhint %}

{% stepper %}
{% step %}

## Review the Studio home screen

After sign-in, the Home screen provides three starting paths: reopen the recent project, select an existing project from disk, or create a new project. Existing projects also appear under My Projects.

<figure><img src="https://2877193296-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWgFjStdWWXj1Wc6xnrcJ%2Fuploads%2FQ5FJjKV6jkInrL6YWE2A%2Fimage.png?alt=media&amp;token=8727fcbf-e2ba-4653-8c4a-1714f54aaa34" alt=""><figcaption><p><em>The Home screen provides recent, existing, and new project options.</em></p></figcaption></figure>
{% endstep %}

{% step %}

## Start a new project

Select Create New. Choose a starting template that matches the type of game or experience you want to build.

The verified build includes Empty, 1st Person Movement, FPS, Free Camera Movement, Side Scroller, 3rd Person Movement, Vehicle. Select Empty when you want a bare project without preconfigured game logic.
{% endstep %}

{% step %}

## Configure the project

Enter the project name and choose the parent folder where Sandbox Studio will create it.

1. Select the Empty template, or another template required by your project.
2. Enter a Project Name using only letters, numbers, hyphens, and underscores.
3. Confirm the Project Parent Folder, or select Browse to choose another location.
4. Select Create Project.

<figure><img src="https://2877193296-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWgFjStdWWXj1Wc6xnrcJ%2Fuploads%2FKdmJhFS8TZMDx7CCiTSW%2Fimage.png?alt=media&amp;token=d09358de-ec11-46c5-8c1b-fe85d4003253" alt=""><figcaption><p><em>Choose a template, enter a valid project name, and confirm its parent folder.</em></p></figcaption></figure>
{% endstep %}

{% step %}

## Complete environment setup

Wait while Studio creates the project, checks the local development environment, and installs its dependencies. The current onboarding flow checks Node.js and pnpm and presents an action when a compatible setup is not detected.

{% hint style="info" %}
*ENVIRONMENT SETUP: Follow the action shown by Studio. If administrator access is needed, use the supplied manual instructions. After changing Node.js or pnpm, select Re-check. Keep the loading overlay open until dependency installation finishes.*
{% endhint %}
{% endstep %}

{% step %}

## Verify the editor

The project is ready when Sandbox Studio opens the Editor and shows the scene viewport. Confirm that the Place panel, Assets panel, Outliner, and Inspector load without an error.

<figure><img src="https://2877193296-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWgFjStdWWXj1Wc6xnrcJ%2Fuploads%2FmC7KrHxuTqdZ4drtSU5D%2Fimage.png?alt=media&amp;token=d40e28d4-d5f4-488d-99f9-4263fc3e0268" alt=""><figcaption><p><em>A successfully opened project displays the scene and the main editor panels.</em></p></figcaption></figure>
{% endstep %}

{% step %}

## Confirm the project files

Return to Home when needed and check that the new project appears under My Projects.
{% endstep %}

{% step %}

## Use the agent

Open the agent panel on the left side of the project.

<figure><img src="https://2877193296-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWgFjStdWWXj1Wc6xnrcJ%2Fuploads%2Fr725YW6txqLGMspUN62Z%2Fimage.png?alt=media&amp;token=67975333-8eaa-43a7-8626-0c3ef1806a3b" alt=""><figcaption></figcaption></figure>

You can speak directly to this agent to make things happen inside the Sandbox Editor. You will also find a list of agents at the bottom.

Providers and the default model are configured in App Settings → AI Settings (Assistant and Models tabs). See [Installing Sandbox Studio](/getting-started/installing-sandbox-studio.md#set-up-in-editor-ai-assistants-without-cursor). Cursor is a separate app; connect it with [Sandbox Studio MCP](/working-efficiently-with-ai/set-up-and-use-sandbox-studio-mcp.md).

Use the text box to chat with the editor and ask it to complete any task you need.
{% endstep %}
{% endstepper %}

## Troubleshooting

If Environment Setup reports a problem, follow the troubleshooting table on [Installing Sandbox Studio](/getting-started/installing-sandbox-studio.md#troubleshooting).

## What you’ve done

Your first project is created, the editor opens successfully, and you can use the agent to make changes in the scene. Continue with [Editor Orientation](/the-editor/editor-orientation.md) and [Set up and use Sandbox Studio MCP](/working-efficiently-with-ai/set-up-and-use-sandbox-studio-mcp.md) when you are ready for the next workflows.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://studio-docs.sandbox.game/getting-started/getting-started-with-sandbox-studio.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.