Provide transitory functionality for existing scripts

Author: cesarBLG

Source/Orts.Simulation/Simulation/Physics/Train.cs

@@ -348,7 +348,7 @@ public TRAIN_CONTROL ControlMode
         /// <summary>
         /// Set when the train is out of control
         /// </summary>
-        private TRAIN_CONTROL ControlModeBeforeOutOfControl = TRAIN_CONTROL.UNDEFINED;
+        public TRAIN_CONTROL ControlModeBeforeOutOfControl = TRAIN_CONTROL.UNDEFINED;
 
         public enum OUTOFCONTROL
         {

Source/Orts.Simulation/Simulation/RollingStocks/SubSystems/TrainControlSystem.cs

@@ -539,7 +539,15 @@ public void Initialize()
                         CustomizedCabviewControlNames[id] = value;
                     }
                 };
-                Script.RequestToggleManualMode = () => Locomotive.Train.RequestToggleManualMode();
+                Script.RequestToggleManualMode = () => 
+                {
+                    if (Locomotive.Train.ControlMode == Train.TRAIN_CONTROL.OUT_OF_CONTROL && Locomotive.Train.ControlModeBeforeOutOfControl == Train.TRAIN_CONTROL.EXPLORER)
+                    {
+                        Trace.TraceWarning("RequestToggleManualMode() is deprecated for explorer mode. Please use ResetOutOfControlMode() instead");
+                        Locomotive.Train.ManualResetOutOfControlMode();
+                    }
+                    else Locomotive.Train.RequestToggleManualMode();
+                };
                 Script.ResetOutOfControlMode = () => Locomotive.Train.ManualResetOutOfControlMode();
 
                 // TrainControlSystem INI configuration file