To run The Machinery you need:
- A 64-bit Windows 10 machine with the latest Vulkan drivers
- Or a 64-bit Ubuntu 20.04 Linux machine with the latest Vulkan drivers (ArchLinux should also work, no guarantees are made for other distros)
- And an ourmachinery.com account. Sign up here!
On Linux, you also need to install the following packages for the runtime:
sudo apt-get install libxcb-ewmh2 libxcb-cursor0 libxcb-xrm0 unzip
This does not work on your distro? No problem, visit our Linux installation process across distributions guide.
Quick steps to get up and running:
Download The Machinery at https://ourmachinery.com/download.html.
Unzip the downloaded zip file to a location of your choosing.
bin/the-machinery.exein the downloaded folder to start The Machinery.
Login with your ourmachinery.com account at the login screen and approve the EULA.
To find some samples to play with go to Help > Download Sample Projects in the main menu.
Pick one of the sample projects (for example Physics), click Get and then Open.
Play around with it, try some other samples and read the rest of this document to find out what else you can do with The Machinery.
If you get errors that mention Vulkan or if you see weird rendering glitches, make sure to update your GPU drivers to the latest version. If that doesn't work, post an issue with our issue tracker or ping us on Discord and we will help you.
Related videos to these topics are:
You can make use of
tmbuild (from the binary build) to download the engine (source code) and install all needed dependencies as well. This can be done via
tmbuild --install in this case you may want to use
--github-token as well and provide your token. Alternatively you can also manually clone the repo as you are used to from any other git repositories
Make sure your GitHub account is correctly entered on the Profile page. It should be your account name, not your email.
GitHub invites frequently end up in the Spam folder. Check there or go to the repository to see your invite.
If you still have problems despite this, then contact us on [email protected]