Instructions for Installation

Watch a tutorial video to learn how to install or read the instructions below.

FAQ

What are binaries and assets?
The binaries are the executable code of the game and the most frequently updated, it contains the game's logic and instructions. The assets contain the game's artwork, models, music, data, etc. Both are required to play.

I notice there is a primary release and a test release, which install do I want?
Most players will want to install the test release located at the bottom of the page as this will have the latest bug fixes and newest features and is updated the most often. Just keep in mind this is also usually the buggiest and most likely to crash. If you want a slightly more stable client, get the primary release instead. Most servers run the latest test release. Note that sometimes the test release and primary release are sometimes the same - in which case only the primary release will be listed.

Is Jedi Academy required to play?
Jedi Academy must be installed first before you can play.

Which linux distributions are available?
A debian based distribution compiled for ubuntu is available. You may also build the source code yourself to run it on distributions not provided here.

Is macOS available?
Mac builds are not supported at this time. The game will likely compile for macOS if you wish to build the source code yourself, but we have not tested it since OSX.

Do I need the map packs?
The default game comes with only one map, it is highly recommended you install the map packs as well, however you can still technically play with only one map. Most JKG servers use several maps and you will need them installed to play on these servers. Additional maps also provide a much richer experience, and you'll make our level designers sad if you don't try them all out!

My antivirus says JKG is a virus. Is it?
No. Because Jedi Knight Galaxies is frequently updated, some antivirus vendors may flag it as suspicious. We try to expose new releases to several antivirus vendors shortly after release to help mitigate this, but some vendors are paranoid and notorious for incorrectly identifying legitimate software for malware. If you would like a 2nd opinion, feel free to upload it to Virus Total to have it scanned by major antivirus vendors.

Where can I get more information about the game?
Check out our FAQ page.

Instructions

After ensuring Jedi Academy is installed, and downloading the binaries and assets for your operating system you are ready to install. These instructions are also available in the readme provided with each release.

First, navigate to your Jedi Academy install's GameData folder. The GameData folder is typically in the following location if you have Steam: SteamLibrary\steamapps\common\Jedi Academy\GameData. Other types of installs will have a similar location.

Then from the downloaded zip binary, drag and drop the jkgalaxies directory (the one the readme is alongside) into Jedi Academy's GameData folder. If you have a previous installation of JKG, just replace the jkgalaxies directory with the one in the zip (if you have a really old version of JKG, you'll likely want to just install from scratch). Your directory structure should look like this when installed:

[Loading...]

Now that you have created the jkgalaxies folder and placed the binaries inside, you will need to add the assets as well. Unzip the contents of the assets zip downloaded and copy the contents (everything inside the folder that contains the readme) into the JKG folder located inside the jkgalaxies folder.

Launching the Game

On Windows:
In order to play the game, use the 'Run JKGalaxies.bat' file (which lies in jkgalaxies) by double clicking it. If your game starts without a blue cursor you most likely installed it wrong (the game is not seeing the Gamedata directory for JKA), you can also edit the batch file if you'd prefer to install it elsewhere from the directions above (but you're on your own if you do!).

On Linux:
In order to play the game, use the 'runjkg.sh' script in the terminal.
You will need to make sure you have the necessary dependencies (SDL, libpng, ...) to run the game.

Stuck?

Need help installing? Watch this tutorial video first.
Still stuck? Join our Discord and check out the #helpdesk channel.