Mob Check is an intelligent, high-performance PvM Priority Prayer Helper plugin for the RuneLite client. Built specifically for high-intensity PvM encounters—such as The Inferno, Fortis Colosseum, Tormented Demons, Phantom Muspah, and Dagannoth Kings—Mob Check calculates and displays the exact server ticks remaining before incoming NPC attacks hit the player, helping you execute flawless prayer timing and 1-tick prayer flicks with complete confidence.
- Visual Overhead Indicator: Displays the required protection prayer icon (Magic, Missiles / Range, Melee) and remaining tick count directly above your character.
- Tick Progress Arc: Renders a smooth circular countdown progress ring around the overhead prayer sprite showing the travel progression of incoming projectiles from launch to impact.
-
Dynamic Urgency Color-Coding:
- 🟢 Green: Correct protection prayer is active.
- ⚪ White / Style Color: Safe countdown period (
$> \text{warning threshold}$ ). - 🔴 Red: Urgent impact threshold (
$\le \text{warning threshold}$ , default$1\text{t}$ ) when prayer is not active.
-
Active Prayer Status Border:
- 🟢 Solid Green Outline: Correct protection prayer is currently active.
- 🔴 Pulsing Red Border & Flash: Unprotected or wrong prayer active with an attack landing within the warning threshold (default
$\le 1\text{t}$ ). - 🔵 Style-Coded Outline: Highlights the required prayer when safe (
$> \text{warning threshold}$ ).
- On-Widget Tick Counter: Renders the exact tick countdown directly over the corresponding prayer button in your Prayer Tab for fast, focused clicking without looking away from your inventory/prayers.
- Flashes a high-visibility red danger border across the game screen when an attack is within the warning threshold (default
$\le 1\text{t}$ ) and the player is not protected, giving you an instantaneous visual reflex cue.
- Model Hull Outline: Highlights the 3D model convex hull of whichever monster is actively attacking you, color-coded by attack style (Cyan for Magic, Green for Range, Orange for Melee).
-
Server-Side Ground True Tile: Highlights the actual server tile location using
npc.getWorldLocation(). Supports multi-tile boss scaling (e.g.,$3\times3$ bosses like Sol Heredit, General Graardor, Dagannoth Rex). - On-NPC Tick Timer: Displays the attack countdown number above the attacking NPC's head.
-
Style-Specific Sounds: Plays customizable sound effect IDs when the priority prayer style changes (defaults match official prayer activation sounds: Magic
2675, Range2677, Melee2676). -
Suppression When Protected: Optional setting (
Only Alert When Unprotected) to suppress priority style-switch audio cues if you already have the correct protection prayer activated. -
Emergency Wrong Prayer Buzzer: Plays an emergency warning sound (Default ID:
2277) when an attack is within the configured warning threshold (default$\le 1$ tick) without the correct protection active.
- Sidebar Info Box: Displays up to 4 upcoming attacks ordered by impact tick (with deterministic 4-tier threat weighting tie-breaking), showing prayer sprites, remaining ticks, and interactive hover tooltips displaying the attacking NPC name and required prayer style.
- Manticore 3-Hit Combo Visualizer: Explicitly highlights rapid multi-hit combo cycles during Fortis Colosseum encounters.
| Encounter / Category | Monster | Attack Styles & Mechanics Tracked | Projectile / Anim IDs |
|---|---|---|---|
| The Inferno | Jal-Ak (Blob) | Magic projectile, Ranged projectile, Melee bite | Proj: 1380 (M), 1378 (R)Anim: 7582 (Melee) |
| Jal-AkRek (Mini-Blobs) | Magic and Ranged spit projectiles | Proj: 1381 (M), 1379 (R) |
|
| Jal-MejRah (Bat) | Ranged projectile & attack animation | Proj: 1382 (R)Anim: 7578 (Melee) |
|
| Jal-Xil (Ranger) | Ranged boulder projectile & melee punch | Proj: 1376 (R)Anim: 7604 (Melee) |
|
| Jal-Zek (Mage) | Magic blast projectile & melee punch | Proj: 1374 (M)Anim: 7612 (Melee) |
|
| Jal-ImKot (Meleer) | Melee dig & swing animation | Anim: 7597 (Melee) |
|
| JalTok-Jad | Magic fireball, Ranged boulder, Melee slam | Proj: 448 (M), 449 (R)Anim: 7590 (Melee) |
|
| Fortis Colosseum | Manticore | 3-hit rapid sequence (Magic & Ranged projectiles) | Proj: 2687 (M), 2688 (R) |
| Serpent Shaman | Magic venom projectile | Proj: 2685 (M) |
|
| Javelinic Colossus | Heavy Ranged javelin projectile | Proj: 2686 (R) |
|
| Jaguar Warrior | Fast Melee blade attack | Anim: 10871 (Melee) |
|
| Minotaur | Melee club smash | Anim: 10872 (Melee) |
|
| Fremennik Warband | Archer projectile, Seer spell, Berserker axe (Region-gated) | Proj: 15 (R), 160 (M)Anim: 10873 (Melee) |
|
| Shockwave Colossus | Melee shockwave slam | Anim: 10874 (Melee) |
|
| Sol Heredit | Sun projectile, Melee attacks, sweeps, and slams | Proj: 2689 (M)Anim: 10875, 10876, 10877 |
|
| Tormented Demons | Tormented Demon | Magic skull, Ranged spike, Melee claw attack | Proj: 1885 (M), 1884 (R)Anim: 10922 (Melee) |
| Phantom Muspah | Phantom Muspah | Corruption Magic wave, Ranged spikes, Melee swipes | Proj: 2329 (M), 2330 (R)Anim: 9920, 9922 (Melee) |
| Dagannoth Kings | Dagannoth Prime | Water Wave magic projectile (Region-gated to DK Lair) | Proj: 162 (M) |
| Dagannoth Supreme | Spine throw ranged projectiles | Proj: 475 (R), 476 (R) |
|
| Dagannoth Rex | Melee claw swipes | Anim: 2853, 2851 (Melee) |
|
| Additional Bosses | Zulrah | Magic venom spit & Ranged dart projectiles | Proj: 1044 (M), 1046 (R) |
| Vorkath | Dragonfire Magic & Ranged dragonfire blast | Proj: 1481 (M), 1483 (R) |
|
| Cerberus | Magic fire, Ranged blast, Melee triple attack | Proj: 1243 (M), 1244 (R)Anim: 4492 (Melee) |
|
| Alchemical Hydra | Lightning Magic & Poison Ranged projectiles | Proj: 1663 (M), 1662 (R) |
|
| Hunllef (Gauntlet) | Magic orb & Ranged crystal projectiles | Proj: 1707 (M), 1708 (R) |
|
| Demonic Gorillas | Boulder / orb projectiles & Melee sweep | Proj: 1302 (M), 1304 (R)Anim: 7226 (Melee) |
|
| God Wars Dungeon | Zilyana (Magic 1220, Melee 2t 6964), Graardor (Melee 6t 7060), K'ril (Magic 1211, Melee 6t 6948) |
Proj: 1220, 1211Anim: 6964, 7060, 6948 |
|
| Slayer Monsters | Abyssal Demons & Bloodvelds | Melee attack animations | Anim: 2309, 1552 |
Inside the RuneLite Configuration Panel under Mob Check, the following options can be customized:
| Section | Setting | Default | Description |
|---|---|---|---|
| Overhead & HUD | Show Overhead Icon |
true |
Renders the required prayer icon and tick countdown directly above your player character. |
Show Tick Progress Arc |
true |
Draws a smooth circular countdown progress ring around the overhead prayer sprite. | |
Warning Threshold |
1 |
Remaining tick count at which visual elements turn red for immediate urgency. | |
| Prayer Book Highlights | Highlight Prayer Button |
true |
Highlights the required protection prayer directly in the Prayer Tab interface. |
Show Ticks on Prayer Button |
true |
Displays remaining ticks directly over the prayer button in the Prayer Tab. | |
Flash Wrong Prayer |
true |
Pulses a bright red border & fill over the required prayer button when unprotected within the warning threshold. | |
| Danger & Warnings | Flash Screen on Wrong Prayer |
true |
Flashes a red screen border if unprotected when an incoming attack is within the warning threshold. |
Danger Flash Color |
Red (Alpha 70) |
Color and transparency for the emergency screen flash border. | |
| Audio Alerts | Play Sound Alert |
true |
Plays an audio cue when the priority prayer style switches. |
Only Alert When Unprotected |
false |
Suppresses priority-change sound cues when the required protection prayer is already active. | |
Magic Sound ID |
2675 |
Sound effect ID played when Magic protection is required. | |
Range Sound ID |
2677 |
Sound effect ID played when Range protection is required. | |
Melee Sound ID |
2676 |
Sound effect ID played when Melee protection is required. | |
Wrong Prayer Emergency Sound |
true |
Plays an emergency sound warning if unprotected within the configured warning threshold. | |
Wrong Prayer Sound ID |
2277 |
Sound effect ID used for the wrong prayer emergency warning. | |
| NPC Threat & World | Highlight Attacking NPC |
true |
Outlines the 3D model convex hull of the monster currently attacking you. |
Highlight NPC True Tile |
true |
Draws the ground true tile of the attacking NPC (supporting multi-tile sizes). | |
| Info Box & Sequences | Show Info Box |
true |
Displays the upcoming threat queue in a side overlay panel. |
Show Manticore/Combo Sequence |
true |
Highlights rapid combo sequences (e.g. Manticore 3-hit cycles) in order. | |
Track Unknown Projectiles |
false |
Fallback mode to Pray Magic for unrecognized projectiles targeting the player. |
-
Per-Tick Cache Synchronization:
- The attack list is rebuilt once per game tick inside
onGameTick()viabuildActiveAttacks()and cached incachedAttacks. - All visual overlays (
MobCheckOverlay,MobCheckHudOverlay,MobCheckPrayerWidgetOverlay,MobCheckWorldOverlay) consume this cached snapshot, guaranteeing zero mid-frame tearing or coordinate drift across rendering layers.
- The attack list is rebuilt once per game tick inside
-
Coordinate-Space Isolation (
MobCheckHudOverlay):- Isolates dynamic canvas-space HUD indicators (
OverlayPosition.DYNAMIC,OverlayLayer.ABOVE_WIDGETS)—including the player overhead prayer icon, countdown progress ring, and full-screen red danger flash—from draggable sidebar panels. - Prevents
Alt-drag or snap-corner canvas translations onMobCheckOverlay(OverlayPosition.TOP_LEFT) from displacing the player overhead icon or screen border.
- Isolates dynamic canvas-space HUD indicators (
-
Deterministic 4-Tier Threat Priority:
- Incoming attacks are sorted by flight/impact ticks ascending (
ticks). - Same-tick collisions are resolved deterministically using a 4-tier threat weighting hierarchy (
THREAT_CRITICAL (4) > THREAT_HIGH (3) > THREAT_MEDIUM (2) > THREAT_LOW (1)) applied across both projectiles and melee animations. - Ensures fatal boss hits (e.g. JalTok-Jad, Sol Heredit, Jal-Zek, Alchemical Hydra, General Graardor) always take precedence over chip-damage threats (e.g. Jal-MejRah bats, Jal-AkRek mini-blobs), matching standard Inferno and Colosseum PvM prayer flicking hierarchies.
- Incoming attacks are sorted by flight/impact ticks ascending (
-
Interactive Hover Tooltips via
TooltipManager:- The draggable sidebar Info Box (
MobCheckOverlay) integrates with RuneLite'sTooltipManagerto display the attacking NPC name and required prayer style on mouse hover. - Tooltips are rendered without allocations on unhovered frames, preserving 60–144 FPS render loop performance.
- The draggable sidebar Info Box (
-
Deterministic Projectile Cycle Conversion:
- Projectile flight duration is converted from client engine cycles into game ticks using
(remainingCycles + 29) / 30. - The initial tick count is cached on first sight keyed by
System.identityHashCode(projectile)to drive the overhead progress arc accurately.
- Projectile flight duration is converted from client engine cycles into game ticks using
-
Region-Gated Projectile Verification:
- Generic engine projectile IDs (e.g. standard arrows
15and elemental spells160in the Colosseum, or Water Wave162in Dagannoth Kings Lair) are strictly gated by player map region (client.getMapRegions()) to prevent false positives across the wider game world.
- Generic engine projectile IDs (e.g. standard arrows
-
Melee Attack Lifecycle:
- Tracked via
AnimationChangedkeyed byNPC.getIndex()in aLinkedHashMapfor deterministic iteration. - Decremented on each game tick and preserved until
ticks < 0so the$0\text{t}$ impact tick remains visible to the player during the decisive tick.
- Tracked via
-
Server-Side True Tile Calculation:
- Calculated with
LocalPoint.fromWorld(client, npc.getWorldLocation())rather than visual interpolated coordinates. Multi-tile NPCs are rendered viaPerspective.getCanvasTileAreaPoly(client, lp, npcSize)usingnpc.getComposition().getSize().
- Calculated with
-
Modern
gamevalType Safety:- Uses official constants from
net.runelite.api.gameval.InterfaceID.Prayerbookandnet.runelite.api.gameval.SpriteID.Prayeron, eliminating hardcoded widget child IDs and deprecated sprite references.
- Uses official constants from
- Java 11 through Java 23 (Gradle 8.10 wrapper included).
- Make sure
JAVA_HOMEpoints to a compatible JDK (JDK 11 or JDK 17 recommended):export JAVA_HOME=$(/usr/libexec/java_home -v 11) # macOS # or export JAVA_HOME=/path/to/jdk-11
| Command | Description |
|---|---|
./gradlew test |
Runs the full unit test suite (65+ unit tests covering all bosses, overlays, and edge cases). |
./gradlew build |
Compiles the plugin classes and generates the distribution archive. |
./gradlew shadowJar |
Builds a standalone shaded JAR including all runtime dependencies. |
./gradlew run |
Launches a live development RuneLite client with the Mob Check plugin pre-injected. |
This repository includes a built-in Model Context Protocol (MCP) server (.agents/plugins/runelite-osrs-docs/) that provides LLM assistants and developer tooling with live indexed access to:
- RuneLite API Javadocs: Classes, interfaces, methods, fields, events, constants, and widget hierarchies.
- Old School RuneScape Wiki: Monster mechanics, combat stats, projectile IDs, animation IDs, and tick timings.
cd .agents/plugins/runelite-osrs-docs
npm testThis project is open-source software licensed under the BSD 2-Clause License. See LICENSE for details.