Game Suite (Beta)

Game Suite is currently in Beta. Features and workflows may change in future releases.

Game Suite is a Lens Studio plugin that provides a visual level editor for building 3D game worlds directly inside Lens Studio. It gives you an interactive viewport, an asset library, and a set of editing tools so you can place, arrange, and configure game objects—then export the completed world into your Lens scene.

---

Setup

Before using Game Suite, you need to add it to your project from the Asset Library:

1. Open the Asset Library in Lens Studio.
2. Search for Game Suite.
3. Click Add to Project to install the plugin.

Once added, Game Suite runs as a plugin panel inside Lens Studio. To open it, navigate to Plugins in the top menu and select Game Suite.

The editor workspace is divided into three areas:

• Side Panel—context-sensitive controls that change based on the active tool (for example, the asset library when Placement is active, or the players list when Players is active)
• Viewport—an interactive 3D canvas where you place and arrange game objects
• Toolbar—a floating bar at the bottom of the viewport containing the editing tools and action buttons

---

Toolbar Tools

The toolbar contains four selectable mode tools and two immediate action buttons.

Edit Tool

The Edit tool (cursor icon) is the default active tool when the editor opens. Use it to select and transform objects in the viewport.

Selecting and transforming objects:

• Click any placed object to select it. A 3D gizmo appears, letting you move, rotate, or scale the object.
• Objects snap to the grid when moved or rotated.
• Press Ctrl/Cmd+D to duplicate the selected object.
• Press Delete or Backspace to delete the selected object.
• Press R to rotate the selected object by 90 degrees.

Placement Tool

The Placement tool (paintbrush icon) gives you access to a large library of Bitmoji-themed assets organized into categories like Exterior, Interior, Nature, Road Props, Vehicles, Platforms, and more. Pick an asset from the library and place it into the viewport.

To place an asset:

1. Select the Placement tool from the toolbar. The asset library opens in the Side Panel.
2. Browse categories using the tabs at the top of the library.
3. Click a tile to select an asset. A preview ghost appears in the viewport.
4. Click or drag in the viewport to place copies of the asset onto the scene.

Placement behavior:

• Objects snap to the editor grid automatically.
• When you begin dragging after the initial touch, the Y-level of the first placed object is locked for the rest of the drag. This lets you paint a row of objects across a surface while keeping them at the same height.
• Press R to rotate the preview object by 90 degrees before placing.
• Hold Option to enter delete mode: clicking on a placed object removes it instead of placing a new one. Release Option to return to placement mode.

Eraser Tool

The Eraser tool (eraser icon) removes individual objects from the viewport. Click any placed object to delete it.

Players Tool

The Players tool (players icon) lets you place a player spawn point in your game world.

Working with the player:

• Click + Add New Player in the Side Panel to add a player. A spawn marker appears in the viewport.
• To rename the player, expand the Settings collapsible panel beneath the player entry and edit the name field.
• To remove the player, click the X button next to the player entry. The spawn marker is removed from the viewport.

Clear (Action)

The Clear button (trash icon) immediately clears all placed objects from the viewport after showing a confirmation dialog. This action cannot be undone.

Export (Action)

The Export button (export icon) is the primary way to export the current world into your Lens scene. You can also use the Cmd+J keyboard shortcut.

---

Exporting to Your Lens Scene

When you are ready to bring your game world into Lens Studio, click the Export button in the toolbar.

The export process:

1. Any existing GameWorld scene object is destroyed and replaced.
2. A new GameWorld root object is created at the top level of your scene hierarchy.
3. Each placed asset is instantiated as a prefab child of GameWorld, with its position, rotation, and scale applied. A mesh collider is automatically added to each instantiated object.
4. The player is instantiated under GameWorld at its designated spawn position.

When the export completes, a confirmation dialog appears:

Once exported, your game is ready to test in the Lens Studio Preview window. Use WASD to move and Spacebar to jump to control the Bitmoji character. You can also continue editing the exported objects directly in the Scene view. Re-exporting replaces the previous GameWorld entirely, so you can iterate in the Game Suite editor and re-export as many times as needed.

---

Workflow Summary

1. Search for Game Suite in the Asset Library and click Add to Project.
2. Open the plugin panel from Plugins > Game Suite.
3. Use the Placement tool to populate the viewport with assets from the library.
4. Use the Players tool to place the spawn point for the main player.
5. Use the Eraser tool or hold Option in Placement mode to remove unwanted objects.
6. Click the Export button to export the world to your Lens scene as the GameWorld hierarchy.
7. Continue building your game on top of the exported scene using other Lens Studio game components.

---

Keyboard Shortcuts

Shortcut	Action
Cmd+J	Export world to Lens Studio
R	Rotate preview 90° (Placement Tool) or rotate selected object 90° (Edit Tool)
Option (hold)	Delete mode: click to remove objects (Placement Tool)
Ctrl/Cmd+D	Duplicate selected object (Edit Tool)
Delete / Backspace	Delete selected object (Edit Tool)
WASD	Move camera forward / left / backward / right
Q / E	Move camera down / up
Arrow keys	Rotate camera

---

See Also

• Building Games on Snapchat
• Character Controller
• Bitmoji 3D