This page documents the official installation procedure for all platforms. For an explanation of the automated install process, including the raw internals of the automated checkout, update, and build process, see Automated Install.

Notice that ENIGMA installations almost always also include LateralGM and the Plugin by default.

Rationale

Since trying to maintain topics on the forums was becoming too divided, and topic links were quickly becoming outdated or broken, the wiki shall instead serve as a central hub for all your ENIGMA download/installation needs.

Platforms

Windows

Detailed Steps

1. Download the MinGW install executable from here: http://sourceforge.net/projects/mingw/files/latest/download?source=files
2. Run the MinGW installer and make sure to leave the selected drive as C:\MinGW and to choose the 'C compiler, C++ compiler, ObjC compiler and MSYS Basic System' options when prompted which components to install.
3. After the MinGW installation is complete download the ENIGMA zip from: http://dl.dropbox.com/u/1052740/ENIGMA-Releases/ENIGMA-R4-r915-win.zip
4. Unzip the ENIGMA folder to a directory of your choosing, it should be fine in any location on C:/ (like Program Files), just don't place it in the MinGW directory.
5. Go into the ENIGMA folder and run the ENIGMA executable which you should see inside (it has the blue ENIGMA icon).
6. When first prompted click 'YES' to proceed and use the current MinGW install, then wait for the ENIGMA installation to finish.
7. After this LateralGM will then ask you to restart. So like before go back to the ENIGMA folder and click the ENIGMA executable again which will reopen LateralGM/ENIGMA.
8. Then wait a final time as the compiler builds, after this is finished the installation is complete and you are ready to use ENIGMA!!

Note that those are very detailed steps to install, it's actually a lot easier than you might be thinking after seeing them. Most of it is obvious and just waiting for the downloads to complete, it may take 20 minutes in total to install depending on your connection speed. If the installation does not work however then please report this on the ENIGMA forum help desk. Note if you can't get the installer zip working there is always the option to install using Automated Install if you know how.

Now that you have installed ENIGMA you are ready to use it. If you are unaware of how to run a game (which is very easy) then you can read the Compiling a Sample Game section below.

Linux

Download and install the package appropriate for your distribution.

• Debian-based: Package currently broken. Dependencies are as follows: libgl1-mesa-dev libglu1-mesa-dev libx11-dev libz-dev libopenal-dev libgtk2.0-dev gcc g++ make java-common
• Arch: <Eh? No package either?>

Since there are no packages, install from the Repository.

Mac

Currently no builds are available for the Mac. Instead, you should check out from the Repository.

Other

If your platform is not listed, it probably isn't supported, but you're welcome to try and install ENIGMA anyways either using any of the above methods, or by checking out from the Repository.

Compiling a Sample Game

After installation, it is a good idea to try compiling a sample game, as this will make sure the installation was done successfully. Note that the first time you compile a game it can take several minutes, however after this it will usually only take a few seconds, even when compiling another game. It's a good idea to start with a known working game instead of using one of your own; a few can be found here:

• Catch the Clown (topic)
• Simple Maze Game Mirrors: [1] (direct download)

Open the game in LateralGM (by using File > Open) then in the ENIGMA menu at the top click the Run button. At this point, one of several things can happen:

1. A dialog box may appear stating that ENIGMA is not ready. If this happens it is because LateralGM has not finished looking for updates which it does whenever you start LateralGM (for notes on how to disable automatic updated check here). In this case wait a little while and try again.
2. A dialog may state that ENIGMA cannot run due to prior errors - which you should have seen earlier, in which case you should attempt to resolve the prior error before you proceed.
3. You should see a window with a text log appear, named ENIGMA Progress Console. This is the good window to see as it means ENIGMA is attempting to compile your game. From this the compile will either be successful, in which case you will be greeted with a playable game, or it will fail and will show an error in its backlog. Starting from the bottom of the log and working your way up, you can probably find the problem (usually highlighted in red). Alternatively, if you don't understand it, copy and paste the full log into a pastebin website and ask for help on either the forums or the IRC.