Getting Started

RuneLite

The official, unmodified RuneLite client. Download it from runelite.net. No custom fork, no modified launcher — just the RuneLite you already use.

Your license key

Received via email after purchase (delivered by Lemon Squeezy). Check spam if you can't find it.

Java

RuneLite handles Java for you — no separate install needed.

Step 1 — Download your plugin

After purchase, you'll receive a download link for a single JAR file — e.g., pluginscape-farmrun.jar. That's it. Everything the plugin needs is bundled inside.

Step 2 — Open RuneLite's sideload panel

1. Launch RuneLite
2. Click the wrench icon (Configuration) in the right sidebar
3. Click Plugin Hub at the top
4. Click the folder icon in the top-right corner of the Plugin Hub panel — this opens the sideload file picker

Step 3 — Load the JAR

Select your pluginscape-<plugin-name>.jar file. It'll appear in your plugin list immediately — no restart required.

Step 4 — Activate your license

On first launch, the plugin will prompt you to enter your license key. Paste the key from your purchase email. The plugin validates against Pluginscape's server and binds to your machine's hardware ID (HWID).

Step 5 — Configure and run

Once activated, the plugin appears in RuneLite's sidebar. Click it to open the configuration panel, adjust settings to your preference, and enable it.

Plugin not showing up after loading

Check that you're using the latest version of RuneLite (not a fork or outdated build). Restart RuneLite if the plugin doesn't appear after sideloading. Make sure you selected the correct .jar file from your downloads.

"License invalid" or "Activation failed"

Double-check that you're pasting the full license key with no extra spaces. Your license is HWID-locked — if you've changed hardware (new PC, new OS install), open a support ticket on Discord to get your HWID reset. If the license server is unreachable, check your internet connection. Plugins cache validation locally after the first activation.

Plugin stopped working after a game update

OSRS game updates can change internal IDs that plugins rely on. We push compatibility patches as fast as possible — usually within 24–48 hours. Check the #announcements channel on Discord for patch status. Don't panic if a plugin errors on update day.

Can I use Pluginscape alongside Plugin Hub plugins?

Yes. Pluginscape plugins coexist with any Plugin Hub or other sideloaded plugins. They don't interfere with each other.

Can I run multiple Pluginscape plugins at once?

Yes. Each plugin is a self-contained JAR and operates independently. They can run simultaneously within the same RuneLite session.