Skip to main content

Download & Installation

MD Engine is distributed on the Steam store. All you need to do is download it from Steam like any other software or game.

MD Engine on Steam

After downloading it from Steam you should be able to run it normally.

Platform Notes​

Windows​

No additional setup is required. MD Engine runs on Windows 8 and later (64-bit).

Linux​

On Linux, MD Engine is also available as an AppImage. Simply download the .AppImage file, make it executable (chmod +x), and run it.

Depending on your permissions and the path you are running the AppImage from, the system may not be able to mount or extract it. If you get errors like AppImages require FUSE to run or permission-related failures, you can extract the AppImage and run it directly:

./MD_Engine.AppImage --appimage-extract
./squashfs-root/AppRun

This extracts the contents into a squashfs-root folder, bypassing the need for FUSE or special mount permissions. This is also useful on systems where FUSE is not installed or when running from paths like network drives or noexec-mounted partitions.

If you are using a Wayland-based desktop and experience display issues, try launching with the --ozone-platform-hint=auto flag or setting the GDK_BACKEND=x11 environment variable.

macOS​

Download the macOS build and open the .app bundle. On first launch, you may need to right-click and select "Open" to bypass Gatekeeper.

Troubleshooting​

The editor launches but the screen is blank or white​

This is usually a GPU driver issue. Try updating your graphics drivers. On Linux, make sure you have hardware acceleration enabled.

Build fails with "compiler not found"​

The build tools are bundled with MD Engine and should work automatically. If you see this error, try reinstalling MD Engine from Steam (right-click > Properties > Installed Files > Verify integrity of game files).

The Play Window doesn't open or shows a black screen​

Make sure no antivirus or firewall is blocking the emulator process. The Play Window runs a local emulator that some security software may flag.

General tips​

  • Check the System Requirements page to make sure your machine meets the minimum specs.
  • If you experience performance issues with large projects, hiding unused scenes in the world view can help.
  • The Build Log contains detailed information when something goes wrong during compilation.