Skip to content
ctx.gg

Your First Map

This guide walks you through creating a simple map and playing it.

1. Open the Editor

Section titled “1. Open the Editor”

Go to editor.ctx.gg or run the editor locally. You’ll see a 3D viewport with a grid plane.

2. Add Geometry

Section titled “2. Add Geometry”

Use the toolbar to add basic shapes:

  • Box — Click the box tool and click in the viewport to place a box
  • Plane — Create flat surfaces for floors and walls
  • Sphere — Add spherical objects

Each shape can be moved, rotated, and scaled using the transform gizmo.

3. Set Properties

Section titled “3. Set Properties”

Select an object and use the properties panel to set:

  • Position — World-space coordinates (x, y, z)
  • Scale — Size multiplier on each axis
  • Material — Color and texture settings
  • Physics — Static or dynamic body, collision shape

4. Save Your Map

Section titled “4. Save Your Map”

Click Save to store the map. If you’re signed in, it saves to the ctx.gg API and becomes available in the desktop app. Otherwise it saves locally as a JSON file.

5. Play the Map

Section titled “5. Play the Map”

Open the ctx.gg desktop app, find your map in the library, and click Play. The app launches the Mortar engine with your map loaded.

If you built the engine from source, you can also run maps directly:

Terminal window
./mortar --map path/to/map.json

What’s Next?

Section titled “What’s Next?”