Linux Run the GMS2 IDE on Ubuntu 19.04

GM Version: GMS2.2.2.413 (Runtime: v2.2.2.326)
Target Platform: Ubuntu 19.04 (Other Linux versions may work as well)
Download: N/A
Links:

• https://dl.winehq.org/wine-builds/winehq.key
• https://dl.winehq.org/wine-builds/ubuntu/ disco main
• https://www.yoyogames.com/blog/107/how-to-compile-to-linux-ubuntu
• https://help.yoyogames.com/hc/en-us/articles/235186168
  
• https://www.yoyogames.com/images/gms2_logo_512.png

Tested with:
Ubuntu 19.04
Linux Mint 19.1

Summary:
This tutorial tells you how to get GameMakerStudio2 to install, the IDE to run and get it to compile games.
This is accomplished using wine and some fiddling around with .NET.

Requirements:
64x bit install of Ubuntu 19.04
gms2 installer file: GameMakerStudio-Installer-2.2.2.413.exe (others may work as well)

Todo:
Fix GLX errors. (Wine openGL to X window manager doesn’t work correctly)
Test Android support.

Tutorial:
First install the latest version of wine using these commands:

add wine repo key:
wget -nc https://dl.winehq.org/wine-builds/winehq.key && sudo apt-key add winehq.key

add wine repository:
sudo apt-add-repository 'deb https://dl.winehq.org/wine-builds/ubuntu/ disco main'
note: If you are on any other distribution, you might need use a different link.

On Ubuntu 18.04 or Linux Mint 19.1 this is: (Thanks to @canoi)
sudo apt-add-repository 'deb https://dl.winehq.org/wine-builds/ubuntu/ bionic main'​

add repo for unmet dependency libfaudio0:
sudo add-apt-repository ppa:cybermax-dexter/sdl2-backport

update available packages:
sudo apt update

install wine:
sudo apt install --install-recommends winehq-devel​

If everything went correctly "wine --version" should return "wine-4.10¨

Next up, we want to install q4wine. This is a usefull tool to manage prefixes, manage running processes and load up .exe files correctly.

install q4wine:
sudo apt install q4wine

install winetricks:
sudo apt install winetricks​

We need to setup a wine prefix in q4wine:

• Create a new gms2 folder in your home folder.
• Open q4wine.
• Run trough the q4wine setup process. (you can mostly click next)
• Create a new prefix under 'prefixes'.
• Name the prefix 'gms2'
• Set the prefixpath to the previously created gms2 folder.
• Set the arch to 64 bit.
• Save the prefix

​

