Release v0.6.4

Author: pardeike

1.6/Assemblies/RimBridgeServer.Contracts.dll

@@ -6,7 +6,7 @@
     <li>1.6</li>
   </supportedVersions>
   <packageId>brrainz.rimbridgeserver</packageId>
-  <modVersion>0.6.3</modVersion>
+  <modVersion>0.6.4</modVersion>
   <url>https://github.com/pardeike/RimBridgeServer</url>
   <description>RimBridgeServer spins up an MCP server inside RimWorld to enable automated, remote control of a running game. It is designed so AI agents or external tools can rapidly test and validate the mods they are developing by issuing commands and querying state through a stable protocol.
 

1.6/Assemblies/RimBridgeServer.Core.dll

@@ -1,7 +1,7 @@
 <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
 <Manifest>
   <identifier>net.pardeike.rimworld.mod.rimbridgeserver</identifier>
-  <version>0.6.3</version>
+  <version>0.6.4</version>
   <targetVersions>
     <li>1.6.0</li>
   </targetVersions>

1.6/Assemblies/RimBridgeServer.Extensions.Abstractions.dll

@@ -3,7 +3,7 @@
         <ModName>RimBridgeServer</ModName>
         <ModFileName>RimBridgeServer</ModFileName>
         <Repository>https://github.com/pardeike/RimBridgeServer</Repository>
-        <ModVersion>0.6.3</ModVersion>
+        <ModVersion>0.6.4</ModVersion>
         <ProjectGuid>{6A41B185-4CC6-43FD-A4D3-5D2819F4DC96}</ProjectGuid>
     </PropertyGroup>
 </Project>

1.6/Assemblies/RimBridgeServer.dll

@@ -161,6 +161,7 @@ Lua authoring note: `rimbridge/run_lua` is intentionally a lowered Lua subset, n
 
 - `rimworld/pause_game` - Pause or unpause the game
 - `rimworld/set_time_speed` - Set RimWorld's current time speed directly
+- `rimworld/play_for` - Unpause the current game at a requested time speed for a bounded real-time duration, then pause it again, ending early if the game is paused, returns to the main menu, or the session changes
 - `rimworld/list_debug_action_roots` - List top-level RimWorld debug action roots using stable internal debug-action paths
 - `rimworld/list_debug_action_children` - List direct children of a RimWorld debug action path
 - `rimworld/search_debug_actions` - Search the full RimWorld debug-action tree globally by path, label, category, and source metadata so callers do not need to walk one subtree at a time

About/About.xml

@@ -303,6 +303,7 @@ private static CapabilityExecutionKind ResolveExecutionKind(string toolName)
             "rimworld/start_debug_game" => CapabilityExecutionKind.LongEventBound,
             "rimworld/load_game" => CapabilityExecutionKind.LongEventBound,
             "rimworld/switch_language" => CapabilityExecutionKind.LongEventBound,
+            "rimworld/play_for" => CapabilityExecutionKind.BackgroundObserved,
             "rimworld/take_screenshot" => CapabilityExecutionKind.BackgroundObserved,
             "rimworld/frame_cell_rect" => CapabilityExecutionKind.BackgroundObserved,
             "rimworld/screenshot_cell_rect" => CapabilityExecutionKind.BackgroundObserved,

About/Manifest.xml

@@ -1,6 +1,8 @@
 using System;
+using System.Diagnostics;
 using System.IO;
 using System.Linq;
+using RimBridgeServer.Core;
 using RimWorld;
 using UnityEngine;
 using Verse;
@@ -63,6 +65,94 @@ public object SetTimeSpeed(string speed = "Normal")
         };
     }
 
