Getting started

Where do I download MeshCraft?

MeshCraft doesn't yet publish ready-made downloads. See Installing & Running — either a developer on your team builds it for you, or you follow the Developer build guide yourself.

Does MeshCraft run on Mac or Windows?

Not yet — Linux and browser (WASM) builds are currently working; macOS, Windows, and Android are planned. Check the Installing page for the current status.

Do I need to know how to code?

No. Everything in the Users section only requires point-and-click use of the editor. The .mc3.xml file format underneath is plain text, but you never need to open or edit it by hand.

Working in the editor

I lost my work — can I get it back?

Check for an autosave. If MeshCraft closed unexpectedly, reopening the same scene will offer to load a newer autosave if one exists — look for a message like "Autosave found — may be newer than saved file" along the bottom of the window. Otherwise, look next to your .mc3.xml file for rotating backup copies.

How do I undo a mistake?

Ctrl+Z, up to 20 steps back. It covers every kind of edit — adding, deleting, moving, grouping, and more. Ctrl+Y redoes.

I selected the wrong thing / can't find my object

Use the Command Palette (Ctrl+P) to search for an object by name, or use the search box at the top of the Scene panel. Press F to snap the camera to whatever is currently selected.

My CSG result looks wrong or won't export

Make sure exactly the shape(s) meant to cut are marked with the "cutter" role inside a Difference group — see Combining Shapes (CSG). Some shape types aren't yet supported as CSG children on export; MeshCraft will tell you which one if that happens.

Walk Mode lets me walk through walls

This is a known current limitation — Walk Mode only collides with the ground plane (y=0) so far, not with scene geometry. It's still useful for checking scale and layout; just don't rely on it to test whether a space is physically enclosed.

Exporting

What's the difference between glTF and GLB?

They're the same format — .gltf is readable JSON with separate texture files alongside it, while .glb packs everything (geometry, materials, textures) into one binary file. GLB is usually the simpler choice to share or hand off.

Will my animation still work after exporting?

Yes — keyframe animations (position, rotation, scale, visibility, and color) are included in the glTF/GLB export and play back in any tool that supports glTF animation.

Still stuck?

MeshCraft is early, actively-developed software, so rough edges are expected. Check the project's GitHub repository for the latest status, or ask a developer on your team — they'll find the Developer docs useful for digging deeper.