Knight Launcher

Open source game launcher for Spiral Knights. Supports user-friendly Java configuration, Discord integration, easier modding & much more.

---

Features

• Install and uninstall game mods in an easy and noob-friendly way without worrying about game updates.
• Jump into several editors to create custom user-generated content or simply preview game models.
• Intuitive and user-friendly UI for configuring advanced Java settings.
• Re-install and verify your game files with ease.
• Discord integration that shows your current game activity on your Discord status. This feature is only available on Windows.
• Launch alt accounts with lesser resources assigned to them avoiding losing performance on your main instance.
• Future-proofed to support third party servers. Third party server support will not be enabled while Grey Havens' Official servers are still online, unless explicitly permitted by their respective right owners and/or law.
• And more...

Downloading & Installing

1. Prerequisites:

   • Java installed.
     • Windows: You can get the Java installer from here.
     • macOS: Java is already installed by default.
     • Linux: Open your terminal and run any of these to install Java, depending on your package manager: apt install default-jre, yum install java, pacman -S jre-openjdk, apk add openjdk8.

2. Download the latest Knight Launcher release ZIP file here.

3. Extract the downloaded KnightLauncher-x.x.x.zip ZIP file to your Spiral Knights directory (x.x.x will vary depending on the current version).

   • Windows:
     • Steam: Steam installations can be found by right-clicking the game on your Steam library and selecting "Manage" → "Browse Local Files," you can also look for it at <Your Steam Folder>\steamapps\common\Spiral Knights.
     • Standalone: Standalone installations can be found by first right-clicking the Spiral Knights shortcut on your desktop, clicking "Open File Location," and once you're there you must enter the app folder. You can also look for it at <Your User Folder>\AppData\Local\Spiral Knights\app
   • macOS:
     • Steam: Steam installations can be found by right-clicking the game on your Steam library and then selecting "Manage" → "Browse Local Files". This is where you must extract the zip file you downloaded earlier.
     • Standalone: Standalone installations can be found by searching "Spiral Knights" in Applications, then right click on the result and select "Show in Finder", finally right click the "Spiral Knights" Application file and select "Show Package Contents". Once you're there, enter the Contents folder and then the app folder. This is where you must extract the zip file you downloaded earlier.
   • Linux:
     • Steam: Steam installations can be found by right-clicking the game on your Steam library and selecting "Manage" → "Browse Local Files".
     • Standalone: There's no standalone download for Linux, you must download the game through Steam. Once that's done, follow the instructions above to install the launcher via Steam on Linux, and you'll be able to set your platform as standalone in the launcher's settings.

4. Double-click the KnightLauncher.jar JAR file. The launcher should now boot up.

5. If nothing happens, double-click the KnightLauncher_windows.bat file or KnightLauncher_mac_linux.sh file depending on your operating system.

Warning

For macOS users: If a window pops up displaying "macOS cannot verify that this app is free from malware" click on "Done", then go to your System Settings → Privacy & Security, scroll to the very bottom of this panel, and where it says "KnightLauncher.jar was blocked to protect your Mac." click on "Open Anyway", then "Open Anyway" again on the pop up message that appears afterwards, and finally verify using Touch ID or your user's password. This should prevent the first pop up from appearing again.

Note

Bear in mind that the installation locations listed above are the defaults for their respective operating systems, however your mileage may vary if you've installed the game in a custom folder.

Still not working? Open a thread in Discord's tech support channel so the community can help you.

Updating

The launcher is capable of auto-updating itself given the option is enabled in the launcher's settings, which will be by default. To manually update, follow these steps:

1. Download the latest Knight Launcher release ZIP file here.
2. Extract the downloaded ZIP file to your Spiral Knights folder, the same way you did when installing it for the first time. Guidance on finding your game folder can be found above at "Downloading & Installing."

After following those steps, the launcher will be up to date.

Building From Source

To build Knight Launcher follow these steps:

1. Prerequisites
   • Java 8 JDK installed.
   • Maven installed:
     • Windows: Download the ZIP from the link above, extract, then add bin/ to your PATH.
     • macOS (Homebrew): brew install maven.
     • Linux (APT): apt install maven.
   • Git installed:
     • Windows: Download the installer from git-scm.com and follow the setup.
     • macOS (Homebrew): brew install git.
     • Linux (APT): apt install git.
2. Clone the repository.
   • git clone https://github.com/lucasluqui/KnightLauncher.git
3. Copy projectx-pcode.jar from your Spiral Knights code directory into the project's lib directory.
4. Create a copy of deploy.properties.template in the repository's root directory then remove the .template extension. Fill any missing values.
5. Validate all Maven dependencies.
   • mvn validate
6. Build the package using Maven. By default, it will build for a development environment, you can target prod instead by adding -Denv=prod.
   • mvn clean package
   • mvn -Denv=prod clean package
7. Copy the package built by Maven to your Spiral Knights folder and run it.
   • java -jar KnightLauncher.jar

Discord

We've built an amazing community on Discord focused on both helping newcomers get along with the launcher and giving a hand to modders, come join us!

https://discord.gg/RAf499a

---

Credits

Unless hyperlinked names shown below represent Discord usernames. Hyperlinked names correspond to GitHub accounts.

Contributors

Translators

Translators are credited in their respective language file, click here to browse.

Thank you all for helping to make Knight Launcher usable for everyone worldwide!

QA/Testing

• Nurr, yihleego, Bidoknight, Carpvindra, Mushspore, CafuneAndChill, Xan, analarmingalarm, parma, loonadra, ultrongr, milliath, Puzovoz, Stret, 3xample, top_platinum, Criptobeta.

Third Party Libraries

The following open source libraries are used by Knight Launcher:

• Guava
• Guice
• Apache Commons IO
• Apache Commons Text
• Image4J
• Zip4J
• flatlaf
• discord-rpc
• mslinks
• org.json
• jIconFont
• samskivert
• JHLabs Filters
• OSHI