Loading Leap…

Creating a Project

Create your first Leap project, name it, and see what Leap sets up for you automatically.

Creating a Project

Projects are the top-level containers in Leap. Every game you develop gets its own project, which holds all of its elements, groups, systems, workspaces, versions and environments. Let's walk through creating one.

Your First Sign-In

The first time you sign in, a short setup wizard walks you through four steps: Terms & Conditions, Your profile, Organisation and First project. If a teammate invited you, the third step is Join organisation instead, and the last step also lets you open a project your team is already working on. The wizard's last step creates your first project with the same form described below.

Step-by-Step Breakdown

Step 1: Open Your Projects

After you sign in, Leap opens the Welcome back screen. Your projects lists every project in your organisation. The project you're working in is marked Open now, and the one you opened most recently is marked Last opened. Click the star on a project to add it to your favourites — favourites are remembered in this browser.

Step 2: Click "New project"

Click New project at the bottom of the card. You can also create a project at any time from the project menu in the header, which has a New project entry of its own.

Step 3: Choose How to Start

Pick Start from scratch. The templates under Start from a template are marked Coming soon and can't be selected yet.

Step 4: Name Your Project

Enter a Project name (e.g. "Starbound Idle"). The name must contain at least one letter, and it must be different from the names of the other projects in your organisation. Leap derives the project's ID from the name, so two names that differ only in capitalisation or punctuation count as the same. If the name can't be used, you'll see one of these messages:

  • "Use at least one letter in the project name."
  • "A project with this name already exists in your organisation."

Optionally, click Project icon to pick a square PNG or SVG. The icon is stored in this browser only.

Step 5: Create the Project

Click Create project. Leap shows "Setting up your project…" while it creates the project, then opens it on the Design tab.

What Leap Sets Up for You

Every new project starts with two things already in place:

  • A Dev environment — a deployment target named Dev (slug dev). You'll deploy versions of your design to it later; see Versions and Deployments.
  • The GameSetup system — a system that runs once for every new player. It starts in the state NewPlayerSetup and moves straight on through its exit Setup complete to SetupDone. Add operations to NewPlayerSetup to set up each new player. GameSetup can't be deleted.

The first time a new project opens, you may briefly see "Setting up your project…" again while GameSetup is created.

Your Project ID

Leap derives a permanent Project ID from the name you entered. Renaming the project later doesn't change it. To see it, open the project menu in the header, click the cog to open Project settings, and choose Identity — the Project ID is listed there next to your organisation's ID.

Tip: Right after creating a project you're on Main, which is read-only. Create a workspace before you start building — see Working with Workspaces.

Next Steps

Now that your project is set up, continue to Navigating Leap Studio to learn your way around.