Getting Started with Blert
This guide will walk you through the steps to get Blert running in RuneLite and start recording your first challenge.
Step 1: Download the Blert Plugin
Download the Blert plugin from the RuneLite Plugin Hub.
Step 2: Create a Blert Account
If you don't already have a Blert account, sign up here. Your Blert username doesn't have to be the same as your OSRS account. Verify your email address to ensure you don't lose access to your account.
Step 3: Request API Key Access
Open your Linked Accounts page and click the
Generate Linking Code button under the Discord section. Copy the
generated code, then run the /verify <code> command in
Blert's Discord.
Once your Discord account is linked, ping a @Support asking for API key access.
Step 4: Generate Your API Key
- Once you have API key access, go to the API Keys page.
- Enter your OSRS username in the Generate new API key section and click Generate API Key.
- Copy the generated key using the copy icon.
Step 5: Enter the Key in RuneLite
- Open RuneLite and go to the Blert plugin settings.
- Paste your API key into the Blert API Key field.
- Close the settings tab and you're done!
You can confirm the plugin is connected by clicking the Bloat icon in your RuneLite sidebar. If everything is working, you'll see your username and connection status listed at the top of the plugin panel.
Step 6: Record Your First PvM Challenge
You're now ready to start recording! Enter any PvM challenge like the Theatre of Blood or Inferno and Blert will automatically detect your run and begin tracking data.
Troubleshooting
Invalid API Key
- Double-check that you copied the full key.
- Ensure the key is associated with the OSRS name you're logged into.
- If needed, regenerate the key from the API Keys page.
No Data Uploading
- Open the plugin sidebar and confirm you see your username connected.
- Ensure the raid was properly started (e.g. not in a lobby).
- Data is processed at the end of challenge stages (e.g. rooms/waves), so if you're still in the middle of one, you won't see anything.
- If you were spectating a raid and left early, it won't be displayed.
No Permission to Generate Key
- You haven't been granted API access yet.
- Link your Discord account and ping @Support in Discord to request access.