[+] 给一键重试和练习模式添加onlyInFreedomMode选项 (#134)

* [+][OneKeyRetryEnd] 添加一个选项，开启后，只有自由模式且时间未耗尽时才允许一键重开。
适配于窝的需求，防止利用一键重开“霸机”的情况。

* [R][PracticeMode] 从UI层把开关暂停的代码，抽取出一个方法来，以便调用

* [+][PracticeMode] 添加一个选项，开启后，只有自由模式且时间未耗尽时才允许使用练习模式，且时间耗尽时会强制清除练习模式的一切效果。
适配于窝的需求，防止利用练习模式“霸机”的情况。

* fix

Author: Starrah

AquaMai.Mods/UX/OneKeyRetrySkip.cs

@@ -29,8 +29,20 @@ public class OneKeyRetrySkip
     [ConfigEntry("跳关长按")]
     public static readonly bool skipLongPress = true;
 
+    [ConfigEntry(
+        name: "仅自由模式可重开",
+        en: "Only allow retry in Freedom Mode while time remains.",
+        zh: "仅在自由模式且时间未耗尽时允许一键重试，跳过不受影响")]
+    public static readonly bool allowRetryOnlyInFreedomMode = false;
+
     private static bool dirty = false;
 
+    private static bool IsRetryAllowed()
+    {
+        if (!allowRetryOnlyInFreedomMode) return true;
+        return GameManager.IsFreedomMode && GameManager.GetFreedomModeMSec() > 0;
+    }
+
     [HarmonyPostfix]
     [HarmonyPatch(typeof(GameProcess), "OnStart")]
     public static void PostGameProcessStart()
@@ -63,7 +75,8 @@ public static void PostGameProcessUpdate(GameProcess __instance, Message[] ____m
             traverse.Method("SetRelease").GetValue();
         }
 
-        else if (KeyListener.GetKeyDownOrLongPress(retryKey, retryLongPress) && GameInfo.GameVersion >= 23000)
+        else if (KeyListener.GetKeyDownOrLongPress(retryKey, retryLongPress) && GameInfo.GameVersion >= 23000 && 
+                 IsRetryAllowed())
         {
 #if DEBUG
             MelonLogger.Msg("[OneKeyRetrySkip] Retry key pressed.");

AquaMai.Mods/UX/PracticeMode/Libs/PractiseModeUI.cs

@@ -98,11 +98,7 @@ public void Update()
         }
         else if (InputManager.GetTouchPanelAreaDown(InputManager.TouchPanelArea.B8) || InputManager.GetTouchPanelAreaDown(InputManager.TouchPanelArea.B1))
         {
-            DebugFeature.Pause = !DebugFeature.Pause;
-            if (!DebugFeature.Pause)
-            {
-                PracticeMode.Seek(0);
-            }
+            PracticeMode.TogglePause();
         }
         else if (InputManager.GetTouchPanelAreaDown(InputManager.TouchPanelArea.B7) && PracticeMode.repeatStart == -1)
         {

AquaMai.Mods/UX/PracticeMode/PracticeMode.cs

@@ -36,13 +36,33 @@ public class PracticeMode
     [ConfigEntry]
     public static readonly bool longPress = false;
 
+    [ConfigEntry(
+        name: "仅自由模式可用",
+        en: "Only allow Practice Mode in Freedom Mode while time remains.",
+        zh: "仅在自由模式且时间未耗尽时允许使用练习模式")]
+    public static readonly bool onlyInFreedomMode = false;
+
     public static double repeatStart = -1;
     public static double repeatEnd = -1;
     public static float speed = 1;
     private static CriAtomExPlayer player;
     private static List<MovieMaterialMai2> movie;
     private static GameCtrl[] gameCtrl = new GameCtrl[2];
     public static bool keepNoteSpeed = false;
+    
+    private static void ClearPracticeEffects()
+    {
+        // 清除练习模式的所有效果。涉及的效果有五种：UI界面、循环、速度保持、速度、暂停。
+        if (ui != null)
+        {
+            UnityEngine.Object.Destroy(ui);
+            ui = null;
+        }
+        if (repeatStart >= 0 || repeatEnd >= 0) ClearRepeat();
+        keepNoteSpeed = false;
+        if (speed != 1f) SpeedReset();
+        if (DebugFeature.Pause) TogglePause();
+    }
 
     public static void SetRepeatEnd(double time)
     {
@@ -67,6 +87,15 @@ public static void ClearRepeat()
         repeatEnd = -1;
     }
 
+    public static void TogglePause()
+    {
+        DebugFeature.Pause = !DebugFeature.Pause;
+        if (!DebugFeature.Pause)
+        {
+            Seek(0);
+        }
+    }
+
     public static void GameCtrlResetOptionSpeed()
     {
         foreach (var g in gameCtrl)
@@ -169,6 +198,8 @@ public static double CurrentPlayMsec
 
     public static PracticeModeUI ui;
 
+    private static long prevFreedomModeMSec = -1; // 上一帧时，自由模式的剩余秒数
+
     [HarmonyPatch]
     public class PatchNoteSpeed
     {
@@ -192,7 +223,9 @@ public static void GameProcessPostStart()
         repeatStart = -1;
         repeatEnd = -1;
         speed = 1;
+        keepNoteSpeed = false;
         ui = null;
+        prevFreedomModeMSec = GameManager.IsFreedomMode ? GameManager.GetFreedomModeMSec() : -1;
     }
 
     [HarmonyPatch(typeof(GameProcess), "OnRelease")]
@@ -202,7 +235,9 @@ public static void GameProcessPostRelease()
         repeatStart = -1;
         repeatEnd = -1;
         speed = 1;
+        keepNoteSpeed = false;
         ui = null;
+        prevFreedomModeMSec = -1;
     }
 
     [HarmonyPatch(typeof(GameCtrl), "Initialize")]
@@ -228,10 +263,19 @@ public static void OnGenericProcessUpdate(GenericMonitor[] ____monitors)
     [HarmonyPostfix]
     public static void GameProcessPostUpdate(GameProcess __instance, GameMonitor[] ____monitors)
     {
-        if (KeyListener.GetKeyDownOrLongPress(key, longPress) && ui is null)
+        if (KeyListener.GetKeyDownOrLongPress(key, longPress) && ui is null && 
+            (!onlyInFreedomMode || (GameManager.IsFreedomMode && GameManager.GetFreedomModeMSec() > 0))) // onlyInFreedomMode=true情况，则额外检查是否在练习模式内、且时间有剩余，如果不满足则不开启UI。
         {
             ui = ____monitors[0].gameObject.AddComponent<PracticeModeUI>();
         }
+        
+        if (onlyInFreedomMode && GameManager.IsFreedomMode)
+        {
+            var currentFreedomModeMSec = GameManager.GetFreedomModeMSec();
+            if (prevFreedomModeMSec > 0 && currentFreedomModeMSec <= 0)
+                ClearPracticeEffects(); // 如果这一帧内、练习模式的时间刚好归零了：则清空练习模式的一切效果。
+            prevFreedomModeMSec = currentFreedomModeMSec;
+        }
 
         if (repeatStart >= 0 && repeatEnd >= 0)
         {