+    public object PlayFor(int durationMs, string speed = "Normal", int pollIntervalMs = 25)
+    {
+        if (durationMs <= 0)
+        {
+            return new
+            {
+                success = false,
+                message = "durationMs must be greater than 0.",
+                state = RimWorldState.ToolStateSnapshot()
+            };
+        }
+
+        if (pollIntervalMs < 0)
+        {
+            return new
+            {
+                success = false,
+                message = "pollIntervalMs cannot be negative.",
+                state = RimWorldState.ToolStateSnapshot()
+            };
+        }
+
+        if (Enum.TryParse<TimeSpeed>(speed, ignoreCase: true, out var parsedSpeed) == false)
+        {
+            return new
+            {
+                success = false,
+                message = $"Unknown time speed '{speed}'. Supported values: Normal, Fast, Superfast, Ultrafast.",
+                state = RimWorldState.ToolStateSnapshot()
+            };
+        }
+
+        if (parsedSpeed == TimeSpeed.Paused)
+        {
+            return new
+            {
+                success = false,
+                message = "play_for requires an active play speed. Use Normal, Fast, Superfast, or Ultrafast.",
+                state = RimWorldState.ToolStateSnapshot()
+            };
+        }
+
+        try
+        {
+            Stopwatch stopwatch = null;
+            var controller = new TimedPlaybackController();
+            var result = controller.PlayFor(
+                durationMs,
+                pollIntervalMs,
+                getElapsedMs: () => stopwatch?.ElapsedMilliseconds ?? 0L,
+                readState: () => RimBridgeMainThread.Invoke(CapturePlaybackState, timeoutMs: 5000),
+                startPlayback: () => RimBridgeMainThread.Invoke(() =>
+                {
+                    stopwatch = Stopwatch.StartNew();
+                    EnsurePlaybackRunning(parsedSpeed);
+                }, timeoutMs: 5000),
+                pausePlayback: () => RimBridgeMainThread.Invoke(PauseIfNeeded, timeoutMs: 5000));
+
+            return new
+            {
+                success = result.Success,
+                requestedDurationMs = durationMs,
+                elapsedMs = result.ElapsedMs,
+                pollIntervalMs,
+                timeSpeed = parsedSpeed.ToString(),
+                paused = result.PausedAtEnd,
+                initiallyPaused = result.InitiallyPaused,
+                startTick = result.StartTick,
+                endTick = result.EndTick,
+                advancedTicks = result.AdvancedTicks,
+                attempts = result.Attempts,
+                probeFailureCount = result.ProbeFailureCount,
+                lastProbeError = string.IsNullOrWhiteSpace(result.LastProbeError) ? null : result.LastProbeError,
+                message = result.Message,
+                state = result.Snapshot
+            };
+        }
+        catch (Exception ex)
+        {
+            return new
+            {
+                success = false,
+                message = $"Failed to play for {durationMs}ms: {ex.Message}",
+                state = RimWorldState.ToolStateSnapshot()
+            };
+        }
+    }
+
     public object StartDebugGame()
     {
         if (LongEventHandler.AnyEventNowOrWaiting)
@@ -247,4 +337,46 @@ public object LoadGame(string saveName)
             state = RimWorldState.ToolStateSnapshot()
         };
     }
+
+    private static TimedPlaybackState CapturePlaybackState()
+    {
+        var hasPlayableGame = Current.ProgramState == ProgramState.Playing
+            && Current.Game != null
+            && Find.TickManager != null;
+        var hasLongEvent = LongEventHandler.AnyEventNowOrWaiting;
+        var atMainMenu = GenScene.InEntryScene || Current.ProgramState == ProgramState.Entry;
+
+        return new TimedPlaybackState
+        {
+            Available = hasPlayableGame && !hasLongEvent,
+            Paused = hasPlayableGame && Find.TickManager.Paused,
+            TickCount = hasPlayableGame ? Find.TickManager.TicksGame : 0,
+            SessionToken = Current.Game,
+            Snapshot = RimWorldState.ToolStateSnapshot(),
+            Message = hasPlayableGame
+                ? (hasLongEvent ? "RimWorld is busy with a long event." : string.Empty)
+                : (atMainMenu ? "RimWorld returned to the main menu." : "No playable game is currently loaded.")
+        };
+    }
+
+    private static void EnsurePlaybackRunning(TimeSpeed speed)
+    {
+        if (Current.ProgramState != ProgramState.Playing || Current.Game == null || Find.TickManager == null)
+            throw new InvalidOperationException("No playable game is currently loaded.");
+        if (LongEventHandler.AnyEventNowOrWaiting)
+            throw new InvalidOperationException("RimWorld is busy with a long event.");
+
+        Find.TickManager.CurTimeSpeed = speed;
+        if (Find.TickManager.Paused)
+            Find.TickManager.TogglePaused();
+    }
+
+    private static void PauseIfNeeded()
+    {
+        if (Current.Game == null || Find.TickManager == null)
+            return;
+
+        if (!Find.TickManager.Paused)
+            Find.TickManager.TogglePaused();
+    }
 }