quest-helper: sync to version 4.10.0+ (commit 55396262)

README.md

@@ -20,6 +20,32 @@ If you have any questions, please join our [Discord](https://discord.gg/zaGrfqFE
 
 If you enjoy my open source work and would like to support me, consider buying me a coffee! Your support helps me stay caffeinated and motivated to keep improving and creating awesome projects.
 
+## Quest Helper Integration
+
+The integrated Quest Helper works together with other plugins to give a nice unified experience while questing.
+
+### Not Enough Runes
+
+If you have the [Not Enough Runes](https://runelite.net/plugin-hub/show/not-enough-runes) plugin installed, you can
+right-click item requirements and click `Go to NER...` to look that item up in Not Enough Runes.
+
+![Not Enough Runes context menu](./images/not-enough-runes-01.png)
+
+### Shortest Path
+
+If you have the [Shortest Path](https://runelite.net/plugin-hub/show/shortest-path) plugin installed, you can enable the
+the "Use 'Shortest Path' plugin" in the Quest Helper config.
+
+![](./images/shortest-path-01.png)
+
+Next time you start a quest, the Shortest Path plugin will help you take the shortest path to the destination.
+
+![Shortest Path path overlay example](./images/shortest-path-02.png)
+
+You can configure what teleportation methods, or the aesthetic of the path in the Shortest Path config.
+
+## Help and discussion
+
 [![Buy Me a Coffee](https://img.shields.io/badge/Buy%20Me%20a%20Coffee-donate-yellow)](https://www.paypal.com/paypalme/MicrobotBE?country.x=BE)
 
 

runelite-client/src/main/java/net/runelite/client/plugins/microbot/questhelper/.quest-helper-sync

@@ -0,0 +1,51 @@
+# Quest Helper Sync Tracking File
+# This file tracks the last synchronized commit from the external quest-helper repository
+# 
+# External Repository: https://github.com/Zoinkwiz/quest-helper
+# Local Integration: runelite-client/src/main/java/net/runelite/client/plugins/microbot/questhelper/
+#
+# IMPORTANT: Do not manually edit this file unless you know what you're doing.
+# Use the quest-helper update scripts to manage synchronization.
+
+# Current sync position - this is the last external commit that has been integrated
+5539626281a502ba8c44fe59b8b57bce32fe4f16
+
+# Sync metadata (for script reference)
+# External repo HEAD at last check: 5539626281a502ba8c44fe59b8b57bce32fe4f16
+# Last sync date: 2025-08-29
+# Sync method: automated script with manual package transformation
+# Integration branch: quest-helper-update-20250829_063754
+# Local commit: cb416ef02a (quest-helper: polish Enakhras Lament)
+
+# Sync history log:
+# 2025-08-29 07:14:46 - Applied commit 55396262 (Polish enahkras lament #2294)
+#   - Enhanced EnakhrasLament.java with better code organization
+#   - Fixed Shadow Room brazier puzzle sequence and locations
+#   - Added missing chisel icon for cutOffLimb step
+#   - Files changed: 1 Java file, +359/-204 lines
+#   - Package transformation: com.questhelper -> net.runelite.client.plugins.microbot.questhelper
+#   - Status: SUCCESS
+#
+# 2025-08-28 16:35:20 - Complete sync to version 4.10.0
+#   - Applied 76 patches successfully from external repository
+#   - Skipped 4 patches (build files, CI workflows not applicable to Microbot)
+#   - Base sync point: 6329d81ee15a07a4b4fb53217bd4305e978c7a0e
+#   - Status: SUCCESS
+#
+# 2025-08-28 16:28:12 - Partial sync (first 4 patches)
+#   - Initial automated sync setup and testing
+#   - Applied commits d2df892a..4c204e89
+#   - Status: SUCCESS
+#
+# 2025-08-28 16:13:45 - Initial sync tracking setup
+#   - Created sync file and established tracking
+#   - Method: manual setup
+#   - Status: INITIALIZED
+
+# Integration status
+# Current external version: 4.10.0+
+# Integration health: HEALTHY  
+# Last validation: 2025-08-29
+# Compilation status: SUCCESS
+# Package transformation: COMPLETE
+# Sync file location: CORRECT (moved from project root)

runelite-client/src/main/java/net/runelite/client/plugins/microbot/questhelper/QuestHelperConfig.java

@@ -534,6 +534,17 @@ default boolean showWidgetHints()
 	)
 	default boolean solvePuzzles() { return true; }
 
+	@ConfigItem(
+		keyName = "showWorldMapPoint",
+		name = "Display world map point",
+		description = "Choose whether the arrow & icon of your current step should be visible on the world map.<br>Changing this will take effect next time your quest step updates.",
+		section = hintsSection
+	)
+	default boolean showWorldMapPoint()
+	{
+		return true;
+	}
+
 	@ConfigItem(
 			keyName = "useShortestPath",
 			name = "Use 'Shortest Path' plugin",
@@ -681,4 +692,24 @@ default boolean showCompletedQuests()
 	{
 		return false;
 	}
+
+	@ConfigSection(
+		position = 5,
+		name = "Development",
+		description = "Options that configure the quest helper development experience",
+		closedByDefault = true
+	)
+	String developmentSection = "developmentSection";
+
+	@ConfigItem(
+		keyName = "devShowOverlayOnLaunch",
+		name = "Show overlay on launch",
+		description = "Show the dev overlay (::questhelperdebug) on launch",
+		position = 4,
+		section = developmentSection
+	)
+	default boolean devShowOverlayOnLaunch()
+	{
+		return false;
+	}
 }

runelite-client/src/main/java/net/runelite/client/plugins/microbot/questhelper/QuestHelperPlugin.java

@@ -71,6 +71,7 @@
 import net.runelite.client.util.Text;
 import org.apache.commons.lang3.ArrayUtils;
 
+import javax.annotation.Nullable;
 import javax.inject.Inject;
 import javax.inject.Named;
 import javax.swing.*;
@@ -198,6 +199,14 @@ protected void startUp() throws IOException
 
 		questOverlayManager.startUp();
 
+		if (developerMode)
+		{
+			if (config.devShowOverlayOnLaunch())
+			{
+				questOverlayManager.addDebugOverlay();
+			}
+		}
+
 		final BufferedImage icon = Icon.QUEST_ICON.getImage();
 
 		panel = new QuestHelperPanel(this, questManager, configManager);
@@ -229,6 +238,11 @@ protected void shutDown()
 		eventBus.unregister(playerStateManager);
 		eventBus.unregister(runeliteObjectManager);
 		eventBus.unregister(worldMapAreaManager);
+		if (developerMode)
+		{
+			// We don't check if it was added, since removing an unadded overlay is a no-op
+			questOverlayManager.removeDebugOverlay();
+		}
 		questOverlayManager.shutDown();
 		playerStateManager.shutDown();
 
@@ -409,6 +423,18 @@ public void onConfigChanged(ConfigChanged event)
 				questManager.getSelectedQuest().setSidebarOrder(loadSidebarOrder(questManager.getSelectedQuest()));
 			}
 		}
+
+		if (developerMode && "devShowOverlayOnLaunch".equals(event.getKey()))
+		{
+			if (config.devShowOverlayOnLaunch())
+			{
+				questOverlayManager.addDebugOverlay();
+			}
+			else
+			{
+				questOverlayManager.removeDebugOverlay();
+			}
+		}
 	}
 
 	@Subscribe
@@ -462,7 +488,7 @@ public List<BankTabItems> getPluginBankTagItemsForSections()
 		return questBankManager.getBankTagService().getPluginBankTagItemsForSections(false);
 	}
 
