Skip to content

Instantly share code, notes, and snippets.

@christoffersch
Last active November 14, 2016 20:31
Show Gist options
  • Save christoffersch/e1c62ec9f9feccd56f89da16b3ae1b3c to your computer and use it in GitHub Desktop.
Save christoffersch/e1c62ec9f9feccd56f89da16b3ae1b3c to your computer and use it in GitHub Desktop.

Introduction
The Atomic Game Engine can also be installed on Linux. For JavaScript and TypeScript, the built-in Monaco editor can be used, and bundled with MonoDevelop, C# can be utilized as well.

If you want to skip installing MonoDevelop and build the engine without C# support, you can skip this first step.

1) Installing MonoDevelop

Before you can start building the engine itself, you will need to install MonoDevelop. Start by adding the Mono Project GPG signing key and the package repository to your system:

# sudo apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv-keys 3FA7E0328081BFF6A14DA29AA6A19B38D3D831EF

# echo "deb http://download.mono-project.com/repo/debian wheezy main" |    sudo tee /etc/apt/sources.list.d/mono-xamarin.list

# sudo apt-get update 

If you're using Ubuntu 13.10/Debian 8.0 or later, you will also need to add the mod_mono and libgdiplus repository to your system:

# echo "deb http://download.mono-project.com/repo/debian wheezy-apache24-compat main" | sudo tee -a /etc/apt/sources.list.d/mono-xamarin.list

# echo "deb http://download.mono-project.com/repo/debian wheezy-libjpeg62-compat main" | sudo tee -a /etc/apt/sources.list.d/mono-xamarin.list

For older Ubuntu releases (12.04 or 12.10), to enable installation, you'll have to add the following repository:

# echo "deb http://download.mono-project.com/repo/debian wheezy-libtiff-compat main" | sudo tee -a /etc/apt/sources.list.d/mono-xamarin.list

Now, run sudo apt-get update. After this, you can install all the packages you need:

# sudo apt-get install referenceassemblies-pcl mono-devel mono-complete monodevelop

2) Installing the Atomic Game Engine

Now it's time to start building the engine itself. The process lies within cloning the repository via git, running the build command, and voila - there you have it. So let's get to it:

Start by cloning the AtomicGameEngine repository recursively via git:

# git clone --recursive https://github.com/AtomicGameEngine/AtomicGameEngine /home/YOUR_USER/SPECIFY_LOCATION

If you do not specify a location, it will automatically get pulled down to /home/AtomicGameEngine. When it has finished cloning the repository, change directory to where it has been cloned to - e.g.:

cd /home/YOUR_USER/Documents/AtomicGameEngine

Now, we can run the build script which is called "Build_AtomicEditor.sh":

sh Build_AtomicEditor.sh

You can add flags to this command according to your needs:

Flag Description
--noclean Do not clean before building, useful during development
--nonet Build without AtomicNET C# scripting support
--with-docs Build and install API documents into the editor
--with-examples Install examples into the editor

The --nonet flag will automatically be applied, if MonoDevelop isn't installed by this point

For example, if you want to build the engine with examples (which is recommended for newbeginners!), use:

sh Build_AtomicEditor.sh --with-examples

When it has finished building, navigate to the installation directory - the Atomic Editor is inside /Artifacts/AtomicEditor.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment