Toggle for tracking

Author: AdiPrk

ReplayTimerMod/src/GhostSettings.cs

@@ -18,8 +18,16 @@ public static class GhostSettings
 
         // ── Init ──────────────────────────────────────────────────────────────
 
+        private static ConfigEntry<bool>? _trackingEnabled;
+
         public static void Init(ConfigFile config)
         {
+            _trackingEnabled = config.Bind(
+                section: "Mod",
+                key: "TrackingEnabled",
+                defaultValue: true,
+                description: "Master switch. When false, no rooms are recorded and no PBs are updated.");
+
             _ghostEnabled = config.Bind(
                 section: "Ghost",
                 key: "Enabled",
@@ -57,7 +65,12 @@ public static void Init(ConfigFile config)
 
         // ── Properties ────────────────────────────────────────────────────────
         // Fall back to hardcoded defaults when Init() hasn't been called yet
-        // (e.g. in unit-test contexts or before Awake).
+
+        public static bool TrackingEnabled
+        {
+            get => _trackingEnabled?.Value ?? true;
+            set { if (_trackingEnabled != null) _trackingEnabled.Value = value; }
+        }
 
         public static bool GhostEnabled
         {

ReplayTimerMod/src/PBManager.cs

@@ -33,6 +33,14 @@ public static void Init()
             return pb;
         }
 
+        // Returns true if the given time would be stored by Evaluate() - i.e.
+        // it's either the first run for this key or faster than the existing PB.
+        public static bool WouldBePB(RoomKey key, float time)
+        {
+            if (!pbs.TryGetValue(key, out var existing)) return true; // first run
+            return time < existing.TotalTime;
+        }
+
         // ── Evaluate (called after a live run) ────────────────────────────────
 
         public static EvaluationResult Evaluate(RecordedRoom run)

ReplayTimerMod/src/ReplayTimerModPlugin.cs

@@ -61,6 +61,13 @@ private void OnSceneChanged(Scene from, Scene to)
 
         private void OnRoomEnter(string sceneName, string entryFromScene)
         {
+            if (!GhostSettings.TrackingEnabled)
+            {
+                // Start playback, but don't record
+                ghostPlayback.StartPlayback(sceneName, entryFromScene);
+                return;
+            }
+
             frameRecorder.StartRecording();
             ghostPlayback.StartPlayback(sceneName, entryFromScene);
         }
@@ -70,13 +77,30 @@ private void OnRoomExit(string sceneName, string entryFromScene,
         {
             ghostPlayback.StopPlayback();
 
+            if (!GhostSettings.TrackingEnabled)
+            {
+                frameRecorder.DiscardRecording();
+                return;
+            }
+
             RoomKey key = new RoomKey(sceneName, entryFromScene, exitToScene);
-            RecordedRoom? recording = frameRecorder.FinishRecording(key, lrTime);
 
-            if (recording != null)
+            // Check before calling FinishRecording so we don't pay the cost of
+            // frames.ToArray() (up to ~25KB) on every missed attempt. For a
+            // speedrunner retrying the same room hundreds of times this avoids
+            // GC pressure that would otherwise cause periodic hitches.
+            if (PBManager.WouldBePB(key, lrTime))
+            {
+                RecordedRoom? recording = frameRecorder.FinishRecording(key, lrTime);
+                if (recording != null)
+                {
+                    PBManager.Evaluate(recording);
+                    replayUI.OnPBUpdated();
+                }
+            }
+            else
             {
-                EvaluationResult result = PBManager.Evaluate(recording);
-                replayUI.OnPBUpdated();
+                frameRecorder.DiscardRecording();
             }
         }
 

ReplayTimerMod/src/UI/ReplayUI.Actions.cs

@@ -274,6 +274,19 @@ private void ResetJumpFeedback()
 
         // ── Ghost settings ────────────────────────────────────────────────────
 
+        private void OnTrackingToggle()
+        {
+            GhostSettings.TrackingEnabled = !GhostSettings.TrackingEnabled;
+            if (trackingToggleLbl == null) return;
+            bool on = GhostSettings.TrackingEnabled;
+            trackingToggleLbl.text = on ? "ON" : "OFF";
+            trackingToggleLbl.color = on ? UIStyle.Accent : UIStyle.Red;
+            if (trackingToggleBtnImg != null)
+                trackingToggleBtnImg.color = on
+                    ? UIStyle.Accent with { a = 0.22f }
+                    : UIStyle.Red with { a = 0.22f };
+        }
+
         private void OnGhostToggle()
         {
             GhostSettings.GhostEnabled = !GhostSettings.GhostEnabled;

ReplayTimerMod/src/UI/ReplayUI.Build.cs

@@ -203,7 +203,7 @@ private void BuildRightSubHeader(int bodyY)
                 x: M, w: statusX - M, h: SUBHDR);
         }
 
-        // ── Settings strip: Ghost [ON/OFF] | Alpha [-] 0.40 [+] | Color ■■■■■■
+        // ── Settings strip: Tracking [ON/OFF] | Ghost [ON/OFF] | Alpha [-] 0.40 [+] | Color ■■■■■■
         private void BuildSettingsBar()
         {
             var bar = MakeGO("SettingsBar", panelGO!.transform);
@@ -216,6 +216,27 @@ private void BuildSettingsBar()
             int stepW = UIStyle.W(22);
             int x = M;
 
+            // Tracking: [ON/OFF] - master switch for recording
+            int trackLblW = UIStyle.W(52);
+            MakeLbl(bar.transform, "Tracking:", UIStyle.FontSizeSm - 1,
+                UIStyle.Subtext, TextAnchor.MiddleLeft, x: x, y: 0, w: trackLblW, h: STGSH);
+            x += trackLblW + M / 2;
+
+            var trackingBtn = MakeGO("TrackingToggle", bar.transform);
+            Img(trackingBtn, GhostSettings.TrackingEnabled
+                ? UIStyle.Accent with { a = 0.22f }
+                : UIStyle.Red with { a = 0.22f });
+            Btn(trackingBtn, OnTrackingToggle);
+            Rect(trackingBtn, x, btnY, UIStyle.W(46), btnH);
+            trackingToggleLbl = MakeLbl(trackingBtn.transform,
+                GhostSettings.TrackingEnabled ? "ON" : "OFF", UIStyle.FontSizeSm - 1,
+                GhostSettings.TrackingEnabled ? UIStyle.Accent : UIStyle.Red,
+                TextAnchor.MiddleCenter, fill: true);
+            trackingToggleBtnImg = trackingBtn.GetComponent<Image>();
+            x += UIStyle.W(46);
+
+            x = BarSeparator(bar.transform, x, btnY, btnH);
+
             // Ghost: [ON/OFF]
             MakeLbl(bar.transform, "Ghost:", UIStyle.FontSizeSm - 1,
                 UIStyle.Subtext, TextAnchor.MiddleLeft, x: x, y: 0, w: lblW, h: STGSH);

ReplayTimerMod/src/UI/ReplayUI.cs

@@ -42,6 +42,8 @@ public partial class ReplayUI
         // Set by OnPBUpdated() whenever a new PB is recorded
         private bool rebuildPending = false;
 
+        private bool wasPaused = false;
+
         // Two-click confirm for the global clear-all button.
         private bool clearAllPending = false;
         private Image? clearAllBtnImg;
@@ -83,6 +85,8 @@ public partial class ReplayUI
         // ── Settings strip live refs ──────────────────────────────────────────
         private Text? ghostToggleLbl;
         private Text? alphaLbl;
+        private Text? trackingToggleLbl;
+        private Image? trackingToggleBtnImg;
 
         // ─────────────────────────────────────────────────────────────────────
         // SETUP
@@ -128,16 +132,25 @@ public void Tick()
             if (!isSetup) return;
 
             bool paused = IsPaused();
-            canvasGO!.SetActive(paused);
 
-            if (!paused)
+            if (paused && !wasPaused)
             {
+                canvasGO!.SetActive(true);
+                tabGO!.SetActive(true);
+                wasPaused = true;
+            }
+
+            if (!paused && wasPaused)
+            {
+                canvasGO!.SetActive(false);
                 expanded = false;
                 ResetClearAllConfirm();
+                wasPaused = false;
                 return;
             }
 
-            tabGO!.SetActive(true);
+            if (!paused) return;
+
             panelGO!.SetActive(expanded);
 
             if (expanded && rebuildPending)