User Permissions and Internet Access Required by GMS2

YoYo QA Dept
  • Updated
Follow

This guide will give you the details of folders and web URLs GMS2 will need access to on your systems in order to function properly.

It's worth noting that currently there is no "Educational" version of GMS2 and all versions of GMS2 behave in the same way, so all of this guide can be followed by any GMS2 user. You can also follow this guide with a free trial licence and confirm your intended setup before you make any purchase.

Following the below steps should ensure that GMS2 is able to be installed, configure itself, access our internet facilities, and compile and save projects successfully.

Before beginning this guide, we would also advise that you quickly confirm your system clock is actually correct, as all file saving/loading relies on accurate timestamps. Your OS clock being wrong can mean that GMS2 will incorrectly think files are/are not modified.

 

Please be aware that as we do not have access to your personal setup, our Helpdesk team are usually unable to determine issues such as why one machine or student in a classroom doesn't work when the others do, and we will not be able to offer any guidance on anything to do with your operating system user permissions, proxy server settings or VPNs, firewalls, or anti-virus. For all of these issues, please ask the person who usually configures the machine(s) to investigate your setup.

 

 

Installation

Installation is to be performed by an administrator account, as:

You can choose the installation location during the installer, however be aware GMS2 does not support remote or portable drive installations or any form of thin-client systems.

Please note there is currently no distributed/automated installation facility. Installation, licensing, and runtime installation will have to be carried out at each machine. You can, however, download your runtimes once and then pass these around on your network - see this FAQ on how to download your runtimes as a .zip.

 

Folder Access

There are two "system" folders GMS2 uses, the location you intend to install GMS2 to, plus a number of customisable temporary project build folders you can customise in Preferences within GMS2 after the initial installation is complete.

Students will need full read+write access to all of these locations, otherwise GMS2 may fail to start, may fail to license, or may not be able to build projects.

GMS2's own settings, the tools GMS2 uses to build your projects, and information on your devices lives in the following location:

  • On Windows, C:\ProgramData\GameMakerStudio2
  • On macOS, /Users/Shared/GameMakerStudio2/ (Macintosh HD > Users > Shared > GameMakerStudio2)

This is also where GMS2's log file lives ("ui.log"), so if you're having issues and need to contact us, please see this log file first, as it may help you determine the issue straight away. We will also very likely ask you to send us this file, so please attach it to your opening request.

Each user's own preferences and settings, plus information on the projects they have worked on lives here:

  • On Windows, %AppData%\GameMakerStudio2 (AKA C:\Users\[Windows username]\AppData\Roaming\GameMakerStudio2)
  • On macOS, ~/.config/GameMakerStudio2/ (Note that .config is hidden by default. You need to open Finder and then press Shift + Cmd + . to toggle showing hidden files and folders.)

Each GMS2 seat/license which uses the machine will create a separate user settings folder within the location above.

 

Build Folder Preferences

As well as allowing read/write access to the following locations, we would recommend adding these to your antivirus client's exclusions list, as the files will be changed frequently and both applications modifying and locking the files will often increase build times and even occasionally cause build failures.

GMS2's build locations default to: 

  • On Windows, Temp is %LocalAppData%\GameMakerStudio2 and your build cache is %AppData%\GameMakerStudio2\Cache
  • On macOS, the Temp folder path is determined by the user and a randomly-generated value, so we can't document this as part of this guide. You will need to open Preferences after GMS2 has been installed and get the location from there. The build cache folder is /Users/[macOS username]/.config/GameMakerStudio2/Cache

Each user's own project save locations default to:

  • On Windows, C:\Users\[Windows username]\Documents\GameMakerStudio2 (AKA My Documents > GameMakerStudio2)
  • On macOS, /Users/[macOS username]/GameMakerStudio2

Note that after following this guide you might need to clean your project cache via the button inside GMS2 or by manually removing the cache files in the folders mentioned above before you try building it again, so you may wish to clear any stale files out just now.

 

Changing Your Project Save Locations

We would recommend that if you wish to change the default save location, then you stick to a folder on the main OS drive (the same disk GMS2 is installed on), but you are free to customise this. You should, however, bear in mind that your choice of save location can impact on build times and can in some cases cause saving issues.

  • Using Network Drives

Projects and build files can be stored on network drives, but be aware the extra latency involved in this will impact build times (potentially substantially) and may also cause issues for the file watcher as described in the next section of this FAQ.

  • Using USB drives

For all of the same reasons given above for network drives, we do not recommend using detachable USB drives for build folders, even if they are high-speed devices.

You can modify the file watcher settings and make this work, but we would always suggest team members instead work on copies of the project locally, then Export and share only the .yyz archive via USB drives.

  • Using OneDrive/Dropbox/Google Drive, et al.

We also do not recommend using "live folders" to host your project folders, as these external applications will periodically lock your files in order to do their own job. This can cause issues when building projects and in rare/extreme circumstances can result in project save errors.

