Skip to content

lucasluqui/KnightLauncher

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Knight Launcher

GitHub license GitHub issues GitHub stars

Total downloads Discord

Open source game launcher for Spiral Knights. Supports automatic 64-bit Java VM installation, Discord integration, easier modding & much more.

ko-fi


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.
  • Automatically patch your game to use a 64-bit Java VM to improve the game's performance.
  • Re-install and verify your game files with ease.
  • Intuitive and user-friendly UI for configuring advanced Java VM settings.
  • 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 right-clicking the Spiral Knights shortcut on your desktop and then clicking "Open File Location," you can also look for it at <Your User Folder>\AppData\LocalLow\spiral.
    • macOS:
      • Steam: Steam installations can be found by right-clicking the game on your Steam library, selecting "Manage" → "Browse Local Files," then right click the "Spiral Knights" application file and select "Show Package Contents". Once this is done, browse to Contents/Resources/Java. 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", and browse to Contents/Resources/Java. This is where you must extract the zip file you downloaded earlier.
    • Linux:
      • Steam: Steam installations are not natively supported, but the launcher will still call Steam and launch through Proton if you place Knight Launcher's JAR file in the game's directory.
      • Standalone: Standalone installations are found at your user's home folder then .getdown/spiral.

Note

Bear in mind that those are the usual installation locations, your mileage may vary.

  1. Double-click the KnightLauncher.jar JAR file. The launcher should now boot up.
    • 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.
  2. If nothing happens, double-click the KnightLauncher_windows.bat file or KnightLauncher_mac_linux.sh file depending on your operating system.

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 manually, 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:

About

Open source game launcher for Spiral Knights.

Topics

Resources

License

Stars

Watchers

Forks

Sponsor this project

Contributors 11