chore(Serializer): make use of the new os.rename

- With this, configs should no longer get corrupted and even if they do, a backup is always available.

> [!Note]
> For YimLuaAPI compatibility, this relies on TupoyeMenu/YimLuaAPI#3

Author: xesdoog

SSV2/includes/backend.lua

@@ -456,7 +456,6 @@ function Backend:OnPlayerSwitch()
 	end
 
 	self.is_in_player_transition = true
-
 	ThreadManager:Run(function()
 		self:TriggerEventCallbacks(Enums.eBackendEvent.PLAYER_SWITCH)
 
@@ -469,36 +468,38 @@ function Backend:OnPlayerSwitch()
 end
 
 function Backend:RegisterHandlers()
-	self.debug_mode = self:IsMockEnv() or GVars.backend.debug_mode or false
+	local mockEnv = self:IsMockEnv()
+	self.debug_mode = mockEnv or GVars.backend.debug_mode or false
 
-	if (self:IsMockEnv()) then
-		return
-	end
+	if (mockEnv) then return end
 
 	ThreadManager:RegisterLooped("SS_CTRLS", function()
 		if (self.disable_input) then
 			PAD.DISABLE_ALL_CONTROL_ACTIONS(0)
-		end
-
-		if ((gui.is_open() or GUI:IsOpen()) and not self.disable_input) then
-			self:DisableAttackInput()
-		end
+		else
+			if ((gui.is_open() or GUI:IsOpen())) then
+				self:DisableAttackInput()
+			end
 
-		for _, control in pairs(self.ControlsToDisable) do
-			PAD.DISABLE_CONTROL_ACTION(0, control, true)
+			for _, control in pairs(self.ControlsToDisable) do
+				PAD.DISABLE_CONTROL_ACTION(0, control, true)
+			end
 		end
 	end)
 
 	ThreadManager:RegisterLooped("SS_BACKEND", function()
 		self:OnPlayerSwitch()
 		self:OnSessionSwitch()
+
 		PreviewService:Update()
 		Decorator:CollectGarbage()
+
 		yield()
 	end)
 
 	ThreadManager:RegisterLooped("SS_POOLMGR", function()
 		self:PoolMgr()
+		yield()
 	end)
 
 	event.register_handler(menu_event.MenuUnloaded, function() self:Cleanup() end)

SSV2/includes/classes/Mutex.lua

@@ -10,7 +10,7 @@
 --------------------------------------
 -- Class: Mutex
 --------------------------------------
--- Simple mutual exclusion.
+-- Simple mutual exclusivity.
 ---@class Mutex
 ---@field protected m_locked boolean
 ---@overload fun(): Mutex
@@ -42,9 +42,10 @@ function Mutex:Release()
 end
 
 -- Scoped lock.
----@param func function
+---@generic R1, R2, R3, R4, R5
+---@param func fun(...?: any): R1?, R2?, R3?, R4?, R5?, ...?
 ---@param ... any
----@return ...
+---@return boolean success, R1?, R2?, R3?, R4?, R5?, ...?
 function Mutex:WithLock(func, ...)
 	self:Acquire()
 	local ret = { xpcall(func, function(msg)

SSV2/includes/features/vehicle/flappy_doors.lua

@@ -7,14 +7,15 @@
 --	* Provide a copy of or a link to the original license (GPL-3.0 or later); see LICENSE.md or <https://www.gnu.org/licenses/>.
 
 
-local FeatureBase = require("includes.modules.FeatureBase")
+local FeatureBase  = require("includes.modules.FeatureBase")
 local StateMachine = require("includes.structs.StateMachine")
 
+
 ---@class FlappyDoors : FeatureBase
 ---@field private m_entity PlayerVehicle
 ---@field private m_is_active boolean
 ---@field private m_state_machine StateMachine
-local FlappyDoors = setmetatable({}, FeatureBase)
+local FlappyDoors   = setmetatable({}, FeatureBase)
 FlappyDoors.__index = FlappyDoors
 
 ---@param pv PlayerVehicle

SSV2/includes/frontend/settings/debug_ui.lua

@@ -181,7 +181,8 @@ local function DrawThreads()
 				end
 			elseif (thread_state == eThreadState.DEAD) then
 				if GUI:Button("Start", { size = side_button_size }) then
-					ThreadManager:StartThread(thread_name)
+					---@diagnostic disable-next-line: invisible
+					ThreadManager:RestartThread(thread_name)
 				end
 			end
 		end

SSV2/includes/init.lua

@@ -24,16 +24,20 @@ local SCRIPT_NAME <const>    = "Samurai's Scripts"
 local SCRIPT_VERSION <const> = require("includes.version")
 local DEFAULT_CONFIG <const> = require("includes.data.config")
 
+
 ---@type GAME_VERSION
-local GAME_VERSION <const>   = {
-	{ build = "3788.0",  online = "1.72" },
-	{ build = "1013.29", online = "1.72" },
+local GAME_VERSION <const> = {
+	[1]  = { build = "3788.0", online = "1.72" },
+	[2]  = { build = "1013.29", online = "1.72" },
+	[99] = { build = "any", online = "any" },
 }
 
+
 -- ### Enums Namespace.
 --
 -- All enums are stored here to avoid polluting the global namespace.
-Enums                        = require("includes.data.enums.__init__")
+Enums = require("includes.data.enums.__init__")
+
 
 -- ### Backend Module
 --
@@ -42,7 +46,8 @@ Enums                        = require("includes.data.enums.__init__")
 -- It handles API/environment detection, cleanup logic, entity and blip tracking, etc.
 --
 -- This is the core system that ensures safe, predictable behavior when switching sessions, reloading scripts, or shutting down.
-Backend                      = require("includes.backend"):init(SCRIPT_NAME, SCRIPT_VERSION, GAME_VERSION)
+Backend = require("includes.backend"):init(SCRIPT_NAME, SCRIPT_VERSION, GAME_VERSION)
+
 
 require("includes.lib.types")
 require("includes.lib.utils")
@@ -63,13 +68,15 @@ require("includes.modules.Accessor")
 --
 -- For temporary or internal state that should not be saved, use `_G` directly.
 ---@class GVars : Config
-GVars         = {}
+GVars = {}
+
 
 ----------------------------------------------------------------------------------------------------
 -- These services must be loaded before any class that registers with/uses them -------------------
 ThreadManager = require("includes.services.ThreadManager"):init()
 Serializer    = require("includes.services.Serializer"):init("ssv2", DEFAULT_CONFIG, GVars)
 
+
 -- These may look out of place, but they register themselves with Serializer for seamless
 --
 -- object serialization and deserialization. They are also needed in the next batch of
@@ -80,27 +87,27 @@ require("includes.classes.Vector3")
 require("includes.classes.Vector4")
 require("includes.modules.Color")
 
-GPointers           = require("includes.data.pointers")
-Memory              = require("includes.modules.Memory")
-KeyManager          = require("includes.services.KeyManager"):init()
-GUI                 = require("includes.services.GUI")
-Notifier            = require("includes.services.ToastNotifier").new()
-CommandExecutor     = require("includes.services.CommandExecutor"):init()
+
+GPointers       = require("includes.data.pointers")
+Memory          = require("includes.modules.Memory")
+KeyManager      = require("includes.services.KeyManager"):init()
+GUI             = require("includes.services.GUI")
+Notifier        = require("includes.services.ToastNotifier").new()
+CommandExecutor = require("includes.services.CommandExecutor"):init()
 ----------------------------------------------------------------------------------------------------
 
+
 ----------------- Big Features (for smaller features, refer to includes/features) ------------------
 BillionaireServices = require("includes.features.BillionaireServicesV2"):init()
 EntityForge         = require("includes.features.EntityForge"):init()
 YimActions          = require("includes.features.YimActionsV3"):init()
 YRV3                = require("includes.features.YimResupplierV3"):init()
 ----------------------------------------------------------------------------------------------------
 
-local base_path     = "includes"
-local packages      = {
-	"data.refs",
-	"data.weapons",
 
-	"structs.StateMachine",
+local base_path = "includes"
+local packages  = {
+	"data.refs",
 
 	"modules.Audio",
 	"modules.Decorator",

SSV2/includes/lib/compat.lua

@@ -15,7 +15,7 @@ Compat.__index = Compat
 ---@param version eAPIVersion
 function Compat.SetupEnv(version)
 	if (version == Enums.eAPIVersion.L54) then
-		require("includes.lib.mock_env")
+		require("includes.lib.mock_env").Setup(version)
 	else
 		print = function(...)
 			local out = {}