Project layout

What each folder in a Mowo project holds, which ones you commit and which ones the engine regenerates.

Last updated Nov 1, 2026Edit this pageVersion 1.0.0

A Mowo project has the same shape as an Unreal project. One rule decides where everything goes: nobody opens Intermediate/, only its own user opens Saved/, and the whole team opens everything else, so you commit everything else. FProjectLayout FProjectLayout owns these names, so the engine, the editor and mbt agree on them.

The folders

Text
MyGame/
  MyGame.mproject      JSON manifest
  Content/             every game asset (mounted as "Content")
  Config/              the project's INI settings
  Source/              the C++ game module and the game target
  Plugins/             project plugins
  Saved/               per-user output: logs, crashes, autosaves, packages
  Intermediate/        disposable caches
  .gitignore
  .gitattributes
FolderHoldsCommit?
Content/Levels (.mmap), materials, textures, meshes, sounds and every other asset, with their .mdfmeta sidecarsYes
Config/Engine.ini, Input.ini, Plugins.ini, Packaging.ini, Redirects.ini and the other project settingsYes
Source/The game module (<Module>.Build.cs, Public/, Private/) and <Project>.Target.csYes
Plugins/Project pluginsYes
Saved/Logs, crashes, autosaves, save games, screenshots, your editor layout, cooked output and packagesNo
Intermediate/The asset registry index, derived data cache, thumbnails, compiled material shaders, cooked per-asset transcodesNo

mbt init writes a .gitignore that leaves out Saved/, Intermediate/, build output, IDE folders and *.meaf archives, and a .gitattributes that routes each asset type: text assets as LF text, binary bulk through Git LFS.

Warning

Commit each asset's .mdfmeta sidecar with it. The sidecar sits beside the file (rock.png gets rock.png.mdfmeta) and carries the asset's UUID, which every reference to the asset uses. Losing it gives the asset a new identity.

Asset references are stored as project-relative paths such as Content/Textures/rock.png. Never put an absolute path into an asset.

Here is the Config/Plugins.ini a template ships. It enables plugins by name:

Config/Plugins.ini
[enabled]
Combat=True

Saved and Intermediate

PathContents
Saved/Logs/, Saved/Crashes/Log files and crash reports for this project
Saved/Autosaves/, Saved/SaveGames/, Saved/Screenshots/Editor autosaves, game saves, screenshots
Saved/Config/Editor/Your window layout, viewport state and other per-user editor state
Saved/Cooked/, Saved/Packaged/mbt cook and mbt package output
Saved/AutoScreenshot.pngThe thumbnail the Project Launcher shows for the project
Intermediate/AssetRegistry.mdfbThe asset registry index. Deleting it forces a rebuild on the next open
Intermediate/ShaderCache/, Intermediate/ShaderCompile/Material graph shaders the editor compiled in the background, and the sources and build files of that compile. See Materials

You can delete Intermediate/ at any time. The next editor session rebuilds it.

The manifest

MyGame.mproject is JSON. It holds the project's name, version, UUID, the engine version that last saved it, the start scene, the game mode class, the packaged product's name and icon, and the default window settings. You rarely edit it by hand: Edit › Project Settings… writes the same fields. Every field, and how the Config/ INI layers combine, is in Project files.

Opening an older project

Projects written by an older engine migrate on open. An Assets/ folder moves to Content/, a .mowo/ folder moves to Saved/Config/Editor/, MDF config files such as Engine.mdf are converted to INI, and older asset extensions are renamed Engine/Source/Runtime/Core/Public/Core/ProjectLayout.h Engine/Source/Runtime/Project/Public/Project/ProjectMigration.h Engine/Source/Runtime/AssetSystem/Public/AssetSystem/AssetPackageMigration.h.

Next steps

Engine sources

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

  • Engine/Source/Runtime/Core/Public/Core/ProjectLayout.h
  • Templates/TP_FirstPerson/TP_FirstPerson.mproject
  • Templates/TP_FirstPerson/Config/Plugins.ini
  • Engine/Source/Runtime/Project/Public/Project/ProjectMigration.h
  • Engine/Source/Runtime/AssetSystem/Public/AssetSystem/AssetPackageMigration.h

Page feedback

Was this page helpful?