TODO

• [Web API]: Implement a way to have the Achievement logic in the Games Launcher and only gain achievements in the game itself. But also don't update the launcher if new achievements are added to games.

Installation:

Windows:
To run the Launcher program, Java version 21 is required. If it is not already installed, it can be downloaded from here: https://www.oracle.com/de/java/technologies/downloads/#jdk21-windows

MacOS:
To run the Launcher program on MacOS, Java version 21 with a dedicated JavaFX installation is required. If either is not available, it can be downloaded from here: https://www.azul.com/downloads/?version=java-21-lts&os=macos&package=jdk-fx#zulu. Macs with an M1, M2, M3 etc. chip must be downloaded the ARM version, all other variants require the x86 variant.

(Optional) To check which Java version is installed, open the terminal (e.g. CMD, PowerShell and co.) and enter the command java -version. If something like Java version "21.0.3" is returned, Java 21 is installed.

Workaround: If an error appears when you double-click on the jar file or nothing opens, you must paste the following line into Terminal:
java -jar <path to jar>. Replace <path to jar> with the path to the jar file, for that you can drag and drop the jar file into the terminal window.

General

The Games Launcher is a GUI for launching specific games. These games can be downloaded from a server all via the Launcher.

The Games Launcher also serves a Library for basic functions which the games can build upon.

You can place your own games inside the "games" folder, but they need to be a runnable .jar file. Currently, the file must also be named like an existing game, otherwise the launcher would not start.

Issues

The Launcher is stuck at the Starting/Splash Screen

• Ensure that you have no unknown games int the Folder
• Find the latest log file in the "logs" folder and check for errors

The Launcher does not start a game. Instead, sending an error message.

• Check if you accidentally renamed the Game Launcher Jar file. It must be named "GamesLauncher.jar" alternatively you can select the renamed file in the launchers settings.
• If you are in an IDE you must export the runnable jar file and select it in the Launcher settings.
• Check the latest log file in the "logs" folder for more information.