Kraken Plugins

Appearance

Downloading the Client ​

To download the Kraken client:

dl-client

Installation ​

The following sections will walk you through installing the client on your computer so you can launch Old School RuneScape and use the Kraken plugins.

Windows ​

Windows has three ways you can install the client:

  1. .exe (easiest and recommended)
  2. .jar (backup in case of issues)
  3. Manual Install (if all else goes wrong)

The following sections detail each installation method.

If you are on Windows, unzip the downloaded file from the Kraken Plugins download page and double-click the executable (.exe) file that was downloaded and run through the installation process to install the client to your RuneLite directory. The installer will take care of setting everything up for you, and Kraken plugins will now load alongside RuneLite.

installer-success

Note: If you run into issues installing via the .exe try running from the command line (PowerShell) and adding the --l4j-debug option to show debug logs for the executable. I.e. .\KrakenInstaller.exe --l4j-debug and cat launc4j.log to see system information relating to running the executable.

You can launch RuneLite as you normally would through either the Jagex Launcher or Desktop Icon. You should see the small green Kraken logo show up in your sidebar indicating your plugins are loaded and ready to be used (after logging into the client with discord and entering your license keys).

windows-install

Windows Jar File (backup method) ​

If you encounter issues with the .exe installation method. You can install it via the JAR file by simply double-clicking on it. The JAR file is executable so you can run it the same way as you would the .exe file to install the Kraken client.

You should see the following dialog if the installation succeeded:

installer-success

Windows Manual ​

The manual method of installation is the most complex, however, if you cannot install any other way this will work.

  1. Start by downloading the JAR file directly from https://minio.kraken-plugins.com/kraken-bootstrap-static/KrakenSetup.jar
  2. Open the local RuneLite directory on your machine by hitting the Windows key and typing: "Run". Enter the text: %localappdata%/RuneLite and hit enter

local-runelite-dir

  1. Copy the KrakenSetup.jar file from your downloads folder to the %localappdata%/RuneLite folder. It should look like this:

kraken-setup-jar

  1. Within the %localappdata%/RuneLite folder open up the config.json file in your text editor (like notepad) and replace it with the following:
json
{
  "classPath": [
    "RuneLite.jar",
    "KrakenSetup.jar"
  ],
  "mainClass": "com.kraken.launcher.Launcher",
  "vmArgs": [
    "-javaagent:KrakenSetup.jar",
    "-XX:+DisableAttachMechanism",
    "-Drunelite.launcher.nojvm\u003dtrue",
    "-Drunelite.launcher.blacklistedDlls\u003dRTSSHooks.dll,RTSSHooks64.dll,NahimicOSD.dll,NahimicMSIOSD.dll,Nahimic2OSD.dll,Nahimic2DevProps.dll,k_fps32.dll,k_fps64.dll,SS2DevProps.dll,SS2OSD.dll,GTIII-OSD64-GL.dll,GTIII-OSD64-VK.dll,GTIII-OSD64.dll",
    "-Xmx768m",
    "-Xss2m",
    "-XX:CompileThreshold\u003d1500"
  ]
}
  1. Save the config.json file and close.

⚠️ Note: If you have previously modified your config.json file to change JVM properties or the RuneLite classpath you will need to merge the Kraken changes in with your changes. The two core parts are the KrakenSetup.jar file being on the classpath and com.kraken.launcher.Launcher being the main class.

Mac ​

  • Download the KrakenSetup.jar file from the website
  • Double-click the JAR file to start the launcher installation process
  • Sometimes macOS security may warn you about unidentified developer apps
    • Open System Preferences > Security & Privacy > General Tab
    • Click "Open Anyway" or "Allow Anyway"
  • The launcher will prompt you for your MacOS password or TouchID.
    • This is required because during Krakens installation it modifies RuneLite.app's bundle (config.json and adding KrakenSetup.jar) therefore, invalidating the code signature causing GateKeeper to immediately mark RuneLite as corrupted and "not runnable".
    • The command being run (and launcher) is fully open source and you can view it here if you have any questions or concerns.
  • Your Kraken launcher will be installed, and you should see a popup message

installer-success

Launch RuneLite as normal through your Applications or the Jagex Launcher

Next Steps ​

See our configuration document for information on how to sign in to the client, load, and configure your plugins!