Windows Installation

From ENIGMA
Jump to navigation Jump to search
The printable version is no longer supported and may have rendering errors. Please update your browser bookmarks and please use the default browser print function instead.
The official logo of Windows based operating systems and environments.

This primary method of installing is a self-extracting 7z executable which we created for high convenience and portability. It's an all-inclusive zip and provides you with everything you need to run ENIGMA.

Once the file is extracted just click ENIGMA.exe inside the folder and it will run ENIGMA/LGM. If you want to create a desktop shortcut right-click on ENIGMA.exe and goto Send To->Desktop. The first time you run ENIGMA.exe it will automatically download the ENIGMA repo for you before running LGM so wait for the installation to finish.

That should be it!

Note: You need to run the self-extracting zip and the enigma.exe with administrative privileges before and after setup so the application can access AppData to output temporary build files, simply right click the file and select "Run as Administrator" on Windows Vista or later.


Source Code (Advanced)

For those looking for something a little more hands-on, you can set up your own subsystem for compiling ENIGMA from source code.

MSYS2

These steps will help you configure an ENIGMA setup using the modern MSYS2 project. This setup better facilitates both 32-bit and 64-bit compilation.

  • First, you will want to download and install MSYS2 by following these instructions: http://www.msys2.org/
- NOTE: The x86_64 download button will support compilation of both 32-bit and 64-bit games.
  • When you reopen MSYS2 you will need to use the included Pacman to obtain the packages used by ENIGMA for building games, which includes things like OpenAL. You will also need to install Git using Pacman so you can clone the ENIGMA source code from GitHub to complete this installation.
- NOTE: You do not need to type the entire command below. Both Command Prompt and MSYS2 have a right-click menu option that allows you to just paste the command from this wiki page.
- The Pacman command you will need to run is:
pacman -S base-devel git mingw-w64-x86_64-toolchain mingw-w64-x86_64-boost mingw-w64-x86_64-openal mingw-w64-x86_64-dumb mingw-w64-x86_64-libvorbis mingw-w64-x86_64-libogg mingw-w64-x86_64-flac mingw-w64-x86_64-mpg123 mingw-w64-x86_64-libsndfile mingw-w64-x86_64-libgme mingw-w64-x86_64-sfml mingw-w64-x86_64-gtk2 mingw-w64-x86_64-zlib mingw-w64-x86_64-libffi mingw-w64-x86_64-box2d mingw-w64-x86_64-bullet
  • Now that MSYS2 is configured you will want to clone the ENIGMA repository. First use the change directory command (cd path/to/directory) to change MSYS2 to the directory you want ENIGMA installed in.
- Simply run this command: git clone https://github.com/enigma-dev/enigma-dev.git
  • Change directories into the enigma-dev folder now using cd enigma-dev
  • Now simply run make to build the compiler and its backend into compileEGMf.dll, which is used by the CLI and any IDE for ENIGMA.
  • Optional: You can then run make emake if you also intend to use the CLI for building games.
  • Finally, you will want LateralGM for editing games which you can use by installing Java and then download lateralgm.jar and enigma.jar from: Install:Extra Packages. You will also need jna.jar from: https://github.com/java-native-access/jna#jna
- NOTE: You will want to download jna.jar not jna-platform.jar which is basically the same thing, but bigger because it includes miscellaneous helper methods that LateralGM does not require or use. If any of the following directories don't exist, use mkdir directoryname to create them.
- lateralgm.jar goes in enigma-dev/lateralgm.jar
- enigma.jar goes in enigma-dev/plugins/enigma.jar
- jna.jar goes in enigma-dev/plugins/shared/jna.jar