Setting up Raspberry Pi Export for Game Maker Studio 2.3.1+

GM Version: 2.3.1+ (Out of date ?)
Target Platform: ALL
Links: <Links are provided where and when needed in steps>

Link to DragoniteSpam's video which helped start this tutorial
Link to Game Maker Community post

Summary:

In this tutorial, I will show you how to setup, use, and export to the Raspberry Pi using Game Maker Studio 2.3.1

NOTE:
Don't expect to make a full Triple A style game on the raspberry pi as the pi isn't made for that sort of thing. However a small game or a project that relies on CPU use will do very well.


What's needed:
  • Game Maker Desktop license, That allows export to Ubuntu systems
  • Raspberry Pi (4 is recommended but not required)
  • Micro SD Card & a computer device capable of reading an SD card
  • Basic understanding of how to use a computer

Keywords:

Main device: The computer that has game maker installed and is not the raspberry pi
OS: Operating system
Terminal: The command prompt for Linux based systems
ip address: Internet Protocol Address
VNC: Virtual Network Connection
GMS: Game Maker Studio

VIDEO TUTORIAL





WRITTEN TUTORIAL

Step 1: Setting up your Raspberry Pi

First Thing we are going to need to do is flash the memory of the micro SD card with the OS we want to use on the raspberry pi*

*If your raspberry pi came with a pre-installed OS installer such as NOOBS, boot up the raspberry pi and follow the instructions listed, or if you wish you can follow along this step anyway

We are going to install an app on our main device called Raspberry Pi Imager,
download The app for your Main Device's OS


With Raspberry Pi imager, installed you should have a screen like so
















Pick Choose OS
We are going to select Raspberry PI OS (other)

















Then we are going to select Raspberry Pi OS Full (32-bit)

















With that we are should be back to the main page shown in the first picture,
We are then going to select Choose SD CARD
You should then get a screen like this

















Then pick the Drive that is your SD CARD, If it shows that it's mounted as 2 letters don't worry.

WARNING!!! IF YOU ARE NOT CAREFUL YOU CAN OVERWRITE THE WRONG DRIVE AND LOOSE DATA OR HARM YOUR MAIN DEVICE! MAKE 200% SURE THE RIGHT DRIVE IS SELECTED


After you've made 400% sure we are going to select Write
It will ask if you are 500% sure and if you are, then select Yes
















It should then begin writing
















Once it is done you should get a screen like this
















Congratulations! The hardest part is done!

Step 2: Configuring the Raspberry Pi for Game Maker Studio

Plugin, power on & Boot up your raspberry pi,
If it restarts don't worry! If it keeps restarting or does not boot Take your SD card back to your main device, reformat it, then try step 1 again
If your raspberry pi boots, amazing! It will ask you some startup stuff, like keyboard, language and WIFI settings. Once you've done that, We need to do some configuration to make sure Game Maker can talk to it

On the desktop Click the raspberry in the top left, Preferences, Raspberry pi configuration

Switch over to
interfaces, Then Make sure SSH is set to enabled, as an optional step make sure VNC is set to enabled also

Now we open the terminal (The icon in the top right that has >_)

We are then going to type in all of this! One line, make sure its all the same! These are dependencies that Game Maker requires the Raspberry Pi to have to be able to run the operations it requires.

sudo apt install build-essential clang libxfont1 libssl-dev libxrandr-dev libxxf86vm-dev libopenal-dev libgl1-mesa-dev libglu1-mesa-dev zlib1g-dev libcurl4-openssl-dev zip


If all of that installed correctly, we can move on to the next part,
If not, look for the errors and try to fix them, I can not offer support for this as there may be many reasons why the install fails.

In the terminal type this, This will make all of the installed programs, software, OS files, and such update to the latest versions, 
if it stops and asks if you want to continue type y and enter

sudo apt update

After that make sure to run, this makes sure the updates above run and install

sudo apt upgrade


Now we need just one last thing, in the terminal enter

ip address

I'm going to block out a lot of this for protection on my sake, but what you are looking for is this, if you have connected your pi to the internet with an ethernet cord then look under eth0, otherwise if you connected via Wi-fi, then look under wlan0, you are looking for inet and the numbers after it it should look something like this 192.168.0.95

Once you have found the number write it down for later use!

With all that done reboot the Pi and move on to step 3, we're almost done!

Step 3: Configuring Game Maker Studio

So we've gotten our Raspberry Pi setup and working, we're going to leave it in the background and on our main device we're going to open up Game Maker Studio then open a project. 

In the top right we are going to select the cross icon, (targets)
Make sure platform is set to Ubuntu
by Device we are going to select the pen icon

Select Add New Device
A new box should appear asking for info like shown

Display name will be what ever you wish for GMS to refer to the Raspberry Pi as
Host name will be the ip address we got earlier
User Name is the username of your Raspberry Pi by default this is (pi)
Password is the Password you setup when you first setup the Raspberry Pi

After you fill all that out select Test Connection
after a few seconds Game Maker should tell you if it worked or not.
If it fails for any reason, check to make sure the Raspberry Pi is on, you entered everything correctly, you have SSH enabled shown in step 2


If you get the connection successful message, CONGRATULATIONS!
You can now develop a small game maker game for the Raspberry Pi, 
don't expect to make a full Triple A style game on the Raspberry Pi as the Pi isn't made for that sort of thing. Please refer to the Note at the top of the page


Optional Step: Setting up VNC

Now as you may have found out, its quite annoying to have a keyboard, mouse and monitor hooked up to the Raspberry Pi. Luckily there's ways around that!

We're going to need another app however. On your main device go to
and download for your main devices OS

Once it's installed select File > New connection

A new window should appear like such


VNC Server is the ip address you have for your raspberry pi
Name is a name you want for the connection

after you fill in those two lines select ok, then double click the connection


If you have VNC set to enabled like shown in step 2 then
It should say it is connecting then open the view of the desktop of your Raspberry Pi
You no longer need the keyboard, mouse, or monitor!
You also can transfer files without need of a usb device!

Anytime you want to see your Raspberry Pi, just turn it on and connect to it using 
VNC viewer


Happy Gaming!












No comments: