Downloading the Client

kraken-plugins.com is temporarily offline

Use the Discord bot to sign up, buy tokens, buy plugins, and view your license keys. Download the client directly: Windows · macOS

To download the Kraken client:

• Sign in to Kraken Plugins with discord
• Visit the "Download Client" page
• Select your operating system either Windows or Mac
• Click "Download Client"

You will receive one of two files:

• Windows: KrakenLauncher-Windows.zip. It unpacks to a KrakenLauncher folder containing KrakenInstaller.exe and a jre folder with a bundled Java 11 runtime.
• macOS: KrakenSetup.jar. You need Java 11 or newer installed to run it.

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. Kraken installs into your existing RuneLite installation, so install RuneLite first.

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.

Windows .exe (recommended method)

Unzip KrakenLauncher-Windows.zip, open the KrakenLauncher folder, and double-click KrakenInstaller.exe. Keep the exe inside that folder: it starts with the Java runtime in the jre folder next to it and will not run if you move the exe out on its own.

The installer downloads the latest KrakenSetup.jar into your RuneLite directory and configures RuneLite to load it. When it finishes, Kraken plugins will load alongside RuneLite.

Because the installer is not code signed, Windows SmartScreen may show "Windows protected your PC" the first time you run it. Click More info and then Run anyway.

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 launch4j.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. The Kraken launcher window will appear first; click Start RuneLite (see launcher options for what each setting does). 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 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. This needs Java 11 or newer installed. If double-clicking does nothing, run it from PowerShell with java -jar KrakenSetup.jar.

You should see the following dialog if the installation succeeded:

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://seaweed.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

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

4. Within the %localappdata%/RuneLite folder open up the config.json file in your text editor (like notepad) and replace it with the following:

{
  "classPath": [
    "RuneLite.jar",
    "KrakenSetup.jar"
  ],
  "mainClass": "com.kraken.launcher.Launcher",
  "vmArgs": [
    "-javaagent:KrakenSetup.jar",
    "--add-opens=java.base/java.net=ALL-UNNAMED",
    "--add-exports=java.base/java.net=ALL-UNNAMED",
    "--add-opens=java.base/java.lang.reflect=ALL-UNNAMED",
    "--add-exports=java.base/java.lang.reflect=ALL-UNNAMED",
    "--add-opens=java.base/java.lang=ALL-UNNAMED",
    "--add-exports=java.base/java.lang=ALL-UNNAMED",
    "--add-opens=java.base/jdk.internal.reflect=ALL-UNNAMED",
    "--add-exports=java.base/jdk.internal.reflect=ALL-UNNAMED",
    "-XX:+DisableAttachMechanism",
    "-Drunelite.launcher.nojvm=true",
    "-Drunelite.launcher.blacklistedDlls=RTSSHooks.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=1500"
  ]
}

5. 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 three core parts are KrakenSetup.jar on the classpath, com.kraken.launcher.Launcher as the main class, and the -javaagent plus --add-opens/--add-exports entries at the top of vmArgs. Without the --add-opens entries the launcher will warn you to re-run the installer on Java 16 or newer.

Mac

• Download the KrakenSetup.jar file from the website (or the direct link at the top of this page)
• Make sure Java 11 or newer is installed
• 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".
  • With your password the installer clears the quarantine flags on the app (xattr -cr /Applications/RuneLite.app) and re-signs the bundle locally (codesign --force --deep --sign - /Applications/RuneLite.app).
  • The installer 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

Launch RuneLite as normal through your Applications or the Jagex Launcher

What the Installer Changes

Everything Kraken changes lives in your RuneLite directory (%localappdata%\RuneLite on Windows, /Applications/RuneLite.app/Contents/Resources on macOS):

• KrakenSetup.jar is copied in.
• config.json: mainClass becomes com.kraken.launcher.Launcher, KrakenSetup.jar is added to classPath, and -javaagent:KrakenSetup.jar plus the --add-opens/--add-exports entries shown above are added to vmArgs (macOS also gets --add-opens/--add-exports for java.desktop/com.apple.eawt).
• settings.json: --disable-telemetry is appended to the client arguments.
• Both config.json and settings.json are marked read-only.

RuneLite itself is not modified. Kraken's own data (sign-in, plugins, logs, preferences) lives in ~/.runelite/kraken. See uninstalling for how to reverse all of this.

Next Steps

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