Projects

Core Concepts · 4 min read

A project is a map you are building — from a real-world location or from your own files. It holds all the terrain data, vector features, imagery, and export history for that map.

What a project is

A project is the central object in MapToPlay. It represents a specific piece of real-world geography — a set of coordinates, a size in meters, and a rotation — that you are converting into a map mod. Everything related to that map lives inside the project: the terrain elevation, the roads and fields, the satellite imagery, your editor work, and your export history.

A project belongs to one workspace, which belongs to one team. Projects have a name, an optional description, and an optional cover icon you can set from the project settings.

The area selection

Every project has an area selection that defines the size and shape of the map. This includes the overall width and height in meters, the playable area dimensions (a smaller inner region the game uses for actual gameplay), and a rotation angle. Projects built from a real-world location also store the coordinates of the map center.

Project status

Projects have a status that reflects where they are in your workflow. You can update a project's status from the project settings.

What a project contains

Once created, a project accumulates content across several areas:

You can navigate between these areas using the tabs within the project view. The Editor is the live environment where all these pieces come together.

Tasks — background jobs that download terrain elevation, vector features, or satellite imagery for the project area.
Assets — the files produced by tasks or uploaded directly, including terrain height maps, vector datasets, and raster imagery.
Layers — the organized list of data layers the Editor uses to build your map.
Exports — finished outputs ready to be placed into the game.