feat: implement async cache operations and file-based storage for Rs2CacheManager

  - Add async save/load operations (savePersistentCachesAsync, loadCachesAsync) using CompletableFuture
  - Implement file-based cache storage under .runelite/microbot-profiles to prevent profile bloat
  - Add cloud sync configuration option for optional RuneLite profile synchronization
  - Enhance CacheMetadata with data integrity checks and debugging information
  - Improve profile change handling with async operations and proper operation chaining
  - Add dedicated thread pool (cacheManagerExecutor) for cache persistence operations
  - Implement operation tracking to prevent concurrent save/load conflicts
  - Update skill level checks in PathfinderConfig to use cached values when available
  - Add graceful shutdown handling with timeout for ongoing cache operations
  - Improve error handling and logging throughout cache management system

Author: Voxsylvae

runelite-client/src/main/java/net/runelite/client/plugins/microbot/MicrobotConfig.java

@@ -34,6 +34,13 @@ public interface MicrobotConfig extends Config
 	)
 	String cacheSection = "cacheSection";
 
+	@ConfigSection(
+		name = "Cloud sync",
+		description = "Cache data synchronization settings",
+		position = 3
+	)
+	String cloudSyncSection = "cloudSyncSection";
+
 	String keyEnableGameChatLogging = "enableGameChatLogging";
 	@ConfigItem(
 		keyName = keyEnableGameChatLogging,
@@ -111,6 +118,18 @@ default boolean isRs2CacheEnabled() {
 		return false;
 	}
 
+	String keyEnableCacheCloudSync = "enableCacheCloudSync";
+	@ConfigItem(
+		keyName = keyEnableCacheCloudSync,
+		name = "Enable cache cloud sync",
+		description = "Sync cache data to RuneLite profile (compressed). This allows cache data to sync across devices but may increase profile size.",
+		position = 0,
+		section = cloudSyncSection
+	)
+	default boolean enableCacheCloudSync() {
+		return false;
+	}
+
 	@AllArgsConstructor
 	enum GameChatLogLevel {
 		ERROR("Error", Level.ERROR),

runelite-client/src/main/java/net/runelite/client/plugins/microbot/MicrobotPlugin.java

@@ -221,7 +221,9 @@ public void onRuneScapeProfileChanged(RuneScapeProfileChanged event)
 		{
 			log.info("\nReceived RuneScape profile change event from '{}' to '{}'", oldProfile, newProfile);
 			if (microbotConfig.isRs2CacheEnabled()) {
+				// Use async profile change to avoid blocking client thread
 				Rs2CacheManager.handleProfileChange(newProfile, oldProfile);
+				log.info("Initiated async profile change from '{}' to '{}'", oldProfile, newProfile);
 			}
 			return;
 		}
@@ -535,9 +537,17 @@ public void onGameTick(GameTick event)
 	@Subscribe(priority = 100)
 	private void onClientShutdown(ClientShutdown e)
 	{
-		// Save all caches through Rs2CacheManager
+		// Save all caches through Rs2CacheManager using async operations
 		if (microbotConfig.isRs2CacheEnabled()) {
-			Rs2CacheManager.savePersistentCaches();
+			try {
+				// Use async save but wait for completion during shutdown
+				Rs2CacheManager.savePersistentCachesAsync().get(30, java.util.concurrent.TimeUnit.SECONDS);
+				log.info("Successfully saved all caches asynchronously during shutdown");
+			} catch (Exception ex) {
+				log.error("Failed to save caches during shutdown: {}", ex.getMessage(), ex);
+				// Fallback to synchronous save if async fails
+				Rs2CacheManager.savePersistentCaches();
+			}
 			Rs2CacheManager.getInstance().close();
 		}
 	}

runelite-client/src/main/java/net/runelite/client/plugins/microbot/shortestpath/pathfinder/PathfinderConfig.java

@@ -24,7 +24,7 @@
 import net.runelite.client.plugins.microbot.util.poh.PohTeleports;
 import net.runelite.client.plugins.microbot.util.tabs.Rs2Tab;
 import net.runelite.client.plugins.microbot.util.walker.Rs2Walker;
-
+import net.runelite.client.plugins.microbot.util.cache.Rs2SkillCache;
 import java.util.*;
 import java.util.concurrent.ConcurrentHashMap;
 import java.util.concurrent.CopyOnWriteArrayList;
@@ -539,7 +539,13 @@ private boolean hasRequiredLevels(Transport transport) {
         Skill[] skills = Skill.values();
         return IntStream.range(0, requiredLevels.length)
             .filter(i -> requiredLevels[i] > 0)
-            .allMatch(i -> Microbot.getClient().getBoostedSkillLevel(skills[i]) >= requiredLevels[i]);
+            .allMatch(i -> {
+                if (Microbot.isRs2CacheEnabled()) {
+                    return Rs2SkillCache.getBoostedSkillLevel(skills[i]) >= requiredLevels[i];
+                } else {
+                    return Microbot.getClient().getBoostedSkillLevel(skills[i]) >= requiredLevels[i];
+                }
+            });
     }
 
     /** Checks if the player has all the required skill levels for the restriction */
@@ -548,7 +554,13 @@ private boolean hasRequiredLevels(Restriction restriction) {
         Skill[] skills = Skill.values();
         return IntStream.range(0, requiredLevels.length)
             .filter(i -> requiredLevels[i] > 0)
-            .allMatch(i -> Microbot.getClient().getBoostedSkillLevel(skills[i]) >= requiredLevels[i]);
+            .allMatch(i -> {
+                if (Microbot.isRs2CacheEnabled()) {
+                    return Rs2SkillCache.getBoostedSkillLevel(skills[i]) >= requiredLevels[i];
+                } else {
+                    return Microbot.getClient().getBoostedSkillLevel(skills[i]) >= requiredLevels[i];
+                }
+            });
     }
 
 	private void updateActionBasedOnQuestState(Transport transport) {

runelite-client/src/main/java/net/runelite/client/plugins/microbot/util/cache/Rs2Cache.java

@@ -577,10 +577,11 @@ public synchronized void invalidateAll() {
      * Gets the cache timestamp for a specific key.
      * 
      * @param key The key to get the timestamp for
-     * @return The timestamp when the key was cached, or null if not found
+     * @return The timestamp when the key was cached, or -1 if not found
      */
-    public Long getCacheTimestamp(K key) {
-        return cacheTimestamps.get(key);
+    public long getCacheTimestamp(K key) {
+        Long timestamp = cacheTimestamps.get(key);
+        return timestamp != null ? timestamp : 0L;
     }
 
     // ============================================