-	public QuestHelper getSelectedQuest()
+	public @Nullable QuestHelper getSelectedQuest()
 	{
 		return questManager.getSelectedQuest();
 	}

runelite-client/src/main/java/net/runelite/client/plugins/microbot/questhelper/collections/ItemCollections.java

@@ -170,6 +170,7 @@ public enum ItemCollections
 	SAW("Saw", ImmutableList.of(
 		ItemID.POH_SAW,
 		ItemID.WEARABLE_SAW,
+		ItemID.WEARABLE_SAW_OFFHAND,
 		ItemID.EYEGLO_CRYSTAL_SAW
 	)),
 
@@ -485,7 +486,14 @@ public enum ItemCollections
 		ItemID._4DOSEPRAYERRESTORE,
 		ItemID._3DOSEPRAYERRESTORE,
 		ItemID._2DOSEPRAYERRESTORE,
-		ItemID._1DOSEPRAYERRESTORE
+		ItemID._1DOSEPRAYERRESTORE,
+		ItemID._4DOSE2RESTORE,
+		ItemID._3DOSE2RESTORE,
+		ItemID._2DOSE2RESTORE,
+		ItemID._1DOSE2RESTORE,
+		ItemID.HUNTER_MIX_MOONMOTH_2DOSE,
+		ItemID.HUNTER_MIX_MOONMOTH_1DOSE,
+		ItemID.BUTTERFLY_JAR_MOONMOTH
 	)),
 
 	RESTORE_POTIONS(ImmutableList.of(
@@ -1218,17 +1226,16 @@ public enum ItemCollections
 		ItemID.DRAMEN_STAFF
 	)),
 
-	ESSENCE_LOW(ImmutableList.of(
-		ItemID.BLANKRUNE_DAEYALT,
-		ItemID.BLANKRUNE_HIGH,
-		ItemID.BLANKRUNE
-	)),
-
 	ESSENCE_HIGH(ImmutableList.of(
 		ItemID.BLANKRUNE_DAEYALT,
 		ItemID.BLANKRUNE_HIGH
 	)),
 
