Skip to content

Projects and saving

A project can contain an MJCF entry file, included XML files, meshes, textures, and other assets. Keep those files together with their relative paths when moving a project.

Apply compiles the current source and loads it into the viewer. A successful Apply starts a fresh simulation. If compilation fails, the last valid model stays in the viewer; fix the reported issue and apply again.

Save to folder and Download ZIP preserve the current source, including changes that have not been applied. Apply first if you want to check that the source compiles before saving. An export or folder save is not a simulation checkpoint.

  1. Click Download ZIP to download the current source and assets.
  2. To continue later, click Import ZIP and select the archive.
  3. If the project has multiple XML files, check Entry model and select the intended root model. Click Apply after changing source or the entry selection.

ZIP is the portable fallback when writable folder access is unavailable. Keep a copy before closing the page; browser draft recovery is not available.

  1. Make a copy of your project folder, then click Open folder and select that copy. Grant access if your browser asks.
  2. Check Entry model when the project has multiple XML files. Select the root model, then edit and Apply as needed.
  3. Click Save to folder to write the current source. Grant write access if requested. For a sample or imported ZIP, choose an empty target folder.
  4. To continue in another session, reopen the same folder and check the entry model.

Folder access depends on the browser and its permissions. Current Mac native-folder coverage has not yet been verified; use ZIP if the folder workflow is unavailable. If a file changed on disk after opening, reopen the project or export a ZIP copy. A multi-file save may complete only partially if an error occurs; check the status message and the files before continuing.