Downloading and Installation

Table of Contents

Java Download	Java Install	Setting Environment Variables	GlobalQuake
Windows	Windows	Windows	Download
Linux	Linux	Linux	Install
MacOS	MacOS	MacOS	Running

Java

(If you have Java already installed skip to the GlobalQuake Section)

[!NOTE] There are 2 architectures, x86-64 (also referred to as just "x64") and arm64, generally most computers have x86-64 so this tutorial will assume your device has that. If you encounter any errors make sure you have the correct Java for your architecture.
If you're on a recent MacOS device you should make sure of your architecture since some recent MacOS devices use arm64.

Downloading

Download Java 17. You can download Java for:

• Windows
• Linux
• MacOS

Windows

For Windows either the x64 Installer or x64 MSI Installer is fine to use.

Linux

For Linux it highly depends on the distribution you are running. If you are running Debian, or a distribution based on Debian like Ubuntu (A list of Debian based distros), download the "x64 Debian Package". If your distro is based off of Redhat (A list of Redhat based distros) use the "x64 RPM Package".

MacOS

For MacOS download the "x64 DMG Installer".

Installing

Windows

1. Download the installer
2. Open the installer
3. Click the "Next" button on the first Screen
4. Choosing a custom install location (if you don't want a custom install location skip to step 7
5. Go to the location you want to install Java with the file explorer. You can choose another drive by clicking the topdown menu at the top with the little downwards arrow on it. You can add folders using the button on the top right with the folder and shine icon. For example I went to my D drive and created a folder called JDKs and a sub folder called 17, for the JDK 17 version, for the path of "D:\JDKs\17", you can however install it wherever and name the folders whatever you like.
6. After creating the folders and sub-folders you want click on the folder you want to install to and click the "OK" button
7. Click the "Next" button
8. Wait for it install
9. Click the "Close" button

[!IMPORTANT]
If you selected a custom installation your system might not know that there is Java on your system and where it is, meaning Java apps still wont work. Please go to Setting Environment Variables

Linux

APT (Ubuntu)

1. Download the appropriate Java package. If you're not sure which one to download refer to Java Linux Download.
2. Open the downloaded file with a package manager. You can either set the defualt app for .deb files to a package manager or just open this file with a package manager this time. To open with a package manager this one time right click the downloaded .deb file, click "Open With Another Application", then click software install and then select.
3. When your package manager opens click the install button and wait for it to install. If it asks for authentication press "OK" or "Authenticate", or if it asks for a password input your password and press the confirmation button.
4. Verify it installed succsefully by going into the terminal and entering java -version. If you get something similar to the screenshot it has successfully installed. If you get an error saying bash: /usr/bin/java: No such file or directory it means it hasnt installed properly. Please try the steps again from step 1.

[!NOTE] Some buttons may be in different places or the UI may be entirly different depending on what desktop environment your OS is using. This tutorial was done using Ubuntu 22.04 with the GNOME desktop environment.

RPM (Fedora)

1. Open the terminal.
2. Enter the command sudo rpm -i https://download.oracle.com/java/17/latest/jdk-17_linux-x64_bin.rpm. It may ask for a password, if it does enter the password in the terminal. When you're typing it may look like nothing is happening, this is just to prevent other people from seeing your password, anything being typed is still going into the terminal. The terminal may look like it frozen for a while, it's not, it is just installing Java.
3. Enter the command java -version to verify it has isntalled. If it is similar to the screen shot then it as successfully installed, if you get an error it might mean it hasnt installed properly, try again from step 1.

MacOS

Under Construction

Setting Environment Variables

Environment Variables are variables stored in your system for apps to use. For example Java: windows stores the installation location of Java and then when you run a JAR file it looks for the location of Java by going to the Environment Variables and going to the location of Java specifically in the "Path" system variable.

To add Java to system variables follow these steps:

Windows

1. Search for "Environment" and click on "Edit the system environment variables"
2. Click the "Environment Variables" button on the bottom right of the new window
3. On the buttom half of this new window, under "System" variables, find the "Path" variable and open it by double click it or clicking the "Edit..." button
4. On this new window click the "New" button
5. In the textbox that appears enter the location you installed your java to. For example I installed it in "D:\JDKs\17", so I would put "D:\JDKs\17" in the text box.
6. Click the "OK" button on all of the previous 3 windows that opened.

Linux

Under Construction

MacOS

Under Construction

GlobalQuake

Download

Go to GlobalQuakes releases page and click the file named GlobalQuake_0.9.5.jar (the version number might be different). You might get an error saying this file could be dangerous or malicious, however this isn't the case, click the button that confirms you want to continue with download.

Installation

Move the jar file that you downloaded to the location you want it to be.
Keeping it in a folder is recommended for organisation as it will create a new folder with data in it.
If you do put it in a folder you can create a shortcut to the jar file for easier access.

Running

In Windows you can run it by simply double clicking the jar file, or in a Linux Distro (ie. Ubuntu) terminal or Windows command line by going to the directory it is located and using the command java -jar [filename].jar.

[!NOTE] You can add -Xms8G -Xmx8G parameters to specify the maximum amount of ram in gigabytes, replacing "8" with your own number. Experimental: You can also improve your FPS by adding the parameter -Dsun.java2d.opengl=True.

[!IMPORTANT] If you are using the ".jar" file on Windows, you have to "Unblock" it. (GitHub issue #279), to do that do the following, navigate to the file, right-click it, select Properties, check the "Unblock" checkbox under the General tab, then click Apply and OK to save the changes.

For example the full teminal or command line to start GlobalQuake (assuming you have already navigated to the appropriate folder) should look something like this:

[!TIP] This won't work as a shortcut [if your using a jar file] on windows.

Simple
$ java -jar GlobalQuake0.10.x_pre10.jar
or
With The Extra Variables Added (remember the instructions in the note above)
$ java -jar -Xms8G -Xmx8G -Dsun.java2d.opengl=true GlobalQuake0.10.x_pre10.jar

[!NOTE] ONLY work with the Minimum RAM needed as you can stall the system and cause a ton of complications by setting the -Xms_G and -Xmx_G numbers too high.
for instance if you have 8GB of RAM in you system the OS needs a minimum of 50% to work so the -Xms_G and -Xmx_G should not be higher than 4.
Examples -Xms4G -Xmx4G would be ideal to run GlobalQuake Locally with a total of 8GB of ram.