Run the following command to initiate the prefix: (We're also going to uninstall mono)

(if you chose a different wine prefix folder, don't forget to change it in these commands)
run uninstaller and init the prefix:
WINEPREFIX=~/gms2 WINEARCH="win64" wine64 uninstaller

If you are asked to install wine mono click 'install'. Do the same for gecko.
A wine GUI should open now. Select Mono and click uninstall. Both mono entries should have been deleted.​

We need to install .NET now. use the following commands:

Install .NET 4.5.2:
WINEPREFIX=~/gms2/ winetricks dotnet452

Run trough the installers.
If you are given a warning about the windows update server, just continue.
You don't have to restart your computer.​

Install gms2:

Now you want to download the gms2 installer .exe file.
Open it with q4wine (right click the file and select 'open with other application' if q4wine is not the default)
In q4wine select the gms2 prefix.

Install gms2.
If you see a "Turn Windows features on or off" message click okay.
If a .NET 3.5 installer opens, cancel the installation.
If a .NET 2.5.4 repair window opens, close it by going into Q4Wine into the processing tab and terminating "Setup.exe"​

GMS2 IDE should now open automatically. (or it may not) If it does, close it.

If you want to start it manually execute the following command:

WINEPREFIX=~/gms2 WINEARCH="win64" wine64 "C:\Program Files\GameMaker Studio 2\GameMakerStudio.exe"​

(thanks to @tijeseffff )

In the IDE, login to your account and wait for the runtime to install.
Start a new test project, make a room, an object and add a hello world message.

Click run. Your game should now start.

Compile a native linux executable:

Spoiler

To compile for linux we are going to follow this guide:
https://help.yoyogames.com/hc/en-us/articles/235186168
For your ip, you can fill in localhost or '127.0.0.1'

If that doesn't work you can try:

Spoiler

https://www.yoyogames.com/blog/107/how-to-compile-to-linux-ubuntu

There will be an extensive list of packages to install. However, not all of these packages are available anymore. This can be fixed by using:

sudo apt-get install libssl1.1
sudo apt-get install libbz2​

and then 'hacking' libssl to look like libssl1.0.0:

sudo cp /usr/lib/x86_64-linux-gnu/libssl.so.1.1 /usr/lib/x86_64-linux-gnu/libssl.so.1.0.0
sudo cp /usr/lib/x86_64-linux-gnu/libssl.so.1.1 /usr/lib/libssl.so.1.0.0
sudo cp /usr/lib/x86_64-linux-gnu/libcrypto.so.1.1 /usr/lib/x86_64-linux-gnu/libcrypto.so.1.0.0
sudo cp /usr/lib/x86_64-linux-gnu/libcrypto.so.1.1 /usr/lib/libcrypto.so.1.0.0​

Now follow the guide setting up your host to accept ssh connections.
Eventually you should see a native Linux app running on your pc.

Make a launcher shortcut

Spoiler

Download and build AppEditor:
sudo apt install valac libgranite-dev meson
cd ~/
git clone https://github.com/donadigo/appeditor.git
cd appeditor

Build AppEditor:
meson build
cd build
meson configure -Dprefix=/usr
ninja
sudo ninja install

Create startup script:
cd ~/
nano launchGMS2.sh

Insert the following text:
WINEPREFIX="/home/YOUR_USER_NAME_HERE/gms2" WINEARCH="win64" wine64 "C:\Program Files\GameMaker Studio 2\GameMakerStudio.exe"

Press CNTRL+X to close nano. Type 'Y' to save.

Launch AppEditor:
cd ~/appeditor/build
com.github.donadigo.appeditor

GMS2/wine itself should have already made a launcher icon. We are going to edit that.
Find it and:

- set 'Show in Launcher' to true.
- set the 'Category' to Programming
- set 'Command Line' to /home/YOUR_USER_NAME_HERE/launchGMS2.sh
- enable 'Launch in Terminal'​

Now save and try the launch entry. (close any open IDE's beforehand)​

Compile for android:

Spoiler

Download latest jdk8 for Windows x64, and the latest jdk8 for Linux (.tar.gz):

https://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html​

If you don't have an account you can make one with a temporary email service: https://temp-mail.org/en/view/3586d8b76358d93eabd0f0d53207bfc4
note: I used jdk-8u211.

Launch jdk-8u***-windows-x64.exe with q4wine in gms2 prefix.
Some UI elements of the install will be broken.
Check the box and press the left button.
Click Next
On the next broken screen press the left button again
If the same message keeps popping up, click the right button.
Go to your GMS2 android platform settings and set the JDK to: C:\Program Files\Java\jdk1.8.0_XXX (your directory may be different)
(These steps are kind of vague, they may need to be written down more clearly. These were my notes and I didn't have enough time to walk trough the process again on my tutorial VM.)

Download android studio for windows 64 bit:

https://developer.android.com/studio/​

Run the installer in the correct prefix using q4wine.
After the installation execute:

WINEPREFIX=~/gms2 WINEARCH="win64" wine64 "C:\Program Files\Android\Android Studio\bin\studio64.exe"​

Don't send usage statistics.
Do a custom install.
Set SDK path to C:\Android\SDK
Don't install Intel HAXM
Follow trough with the install. Android studio will start to download components.

When you see the Android Studio welcome screen, click configure and then 'SDK Manager'
Install the correct SDK platforms and the SDK tools. Use this tutorial as reference:

https://help.yoyogames.com/hc/en-us/articles/216753498-GameMaker-Studio-Android-SDK-and-NDK-setup-​

Again, make sure not to install anything to do with HAXM.
Install the components and accept all license agreements.

Install android studio on your host machine with the exact same settings. On Ubuntu you can install android studio trough the Software center. When setting up android studio use linux kernel hardware acceleration module instead of HAXM. (This should be done by default)

Open a terminal and do:

Cd ~/Android/Sdk/platform-tools/
./adb --version​

This should yield:

Android Debug Bridge version 1.0.41
Version 29.0.1-5644136
Installed as /home/YOUR_USERNAME/Android/Sdk/platform-tools/adb
​

Open a second terminal and do:

WINEPREFIX=~/gms2 WINEARCH="win64" wine64 cmd​

This will open a windows cmd prompt. Here you can execute:

C:
cd C:\Android\SDK\platform-tools
adb --version​

You should see something among the lines of:

Android Debug Bridge version 1.0.41
Version 29.0.1-5644136
Installed as C:\Android\SDK\platform-tools\adb.exe
​

It is okay if the version numbers between your setup and my setup differ, as long as the Windows and Linux Android Debug Bridge versions are the same.

Luckily for us the ADB uses a separated client interface connected do a daemon server. We can actually run the server on Linux and the client on Windows.
To do this, on your host execute: (In the same folder as last time)

./adb start-server
adb devices​

If you had your phone connected to your computer, you should see it identified by adb. If not, connect your phone or troubleshoot your usb connection.

On cmd execute:

adb devices​

Your adb devices should show up in Windows.

In GMS, go to the android device editor (open the targets menu, click Android and click on the pencil under devices). Click 'Detect Device'. Your device should show up.

Go back to your android platform settings and generate (or import) a keystore file. This keystore file has to be in the root of your windows system. For example: C:\testProject.keystore. Keeping the keystore file in the root directory makes our life easier down the road and prevents our filename from having any spaces.

Find out what the API level of your phone is and select that in GMS.
Select the processor architecture of your phone. (I had to enable ARM64)

Extract your java-8u***-linux-x64.tar.gz file into your home directory.
Edit your /etc/profile file to set your java home correctly:

sudo nano /etc/profile​

Add the following four lines:

JAVA_HOME=/home/thomas/jdk1.8.0_211
PATH=$PATH:$HOME/bin:$JAVA_HOME/bin
export JAVA_HOME
export PATH​

Let Ubuntu know where our java is:

sudo update-alternatives --install "/usr/bin/java" "java" "<Directory where JAVA has been extracted>/bin/java" 1
sudo update-alternatives --install "/usr/bin/javac" "javac" "<Directory where JAVA has been extracted>/bin/javac" 1
sudo update-alternatives --install "/usr/bin/javaws" "javaws" "<Directory where JAVA has been extracted>/bin/javaws" 1
sudo update-alternatives --set java <Directory where JAVA has been extracted>/bin/java
sudo update-alternatives --set javac <Directory where JAVA has been extracted>/bin/javac
sudo update-alternatives --set javaws <Directory where JAVA has been extracted>/bin/javaws
​

java -version should now return:
java version "1.8.0_211"
Java(TM) SE Runtime Environment (build 1.8.0_211-b12)
Java HotSpot(TM) 64-Bit Server VM (build 25.211-b12, mixed mode)

If you see something along the lines of OpenJDK 11, your gradle will not work.

install gradle:

sudo apt install gradle
​

Create a new android build folder somewhere on your computer.
Add a copy of your keystore to this folder and call it 'project.keystore'.
Add the following python script called launchGMS2AndroidBuild.py:

Spoiler

#launchGMS2AndroidBuild.py
#Author TTheCreator https://forum.yoyogames.com/index.php?members/tthecreator.233/
#This script looks for changes in GMS's cached android build output and will compile and run your android app when GM is done with it's business.

import sys
import time
import logging
import re
import shutil
import os
from watchdog.observers import Observer
from watchdog.events import LoggingEventHandler
import distutils.dir_util

windows_gms2CachePath = "/home/YOUR_USERNAME/gms2/drive_c/users/YOUR_USERNAME/Application Data/GameMakerStudio2/Cache/GMS2CACHE/testProjec_BCCB0FB7_367ADB89"

host_gradleVersion = "2.3.3"
host_sdkDir = "/home/thomas/Android/Sdk/"#Where your android sdk is located
host_keyStore = os.getcwd() + "project.keystore" #The location of your keyfile on your host machine
android_packageName = "com.company.game"#The packagename of your game
host_cacheFile = "gms2cache"#The local folder on your host that is used to hold and manipulate the gms2 android compile cache
last_changed_build_file_pattern = re.compile(".*build.sample") #What file game maker edits last when compiling for android.

def cleanUp():
print("cleaning up...")
if(os.path.isdir(host_cacheFile)):
shutil.rmtree(host_cacheFile)

def copyCacheToHost():
print("copying cache to host")
distutils.dir_util._path_created = {}
distutils.dir_util.copy_tree(windows_gms2CachePath, host_cacheFile)

def changeProjectFileForHostCompatibility():
setHostGradleVersion()
setSdkSrcDir()
setKeystoreFile()

def setHostGradleVersion():
#make sure we are using the correct gradleVersion
print("Setting gradle version to:"+host_gradleVersion)
with open (host_cacheFile+"/Android/default/build.gradle", 'r') as f:
content = f.read()
content_new = re.sub("gradle:.*'", "gradle:"+host_gradleVersion+"'", content)
with open (host_cacheFile+"/Android/default/build.gradle", 'w') as f:
f.write(content_new)

def setKeystoreFile():
#make sure we are using the correct gradleVersion
print("Setting keystore file to:"+host_keyStore)
with open (host_cacheFile+"/Android/default/"+android_packageName+"/build.gradle", 'r') as f:
content = f.read()
content_new = re.sub("C:/.*.keystore", host_keyStore, content)
with open (host_cacheFile+"/Android/default/"+android_packageName+"/build.gradle", 'w') as f:
f.write(content_new)

def setSdkSrcDir():
print("Setting sdk source directory to:"+host_sdkDir)
with open (host_cacheFile+"/Android/default/local.properties", 'w') as f:
f.write("sdk.dir="+host_sdkDir)

def gradleCompile():
print("Using Gradle to compile in:"+host_cacheFile+"/Android/default")
os.system("cd "+host_cacheFile+"/Android/default && gradle installDebug && cd ../../../")

def runOnDevice():
print("Using adb to run the app on a device")
os.system(host_sdkDir+"platform-tools/adb shell monkey -p "+android_packageName+" 1")

class GMSEventHandler(LoggingEventHandler):
def on_any_event(self, event):
print("HI!")
#print(event)
print(event.src_path)
if (last_changed_build_file_pattern.match(event.src_path)):
print("build sample file has been edited")
copyCacheToHost()
changeProjectFileForHostCompatibility()
gradleCompile()
runOnDevice()
cleanUp()

if __name__ == "__main__":
print("Started looking for changes to: "+windows_gms2CachePath)
cleanUp()
logging.basicConfig(level=logging.INFO,
format='%(asctime)s - %(message)s',
datefmt='%Y-%m-%d %H:%M:%S')
event_handler = GMSEventHandler()
observer = Observer()
observer.schedule(event_handler, windows_gms2CachePath, recursive=True)
observer.start()
try:
while True:
time.sleep(1)
except KeyboardInterrupt:
observer.stop()
observer.join()
cleanUp()​

You will need to edit this python file to make sure it runs on your machine. On the top of the files there are a bunch of settings you can change. This script only supports full system paths. '~/' is invalid and will not work. That's why you may need to inject your username into the script.

To start the script open a terminal in the folder you created and execute:

python3 launchGMS2AndroidBuild.py
​

You might need to install the watchdog python module:

pip3 install watchdog
​

If you don't have python installed:

sudo apt install python3
sudo apt install python3-pip​

To stop the script press CNTRL+Z

From this point on my python script should take care of everything for you. Once it detects that build.sample has been updated, it will copy over the GMS2 android compile cache, change some settings and finally run gradle. Gradle will install the app for you on your phone after which the python script will launch it.​

​

Known problems:

GLX Errors:

Spoiler

If you see any of the following in your terminal while running GMS:

- wine X Error of failed request: BadValue
- Any error saying something with GLX​

Do the following:

- restart your pc
- upgrade or reinstall your video drivers.​

'This program encountered an error':

Spoiler

In some cases wine might throw an error saying the program cannot be booted. When this happens is somewhat random and you might need to try launching GMS2 a few times before it finally works.​

Wine screws up audio:

Spoiler

In some specific configurations starting a wine program may cause your sound to become higher or lower. To fix this execute:

pulseaudio --kill​

Running gradle gives you a license error:

Spoiler

open android studio on your host. Open the sdk manager and install the corresponding package. You may need to check 'Show Package Details'.

Make sure you can compile an app (just an empty test project) in android studio on your host using the same build tools version and sdk version. You can change this in file>project structure

Go into your android sdk directory on your host:

cd ~/Android/Sdk/tools/bin​

and:

./sdkmanager --licenses
say 'y' to all​

adb server version (41) doesn't match this client (39); killing...

Spoiler

This error occurs when you are using multiple adb versions. Make sure the adb version of your host machine is the same as on your windows machine.

Make sure you have your adb daemon running on your Linux host.

On your host, make sure you are running the program adb in the platform-tools folder.
Cd into this folder and use './adb'. The ./ is important.

Make sure the package 'android-tools-adb' is NOT installed. Uninstall it with:

sudo apt purge android-tools-adb​

Sources:
http://ubuntuhandbook.org/index.php/2019/05/nstall-wine-4-8-ubuntu-19-04-18-04/
https://wiki.winehq.org/Mono
https://www.yoyogames.com/blog/107/how-to-compile-to-linux-ubuntu
https://forum.winehq.org/viewtopic.php?f=8&t=14285
https://linuxconfig.org/how-to-crea...ncher-on-ubuntu-18-10-cosmic-cuttlefish-linux
https://www.omgubuntu.co.uk/2018/02/app-menu-editor-for-ubuntu-appeditor
https://github.com/donadigo/appeditor
https://stackoverflow.com/questions...d-to-notify-project-evaluation-listener-error
https://developer.android.com/studio/build/building-cmdline
https://stackoverflow.com/questions/4567904/how-to-start-an-application-using-android-adb-tools
https://stackoverflow.com/questions...se-agreements-of-the-following-sdk-components
https://github.com/oblador/react-native-vector-icons/issues/527
https://www.guru99.com/how-to-install-java-on-ubuntu.html
http://tipsonubuntu.com/2016/07/31/install-oracle-java-8-9-ubuntu-16-04-linux-mint-18/
https://askubuntu.com/questions/620888/installing-jdk-with-wine
https://stackoverflow.com/questions/37691070/cannot-install-jdk-8-on-wine-ubuntu
https://help.yoyogames.com/hc/en-us/articles/216753498-GameMaker-Studio-Android-SDK-and-NDK-setup-


special thanks to:
The winehq team (For not making an emulator)
@tijeseffff (For fixing a problem where the IDE was unable to start Igor.exe)
@XSonicRU (For suggesting testing this with Android)
@canoi (For testing Linux Mint 19.1)

 

The only reason why I'm using Windows is games and game maker. I can play the same games on linux (Dota2 etc.), but I couldn't do it with Game Maker. It seems like now I can.
Thanks

 

Actually I've been searching for a while how to install wine on Kubuntu, as KDE Plasma Discover doesn't seem to have it.

Thanks for the terminal commands.

 

That's awesome! Have you tested it with GMS1.4?

 

Just a wild guess in regards to what this thread is about and what it does not cover

Spoiler

no

 

I've gotten gms1 running in some state, but due to the window skinning and some other problems I've given up on getting it to work. Gms2 has a platform aspecific code base because it has to run on MacOS as well.

 

How to fix Igor problem. (no need to run another cmd window)
Launch your GMS2 using this command

Code:

WINEPREFIX=~/gms2 WINEARCH="win64" wine64 "C:\Program Files\GameMaker Studio 2\GameMakerStudio.exe"

And done.

 

F'n awesome, T!! I hope to have some time to try this out soon.

 

What about android builds? Can someone test them?...
If they're working then there's really no reason to use win for me

 

I'm testing it right now but the odds don't seem to be in your favor.
We need to get a JDK running on win, plus low level USB drivers. This is asking for trouble.

 

Just tested it. It mostly worked, but at some point it crashed pretty hard and somehow Wine removed the GMS2 install.
Compiling and running was working.
I tested GMS1.4 as well but kept have authentication problems (which, I believe, exist on Windows too). When I managed to load a project, I tried to compile it but GMAssetCompiler.exe was failing for some reason.

Anyway, thanks again for tutorial. Hopefully Wine and Proton will keep making progress and compatibility will improve.

 

OH GOOOOSH, it's working!! After a long time hahaha
Finally i can use it without open a vm everytime!

I'm using Linux Mint 19.1 (Based on Ubuntu 18.04, so it should work on Ubuntu too), and it's everything working.
I first tried with wine 4.0, but it had issue on compile/build the game. So it really needs wine 4.10

If anyone has doubts on how to install on 18.04, follow all the guide, but just change this part

to this:

 

This should be added to YoYo's official tutorials.

https://www.yoyogames.com/learn

 

It seems like I succeeded in compiling for Android. However, I still need to do a lot of work to streamline the process. Right now it requires copying over files an manually editing them.
I'm going to write a script that can automatically detect when game maker updates files and then compile and run things for you. This way gradle, the sdk and adb can run on your host. Forget about running adb on wine.

 

There you go everybody, I've got the Android target platform running in a usable manner. It does require a little python script to be running all the time but that is only a small sacrifice.

 

This is all really great work! I'm not going to be able to take advantage of this, but I really appreciate all the effort you put into this to help out other Linux users.

 

I got stuck at the .net frame installation. Followed the tutorial, using wine 4.11, mint tara using the bionic package.

It got stucks every time I tried to install. Remove the prefix, delete the entire prefix folder, reinstall. Stuck every time

Did anyone encounter this?

 

@SlightlyWind did you execute the dotnet452 winetricks step correctly?
The installer GM has embedded doesn't work. You need to end it. Close it by going into Q4Wine into the processing tab and terminating "Setup.exe"

 

@Tthecreator I deleted the whole folder and prefix, installing them again. Now the dotnet452 terminal stayed like this for an hour or more already. Imma try again now. it's like 24h of this already XD

 

It seems that winetricks is waiting for all wineprograms to be closed. Go into Q4Wine and terminate all wine programs.

 

@Tthecreator damn it successfully installed, thanks for the tutorial

 

@SlightlyWind No problem. What eventually ended up fixing your problem? I'll add it to the known problems list.

 

btw wine doesn't really do the trick, the game runs at 60 fps, draw gui fps in game return 60 all the time but on screen it's like 25fps for some reason.

 

I didn't saw that till now. Not sure what wine broke during the installation but after delete the folder and reinstall it just did the job.

 

For those of you who want a single runtime executable on Windows in GMS2:

https://www.gamephase.net/gms-zip-to-exe/

It requires Windows 7 for compatiblity with all Windows versions from Windows Vista to Windows 10.

However, on topic here - after you build said EXE using your Windows system...

...a recent wine update fixed an issue with this. Single Executables made with this method previously did not work in wine.. it would just throw an error. But after I updated wine a few days ago, it appears that bug is fixed and single runtime EXE's now work under wine! This also means GMS 1.4 single runtime EXE's built on Windows 7 will also work, since both use the same system32 / sysWOW64 folder stuff to create the EXE's.

Use the information in this tutorial to install wine, or link to this topic for any linux users who may want to try your game but don't have windows, and instruct them to skip all the unrelated steps regarding GMS2 development.

Cheers!