If you do not wish to use a full online source control service (like Github/Gitlab/etc.), then we would always suggest team members instead work on copies of the project locally, then Export and share only the .yyz archive via these "live folders" - this would give you a better backups solution anyway, as you could revert unwanted changes much more safely and easily.

 

The File Watcher

GMS2's file watcher monitors your project's save area on disk for changes made outside of GMS2 itself (such as you editing one of your sprites or sounds in an external editor of your choice). It does this via monitoring the timestamps on when your files were last edited.

This dialog looks like this (your paths will be different):

mceclip0.png

If you did edit your files outside GMS2, then all is correct. You now have the option to Reload (pull in your external changes), or Save the version GMS2 has in memory (discard the change you made externally).

However, depending on where you save your files and whether you have protection software which is set to scan your project's save folder, you may be seeing that dialog when you're not expecting to, because the timestamps on your files may be beyond the range the file watcher is set to tolerate before it thinks the file has been edited externally.

Please note that for this same inaccurate timestamps reason, when installed on Windows, GMS2 requires NTFS-formatted drives for all save/load locations. GMS2 may not save projects reliably if your save folders are on FAT-formatted hard drives.

If you are receiving these file watcher dialogs and you know you are not actually editing your files outside of GMS2, first of all quickly confirm that your OS clock is correct. If it is not, you should fix this before trying anything else - as already mentioned multiple times in this FAQ, GMS2 relies on the timestamps for files being correct, so you will likely find fixing your clock fixes immediately GMS2.

If you do still have the issue, we would recommend you follow the entirety of this guide first (so any AV client is configured properly) and if that still fails to fix, initially you should try relaxing the timings for the file watcher so it scans the folders less frequently. Do this by typing larger values in the box shown below:

mceclip0.png

If you find that doing this still isn't resolving the issue, or you don't want the ability to edit your files outside GMS2 anyway, then you can turn the file watcher off by simply unticking the checkbox and restarting GMS2.

 

Or, if for some reason you're still using 2.2.5 or older, it will look like below (and the laptop one is only relevant when you're running on battery power):

If you find that doing this still isn't resolving the issue, or you don't want the ability to edit your files outside GMS2 anyway, then you can turn the file watcher off by simply making those two values -1 and restarting GMS2.

We would strongly recommend you upgrade to 2.3.0 or newer if you're having file watcher issues.

 

Network / Internet Access

The installation of GMS2 is not complete until you have downloaded your runtime files, and in order to do this you will also have to successfully log in to our accounts server to complete a licensing request.

if you can, we would recommend you allow access to *.yoyogames.com

If you have to specify all addresses, you will need to allow access to:

If you use a proxy server, then please see our FAQ for this, as this may need to be configured before you will be able to license successfully.

Ports 80 and 443 are required to run GameMaker Studio 2, so you should also ensure that these are open in any firewall.

GMS2 does also use a small handful of third-party websites in order to confirm if the machine has internet access. We would recommend that you allow at least one of these, as it helps GMS2 confirm if there is internet but that our server is offline, and it will avoid unnecessary licensing attempts during these situations.

GMS2's stated requirements are for an always-on internet connection, however in practice you can often run offline for periods of time.

Be aware GMS2 will require internet access at least once every 28 days in order to avoid your license information expiring and without internet access you will not be able to update your license if you buy new products, download any new demos or tutorials, or access our Marketplace.

 

The Runtime Tools

GMS2 relies on two executables in your runtimes installation folder in order to compile your projects and then deploy/run the game on your testing device.

Although we have already mentioned ensuring access to the two folders below, you may find that you need to give the antivirus/firewall permissions listed above to these two applications specifically (as well as the main GMS2 application) before projects will build correctly.

These are GMAssetCompiler.exe and Igor.exe and they live in:

  • (Windows) C:\ProgramData\GameMakerStudio2\Cache\runtimes\[your runtime version number]\bin\
  • (macOS) /Users/Shared/GameMakerStudio2/Cache/runtimes/[your runtime version number]/bin/

Note that if you are already having issues where your project compiles stop early in the build process, then ensure your antivirus client has not already quarantined these files - if it has, you will need to release them from the quarantine and mark them as safe/trusted.

 

The In-IDE Debugger

There is no separate module for the debugger - it's the GMS2 executable itself, but if you have to open specific ports for GMS2, then be aware that for the debugger to connect to devices you will need to allow this also.

Remember that you may need to apply the same firewall rule to the game application if it is installed on this machine also, otherwise you won't have two-way traffic.

The default Preference is configured to use TCP 6509, but if you want to change this before you configure your firewall, you can. Whichever port you set here will always be the first one the IDE attempts to use, but it will try the next three sequential ports if it can't connect (e.g. 6509 - 6513):

mceclip0.png

