From d99e22b8c49c9c7c20905c421f037b1872158488 Mon Sep 17 00:00:00 2001
From: Jam <mysteriousjam@outlook.com>
Date: Wed, 22 Oct 2025 13:28:17 +0100
Subject: [PATCH] Added a new optional boolean function in Rs2Prayer.toggle
 that has "returnTab" of which the purpose is to do the original function and
 then return to the previous tab after the prayer is turned on. This will be
 useful for PvM purposes where staying on another tab is ideal for manual
 play, or otherwise.

---
 .../microbot/util/prayer/Rs2Prayer.java       | 33 +++++++++++++++++++
 1 file changed, 33 insertions(+)

diff --git a/runelite-client/src/main/java/net/runelite/client/plugins/microbot/util/prayer/Rs2Prayer.java b/runelite-client/src/main/java/net/runelite/client/plugins/microbot/util/prayer/Rs2Prayer.java
index f12ac73c16a..2fba3d6a260 100644
--- a/runelite-client/src/main/java/net/runelite/client/plugins/microbot/util/prayer/Rs2Prayer.java
+++ b/runelite-client/src/main/java/net/runelite/client/plugins/microbot/util/prayer/Rs2Prayer.java
@@ -74,6 +74,39 @@ public static boolean toggle(Rs2PrayerEnum prayer, boolean on, boolean withMouse
 		return sleepUntil(() -> isPrayerActive(prayer) == on, 10_000);
 	}
 
+	/**
+	 * Toggles a prayer to a specific state (on or off) with optional mouse control.
+	 * If using mouse, will automatically switch to the prayer tab if not already active.
+	 *
+	 * @param prayer the prayer to toggle
+	 * @param on true to enable the prayer, false to disable it
+	 * @param withMouse true to use mouse
+	 * @param returnTab true to return to the original Tab
+	 * @return true if the prayer is in the desired state after the operation, false otherwise
+	 */
+
+	public static boolean toggle(Rs2PrayerEnum prayer, boolean on, boolean withMouse, boolean returnTab) {
+		if (isOutOfPrayer()) return false;
+		if (isPrayerActive(prayer) == on) return true;
+
+		InterfaceTab tab = null;
+		tab = Rs2Tab.getCurrentTab();
+
+		if (withMouse && tab != InterfaceTab.PRAYER) {
+			Rs2Tab.switchTo(InterfaceTab.PRAYER);
+		}
+
+		invokePrayer(prayer, withMouse);
+
+		boolean toggleResult = sleepUntil(() -> isPrayerActive(prayer) == on, 10_000);
+
+		if (withMouse && returnTab && tab != null && Rs2Tab.getCurrentTab() != tab) {
+			Rs2Tab.switchTo(tab);
+		}
+
+		return toggleResult;
+	}
+
 	/**
 	 * Invokes a prayer action
 	 * Creates a menu entry and executes it with the appropriate bounds.