+	ESSENCE_LOW(new ImmutableList.Builder<Integer>()
+			.addAll(ESSENCE_HIGH.items).add(
+			ItemID.BLANKRUNE).build()
+	),
+
 	COINS(ImmutableList.of(
 		ItemID.COINS,
 		ItemID.MAGICTRAINING_COINS,

runelite-client/src/main/java/net/runelite/client/plugins/microbot/questhelper/helpers/achievementdiaries/ardougne/ArdougneHard.java

@@ -184,16 +184,20 @@ protected void setupRequirements()
 		crystalTrink = new ItemRequirement("Crystal Trinket", ItemID.MOURNING_CRYSTAL_TRINKET).showConditioned(notDeathRune).isNotConsumed();
 		highEss = new ItemRequirement("Pure or Daeyalt essence", ItemCollections.ESSENCE_HIGH)
 			.showConditioned(notDeathRune);
-		newKey = new KeyringRequirement("New key", configManager, KeyringCollection.NEW_KEY).showConditioned(notDeathRune).isNotConsumed();
+
+		var hasCompletedSOTE = new QuestRequirement(QuestHelperQuest.SONG_OF_THE_ELVES, QuestState.FINISHED);
+
+		newKey = new KeyringRequirement("New key", configManager, KeyringCollection.NEW_KEY).showConditioned(notDeathRune).isNotConsumed().hideConditioned(hasCompletedSOTE);
 		newKey.setTooltip("Another can be found on the desk in the south-east room of the Mourner HQ basement.");
-		mournerBoots = new ItemRequirement("Mourner boots", ItemID.MOURNING_MOURNER_BOOTS).isNotConsumed();
-		gasMask = new ItemRequirement("Gas mask", ItemID.GASMASK).isNotConsumed();
-		mournerGloves = new ItemRequirement("Mourner gloves", ItemID.MOURNING_MOURNER_GLOVES).isNotConsumed();
-		mournerCloak = new ItemRequirement("Mourner cloak", ItemID.MOURNING_MOURNER_CLOAK).isNotConsumed();
-		mournerTop = new ItemRequirement("Mourner top", ItemID.MOURNING_MOURNER_TOP).isNotConsumed();
-		mournerTrousers = new ItemRequirement("Mourner trousers", ItemID.MOURNING_MOURNER_LEGS).isNotConsumed();
+
+		mournerBoots = new ItemRequirement("Mourner boots", ItemID.MOURNING_MOURNER_BOOTS).isNotConsumed().hideConditioned(hasCompletedSOTE);
+		gasMask = new ItemRequirement("Gas mask", ItemID.GASMASK).isNotConsumed().hideConditioned(hasCompletedSOTE);
+		mournerGloves = new ItemRequirement("Mourner gloves", ItemID.MOURNING_MOURNER_GLOVES).isNotConsumed().hideConditioned(hasCompletedSOTE);
+		mournerCloak = new ItemRequirement("Mourner cloak", ItemID.MOURNING_MOURNER_CLOAK).isNotConsumed().hideConditioned(hasCompletedSOTE);
+		mournerTop = new ItemRequirement("Mourner top", ItemID.MOURNING_MOURNER_TOP).isNotConsumed().hideConditioned(hasCompletedSOTE);
+		mournerTrousers = new ItemRequirement("Mourner trousers", ItemID.MOURNING_MOURNER_LEGS).isNotConsumed().hideConditioned(hasCompletedSOTE);
 		mournersOutfit = new ItemRequirements("Full mourners' outfit", gasMask, mournerTop, mournerTrousers,
-			mournerCloak, mournerBoots, mournerGloves).showConditioned(notDeathRune).isNotConsumed();
+			mournerCloak, mournerBoots, mournerGloves).showConditioned(notDeathRune).isNotConsumed().hideConditioned(hasCompletedSOTE);
 		mournersOutfit.setTooltip("Another set can be obtained at the north entrance to Arandar.");
 		rake = new ItemRequirement("Rake", ItemID.RAKE)
 			.showConditioned(new Conditions(LogicType.OR, notPalmTree, notPoisonIvy)).isNotConsumed();

runelite-client/src/main/java/net/runelite/client/plugins/microbot/questhelper/helpers/miniquests/barbariantraining/BarbarianTraining.java

@@ -667,7 +667,8 @@ public List<ItemRequirement> getItemRequirements()
 			bow, oakLogs, tinderbox, axe,
 			feathers, knife,
 			hammer, bronzeBar.quantity(2), logs.quantity(3),
-			attackPotion, roe);
+			attackPotion, roe,
+			antifireShield, combatGear);
 	}
 
 	@Override
@@ -676,6 +677,12 @@ public List<ItemRequirement> getItemRecommended()
 		return Arrays.asList(gamesNecklace.quantity(5), catherbyTeleport);
 	}
 
+	@Override
+	public List<String> getCombatRequirements()
+	{
+		return Collections.singletonList("Mithril Dragon (level 304)");
+	}
+
 	@Override
 	public List<String> getNotes()
 	{