Your first scene

Find your way around Mowo Editor, place and edit actors, save the level as a .mmap file and test it with Play.

Last updated Oct 26, 2026Edit this pageVersion 1.0.0

This page walks through the loop you repeat every day: open a level, place actors, adjust them, save, and press Play to test. It assumes you have created a project. Every shortcut below is the editor's default binding.

Open the project

If you created the project in the Project Launcher, the editor is already open. Otherwise start it with your manifest:

PowerShell
& .\Engine\Binaries\win-x64\dev\MowoEditor.exe --project D:\Projects\MyGame\MyGame.mproject

The editor opens the project's start scene. A template project opens Content/Scenes/Main.mmap. A project without a start scene, such as one from mbt init, opens an empty Untitled level. To begin a fresh level at any time, use File › New Scene.

The editor layout

RegionPanelWhat it does
CenterViewportThe level, rendered live. You fly through it and move actors with the gizmo
LeftModesPlaces actors, and switches to the other editing modes
Right, topOutlinerThe level's actors as a tree: select, rename, reparent, delete
Right, bottomDetailsThe selected actor's components and properties, built from reflection
BottomContent BrowserThe project's Content/ folder with thumbnails

Every panel is a tab you can move, split or float. More panels, such as the Output Log, Profiler and Render Debug, open from the Window menu. The Editor section covers each one.

Mowo Editor just after opening an mbt init project: an Untitled level in the viewport, the Modes panel on the left showing the Basic category cards, the Outliner and Details panels on the right, and the Content Browser at the bottom showing the Scenes, Materials, Textures, Models and Audio folders.
A new project opened in the editor.

Move around the viewport

Hold the right mouse button in the viewport to fly the camera, and use W A S D to move, Q and E to go down and up. Without the right mouse button, the same letters are editing shortcuts:

ShortcutAction
QSelect tool
W / E / RTranslate / rotate / scale gizmo
FFrame the selection
GGame view: hide editor-only icons
Alt+2 … Alt+6Wireframe, Unlit, Lit, Detail Lighting, Lighting Only
Ctrl+ZUndo
Ctrl+KCommand palette

Place actors

The Modes panel places actors. Its cards come from the placeable-actor registry, grouped into categories such as Basic, Lights, Gameplay, Volumes, Visual FX and World.

  1. Add a floor

    In Basic, drag Plane into the viewport. A dragged card lands where the cursor meets the level.

  2. Add something to look at

    Click Cube in Basic. The new actor is selected, so the gizmo appears on it. Press W and drag the arrows to lift it above the floor.

  3. Light it

    In Lights, click Directional Light.

  4. Add a player start

    In Gameplay, click Player Start. It has no mesh, so the viewport shows it as an icon.

Each placement is one undo step. The last six types you placed appear under Recently placed.

Mowo Editor with the Modes panel placing actors: the search field, the Basic category expanded with Empty Actor, Character, Pawn, Cube, Sphere, Cylinder, Plane and Cone cards, and the Recently placed view listing Cube, Plane and Directional Light. The viewport shows a cube above a plane with the translate gizmo on the cube.
Placing actors from the Modes panel.

Edit actors

Click an actor in the viewport or in the Outliner to select it. The Details panel shows its components and properties, built from the class's reflection data. Type a value or drag a numeric field to change it. Every edit is one undo step.

In the Outliner, drag one actor onto another to make it a child. A child's transform is then relative to its parent.

Save the level

Press Ctrl+S (File › Save). An untitled level has no file yet, so the editor opens a save dialog in the project's Content/ folder.

  1. Pick a name

    Open the Scenes folder and type a name such as Main. You can leave out the extension: the editor adds .mmap.

  2. Save inside Content

    Confirm the dialog. The level tab takes the file's name and the Content Browser shows the new asset.

CommandShortcut
File › SaveCtrl+S
File › Save Scene As…Ctrl+Shift+S
Save AllCtrl+Shift+Alt+S
Warning

Levels must live under Content/. A path outside the project's content tree is refused, and the level stays untitled. Cancelling the dialog also counts as a failed save.

To make this level the one your project starts with, open Edit › Project Settings…, go to Maps & Modes and pick it as Start Scene.

What a level file looks like

The Blank template ships its start level as text you can read and diff, a floor and a sun:

Content/Scenes/Main.mmap
Scene "Main" {
	version: 2
	description: "Blank world"

	Environment {
		ambient_color: vec3(0.3, 0.3, 0.32)
		ambient_intensity: 0.6
		ibl_enabled: false
	}

	Entity "Floor" {
		Transform {
			position: vec3(0.0, -0.5, 0.0)
			rotation: vec3(0.0, 0.0, 0.0)
			scale: vec3(40.0, 1.0, 40.0)
		}
		MeshRenderer {
			mesh_type: "cube"
		}
		Material {
			base_color: vec4(0.5, 0.52, 0.55, 1.0)
			metallic: 0.0
			roughness: 0.9
		}
	}
	Entity "Sun" {
		Transform {
			position: vec3(0.0, 20.0, 0.0)
			rotation: vec3(-0.9, -0.5, 0.0)
			scale: vec3(1.0, 1.0, 1.0)
		}
		Light {
			type: Directional
			color: vec3(1.0, 0.98, 0.92)
			intensity: 1.3
		}
	}
}

A level the editor saves can be written in the project's package format instead, and the file itself says which. Edit levels in the editor rather than by hand. See Content pipeline for the asset formats.

Play in the editor

Press F5 or the toolbar's Play button. The level starts running inside the viewport. Press Esc to stop.

  1. Editing
  2. Playing
  3. Paused
  4. Stop
Playing: Esc stops directly
Play runs a copy of the level. Stop throws the copy away and returns to Editing.
ControlShortcutWhen
PlayF5Editing
StopEscPlaying or Paused
Frame stepF10Paused
Eject / possessF8Playing; detaches to the editor camera while the game keeps running
Keep simulation changesKSimulating, or Playing after F8
SimulateAlt+SEditing

The arrow next to Play opens more modes: Play in New Window, Simulate, Play As Client with a Multiplayer Clients count, and Standalone Game.

Engine note

Play runs in a copy of the level. The level you edit is never ticked or written while you play, so Stop discards whatever gameplay changed. To keep a change you made while simulating, press K before you stop.

Mowo Editor during Play with the Third Person template: the toolbar's Pause and Stop buttons active and Play greyed out, the character visible in the viewport, and the Outliner showing the runtime-spawned player pawn.
Play in the editor with a template project.

Next steps

  • Your first build adds C++ and packages the project.
  • Core concepts explains what actors and levels are underneath.
  • Editor for every panel, the play modes and saving and recovery.

Engine sources

This page describes behavior implemented in these files of the engine repository, checked against commit 7f8f31f8d.

  • Templates/TP_Blank/Content/Scenes/Main.mmap

Page feedback

Was this page helpful?