Skip to content

Repository files navigation

Guard_dog_resize

Watchdog

Plugin Hub Discord

ko-fi

Create custom in-game alerts triggered by specific events, each firing one or more configurable actions. For full documentation, see the wiki.

Alerts

Alert What it watches
Game Message System/server messages in the chat box
Player Chat Message Messages from other players
Overhead Text Text displayed above NPCs or players
Stat Changed Skill level changes (boosts, drains, thresholds)
XP Drop Receiving XP in a chosen skill
Sound Fired A specific in-game sound effect plays
Spawned Object An object, NPC, item, or player spawns or despawns
Inventory Inventory full/empty, slot count, or item quantity
Location Player is within range of a world coordinate
Notification Fired Any RuneLite plugin fires a system notification

Many alert types support glob patterns and regex with capture groups for dynamic action messages.

Actions

You can set defaults for actions in the plugin config.

Text

Action What it does
Game Message Writes a colored message into your chat box
Overhead Text Displays text above your player character
Tray Notification Sends an OS desktop notification
Plugin Message Sends a message event to another RuneLite plugin
Notification Event Fires a RuneLite NotificationFired event

Audio

Action What it does
In-Game Sound Effect Plays a built-in OSRS sound by ID
Custom Sound Plays a local .wav or .mp3 file
Text to Speech Synthesizes speech via Eleven Labs or legacy TTS

Visual

Action What it does
Screen Flash Flashes the game screen a custom color
Overlay Displays a text banner on screen
Popup Shows a popup styled like a collection log entry
Screen Marker Draws a rectangle marker on a 2D screen region
Object Marker Highlights a world object or tile in-game
Dismiss Overlay Dismisses a sticky Overlay, Screen Marker, or Object Marker

Advanced

Action What it does
Counter Increments a persistent counter
Alert Toggle Enables, disables, or toggles another alert
Plugin Toggle Enables, disables, or toggles a RuneLite plugin
Request Focus Brings the RuneLite window to the foreground
Dink Sends a Discord webhook via the Dink plugin
Shortest Path Sets or clears a route in the Shortest Path plugin

Disabled Areas

Watchdog is automatically disabled in the following areas (updated 2026/07/01):

Alchemical Hydra Vardorvis Leviathan Whisperer
Sucellus Vorkath Inferno Fight Cave
Colosseum Kalphite Queen COX TOB
TOA Yama Delve Boss (Doom of Mokhaiotl) Nightmare
Muspah Maggot King

Recommended RuneLite Notification Settings

image

Set Request Focus to Off to avoid incorrect behavior with background notifications.

Examples

Attack Drained Example Harvest Example

Alert Hub

Add alerts shared by other users directly from the panel. See the alert hub branch to learn how to upload your own.

image

More Info

Attribution

This project uses the JACo MP3 Player to play mp3 files. Its source is available on SourceForge and is licensed under LGPL (ThirdPartyLicenses.txt).

About

Custom notification plugin for RuneLite

Topics

Resources

Stars

20 stars

Watchers

2 watching

Forks

Releases

Sponsor this project

Used by

Contributors

Languages