Making handy plugins for gamers and nerds!

Swobbles Sanctum

Plugins

**OSRS Tools is a real-time Old School RuneScape stat tracker for Stream Deck.**

By connecting directly to your RuneLite client, each Stream Deck key becomes a live performance dashboard for your character. Track XP gains, monitor efficiency, watch your level progress, and even keep an eye on your Hitpoints — all without leaving the game.

Perfect for long grinds, combat sessions, and streaming.

**Features**

**🧮 Live XP Tracking**

Buttons update instantly when XP is gained, showing real-time progress for the selected stat.

**📊 XP/Hour Monitoring**

Each button now displays your live XP per hour, helping you track efficiency and optimise your training.

**🗂 Session Tracking**

Monitor:

- Total XP gained this session
- XP gained in the last 10 seconds
Perfect for measuring consistency and short-term activity bursts.

**💍 Level Progress Ring**

The outer ring of each button acts as a visual progress bar toward your next level, giving instant feedback on how close you are to leveling up.

**🎨 Visual Activity Feedback**

Buttons change colour during XP drops so you can immediately see when a skill is active.

**✨ Level-Up Alerts**

A gold flash animation plays on the button whenever you level up the assigned skill.

**🔄 Rotating Stat Mode**

Track multiple stats on a single button.

- Automatically switches to the stat that most recently gained XP
- Manually cycle between selected stats by pressing the button
Ideal for compact Stream Deck layouts or multi-skill training.

**❤️ Hitpoints Tracking**

A dedicated Hitpoints option displays your current health.

- Background colour increases in redness as HP decreases
- Flashes when below 10% health to alert you in dangerous situations

**⚙️ Fully Automatic**

Once configured, everything runs hands-free with no manual refreshing required.

**🚀 Improved Performance**

- Async timer system for smoother, more responsive updates
- Optimised background handling
- Fixed high memory usage issue for improved long-session stability



**Installation**

**Stream Deck**
Install **OSRS Tools** from the Elgato Marketplace.

**RuneLite**
Install and enable the **HTTP API** plugin from the RuneLite Plugin Hub.

**Setup**

Open RuneLite and ensure the **HTTP API** plugin is enabled.

Open Stream Deck and drag an **OSRS Tools** action onto a key.

In the Property Inspector:

**Server URL**
Set this to localhost:8080 (same PC) or the IP address of the machine running RuneLite.

**Stat ID**
Select the skill you want to track on that button.

**Usage**

Once set up, simply play the game.

The button remains idle until XP is gained. When XP is detected, it automatically updates XP values, changes colour during activity, and plays a gold flash on level-up.

**Troubleshooting**

If buttons show “Offline” or do not update, check the following:

🛠 **HTTP API Port**
The default port is **8080**. If this was changed in RuneLite, update the Stream Deck Server URL accordingly (for example: localhost:8080).

🧱 **Firewall / Network**
If RuneLite and Stream Deck are running on different machines, ensure your firewall allows local network traffic.

⏳ **First XP Drop**
Buttons may remain idle until the first XP gain after launch. Gain a small amount of XP to initialise tracking.

🔄 **Updates**
Ensure RuneLite and the HTTP API plugin are fully up to date after OSRS updates.

**FAQ**

❓ **Can I track multiple skills at once?**
Yes. Add multiple OSRS Tools actions and assign a different skill to each key.

📱 **Does this work with OSRS Mobile?**
No. This plugin requires RuneLite and is desktop-only.

🛡 **Is this allowed by Jagex?**
Yes. OSRS Tools only reads data exposed by RuneLite’s API and does not interact with or control the game client.

✨ **My level-up didn’t flash gold**
Make sure the correct skill is assigned to that button. Level-up animations are skill-specific per key.