You'll know if this is your issue, because your Output Window will have something like the following text and the debugger won't connect:

Start debug server
Creating Debugger server port:6509
Error: Can't listen to socket
cannot listen on selected port
Creating Debugger server port:6510
Error: Can't listen to socket
cannot listen on selected port
Creating Debugger server port:6511
Error: Can't listen to socket
cannot listen on selected port
Creating Debugger server port:6512
Error: Can't listen to socket
cannot listen on selected port
Creating Debugger server port:6513
Error: Can't listen to socket
cannot listen on selected port
[DbgServer]Failed

 

The Micro Web Server (used to show the manual and by the HTML5 target)

The manual is a collection of web pages saved on your PC/Mac and then loaded by the IDE via GMS2's own micro web server, so you may see a network access request to allow the web server to serve the manual files and run HTML5 projects the first time you try either of these actions - please allow this, otherwise your system will block this functionality.

The default port used for serving the manual is 51290, but this can be changed in your GMS2 Preferences > General > Help:

mceclip1.png

Note that you have full access to the manual when offline, as this comes as part of your GMS2 installation and does not require internet access (even thought the manual is opened in your favourite web browser). This will always be the accompanying manual for the specific IDE version you're using.

Additionally, an online copy of the current GMS2 stable release manual (which may not be the IDE version you are using) can always be found at http://manual.yoyogames.com (formerly docs2.yoyogames.com)

 

The Remote Worker

The remote worker is a separate Windows application install, so if you use this application then it will need to be configured in any firewall separately from the main GMS2 IDE. (There is a guide to enabling the remote worker here, should you need it.)

Usually, Windows will alert you to the LAN traffic when you start the remote worker for the first time and again when you do your first build. Simply accept these prompts to allow the traffic, and all should be okay.

The default port is 7653.

If you do need to control the IP addresses which can connect to the remote worker, you can do this in the remote worker's Network Settings dialog found within the Windows system tray:

mceclip0.png

Note that in order for the remote worker to operate you need to have enabled file-sharing and remote login between your Windows PC and your Mac - setting your LAN up and troubleshooting any LAN issues is beyond the scope of this FAQ and also the help we can offer on the Helpdesk, as we do not have access to your systems and network in order to investigate. You will need to speak to whomever typically administers your network.

 

 

Troubleshooting

 

Steam Client Online/Offline Setting

Please note that if you're using the Steam version of GMS2, it will follow Steam's own settings for whether online activity is allowed or not. This can cause issues with licensing and with downloading files.

If your Steam client is set to offline mode, GMS2 will also be in offline mode.

 

 

macOS IDE Requires Extra Setup If Your Proxy Server Requires Certificate Authentication

Please be aware that the version of Mono GMS2 currently uses has a known issue in that it doesn't import certificate authority information correctly, so if you are using a proxy server which requires this information you currently need to use the certmgr tool which ships as part of Mono's install in order to add your CA to Mono's own store.

After this, you should find GMS2 connects fine.

 

macOS Keychain Certificates For Our Websites

Please note that our web servers will offer certificates for your Mac to trust our websites each time you connect. If you do not have a certificate already and simply visiting the site in Safari does not give you one, but our websites load fine, then this is actually correct, as the certificate should not be saved permanently on your machine - your Mac will read it, accept it's okay, and allow you to talk to our server, then get rid of the certificate when you disconnect from our server.

However, if these certificates are saved to your machine because of some trust/security policy and then later expire, they will need to be renewed or you can have issues connecting to our servers.

One example of this is if you see issues with "Unable to login - Cannot reach https://accounts.yoyogames.com" dialogs during GMS2 startup and you notice TLS trust errors in your ui.log file. If you know your certificate policy is to use a customised setup, then we would recommend checking Keychain Access for all certificates from *.yoyogames.com and make sure that their trust setting is always "Default" and not "Always Trust" or "Do Not Trust".

This affects the following addresses:

https://marketplace.yoyogames.com/api/health-check 
https://accounts.yoyogames.com/api/health-check 
https://www.yoyogames.com

If the certificates for any of these are set to "Always Trust", then your Mac will ignore when our server offers an updated certificate, and you can end up sticking with a stale certificate and causing this inability to talk to our servers. Note that for all of them there is a site certificate and a root certificate.

You can also use Safari in place of Keychain Access for the paragraphs above: For each of the sites listed above, click the little padlock in the address bar and you can get to the trust values for the site certificate and the root certificate via this method.

If issues persist, you can always delete any *.yoyogames.com certificates again and visit the relevant website in Safari in order to re-download the current certificate, which should also fix your issue.

However, if you still can't view the website in Safari at all, it's worth confirming that your Mac is not set to block our servers. You will need to resolve/remove this block in your external protection software/policy and then use Safari to confirm you can reach our servers, then check if GMS2 now works also.

 

 

 

Related articles