Users / Installing & Running
⚠️
MeshCraft is early, actively-developed software

There isn't a one-click installer yet — MeshCraft is currently distributed as something you (or a developer on your team) build from source. Here's what that means for you today, and how it will get simpler over time.

Getting the program onto your computer

There are two common situations:

Someone already built it for you

If a developer on your team has already built MeshCraft, they will hand you a single program file (on Linux, simply named MeshCraft). Once you have that file, using it does not require any programming, compiling, or command-line knowledge — everything from here on is point-and-click.

Nobody has built it yet

MeshCraft doesn't yet publish ready-to-download builds for each platform. If you don't have a developer to build it for you, the Developer Getting Started guide has the exact steps someone with a C++ toolchain can follow — it usually takes a few minutes once the required tools are installed.

💡

There's also a browser (WASM) build in progress, which would let you try MeshCraft without installing anything at all. Check the project's GitHub page for the latest status.

Opening the editor

  1. Start with an empty sceneRun the MeshCraft program with no arguments and it opens a new, empty scene ready for you to build in.
  2. Open an existing sceneUse File → Open from the menu bar, or pass a .mc3.xml file to the program when you launch it (a developer can set this up as a "double-click to open" association on your system).
  3. Start creatingOnce the window appears, you're looking at the same interface described in the Interface Tour.

Where your work is saved

A MeshCraft scene is a single file ending in .mc3.xml. It's plain text, so it's safe to back it up, email it, or put it under version control just like any document.

ℹ️
Autosave has your back

MeshCraft periodically autosaves your open scene to a backup file. If the editor closes unexpectedly and reopens a scene with a newer autosave available, it will ask before loading it — so a crash doesn't have to mean lost work. Still, get in the habit of pressing Ctrl+S often.

Supported platforms today

PlatformStatus
LinuxWorking
Browser (WASM)Working
macOSPlanned
WindowsPlanned
AndroidPlanned