If you need proxy server support for your GameMaker installation, you can add it by including a Proxy Settings file in your GameMaker installation directory. A sample file is provided at the end of this guide. GameMaker will use this file to pass these settings to your proxy server, which should fix any issues with licensing or runtime downloads.
It is worth noting that if you have set a proxy in your Windows Internet Options or in your Mac System Properties and it doesn't require a username/password, then it should just work "as is" and you probably will not be required to set up the proxy specifically for GameMaker.
Please note also that your proxy must allow the downloading of files by GameMaker - if it doesn't, then licensing and runtime downloads will continue to fail.
The proxy server must allow connections between GameMaker and the server using http, and not restrict to only allowing https traffic, as the .NET 6 runtime GameMaker uses does not support https proxy connections.
Create your file
Create a file (or paste the sample at the end of this guide) named proxy_settings.json in the following directory:
- Windows: %programdata%\GameMakerStudio2
- Mac /Users/Shared/GameMakerStudio2
You can now add in the details required by your proxy. Some of the fields shown above are optional and if there is one your server doesn't require to be filled-in, then simply leave the field blank NOTE: 'blank' still requires the double inverted commas. i.e {"blank": "",} to be valid json.
The "proxy" field needs to start with http:// and then contain the IP address or name for the machine and the port to use. Something in either format shown below:
http://<xx.xx.xx.xx>:<port>
http://<www.myserver.com>:<port>
If your proxy does require a username and password, then you will need to add them, plus fill in the Domain field accordingly.
If your proxy does not require a username and password, then simply leave all three fields blank.
Once you have added the relevant information, save the file and log in to GameMaker using your seat credentials, as normal.
Replicating To Other Machines
If you have multiple machines which need this same information, then be aware there is no ability within GameMaker to disable this proxy support - if for some reason you do need to disable it, simply delete or rename proxy_settings.json. However, rather than sitting at each and adding the details manually, you can set up one machine as above, copy the proxy_settings.json file you created, and pass this around the other machines.
As above, the file can be found:
- On Windows, %programdata%\GameMakerStudio2
- On macOS, /Users/Shared/GameMakerStudio2/ (Macintosh HD > Users > Shared > GameMaker)
Be aware that this file lives in a shared settings folder for GameMaker, so if you do pass the file around, then all students will be using the same proxy server login details - this may not fit your needs - in this instance, it may be of use to create a 'gamemaker' user for your proxy.
As stated above, please use the template below for setting up and distributing your proxy settings to machines on your network: