@rbxts/falldown 1.1.9 → 1.3.0

package/out/index.d.ts

@@ -47,6 +47,10 @@ export interface IActiveRagdoll {
  * @see {@linkcode Falldown.VelocityMode}
  */
 export declare class Falldown {
+    /**
+     * If `true`, players will have DevEnableMouseLock set to `false` when ragdolled, preventing shift-lock mode. This is necessary to avoid camera issues while ragdolled, but may affect player preference for shift-lock. Defaults to `true`.
+     */
+    static DisableShiftLockOnRagdoll: boolean;
     /**
      * Enum used to represent how velocity should be distributed across a ragdolled character's body parts.
      * @static

package/out/init.luau

@@ -377,6 +377,14 @@ do
 	function ActiveRagdoll:constructor(character, objectiveHeight, standFadeTime, humanoid, humanoidRootPart, leftTouchObj, rightTouchObj, jointDestructionInfo, bodypartGroupId, automaticDuration, exitMode, getupFront, getupBack)
 		self.Destroyed = Signal.new()
 		self.Ended = Signal.new()
+		self.EndTime = nil
+		if Falldown.DisableShiftLockOnRagdoll then
+			local player = Players:GetPlayerFromCharacter(character)
+			if player then
+				self._wasShiftLockEnabled = player.DevEnableMouseLock
+				player.DevEnableMouseLock = false
+			end
+		end
 		character.Destroying:Once(function()
 			self.CharacterDead = true
 			table.clear(self._jointDestructionInfo)
@@ -414,13 +422,22 @@ do
 			_condition = not self.CharacterDead
 		end
 		if _condition ~= 0 and _condition == _condition and _condition then
-			delay(self._automaticDuration, function()
-				local _self = self
-				local _condition_1 = exitMode
-				if not (_condition_1 ~= 0 and _condition_1 == _condition_1 and _condition_1) then
-					_condition_1 = Falldown.ExitMode.Smooth
+			self.EndTime = DateTime.now().UnixTimestampMillis + (self._automaticDuration * 1000)
+			self._durationListener = RunService.Heartbeat:Connect(function()
+				if self.EndTime == nil then
+					self._durationListener:Disconnect()
+					return nil
+				end
+				if DateTime.now().UnixTimestampMillis >= self.EndTime then
+					self.EndTime = nil
+					local _self = self
+					local _condition_1 = exitMode
+					if not (_condition_1 ~= 0 and _condition_1 == _condition_1 and _condition_1) then
+						_condition_1 = Falldown.ExitMode.Smooth
+					end
+					_self:Destroy(_condition_1)
+					self._durationListener:Disconnect()
 				end
-				_self:Destroy(_condition_1)
 			end)
 		end
 	end
@@ -496,6 +513,7 @@ do
 		end
 	end
 	function ActiveRagdoll:Destroy(exitMode, overrideDeathLock)
+		self.EndTime = nil
 		if self.Character.Parent == nil then
 			return nil
 		end
@@ -832,6 +850,9 @@ do
 				clonedCharacter:Destroy()
 			end)
 		end
+		if self._wasShiftLockEnabled ~= nil and self.Owner then
+			self.Owner.DevEnableMouseLock = self._wasShiftLockEnabled
+		end
 		PhysicsService:UnregisterCollisionGroup(self._bodypartGroupId)
 		self.Destroyed:Fire()
 		self.Destroyed:Destroy()
@@ -1529,7 +1550,15 @@ do
 	function Falldown:RagdollCharacter(character, standupFadeTime, automaticDuration, exitMode, getupFront, getupBack)
 		local __activeRagdolls = self._activeRagdolls
 		local _character = character
-		if __activeRagdolls[_character] ~= nil then
+		local existing = __activeRagdolls[_character]
+		if existing then
+			if existing.EndTime ~= nil then
+				if automaticDuration ~= nil then
+					existing.EndTime = DateTime.now().UnixTimestampMillis + (automaticDuration * 1000)
+				else
+					existing.EndTime = nil
+				end
+			end
 			return nil
 		end
 		local humanoid = character:FindFirstChildOfClass("Humanoid")
@@ -1644,6 +1673,7 @@ do
 			end
 		end
 	end
+	Falldown.DisableShiftLockOnRagdoll = true
 	Falldown.VelocityMode = {
 		RootOnly = 0,
 		AllEqual = 1,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rbxts/falldown",
-  "version": "1.1.9",
+  "version": "1.3.0",
   "description": "A realistic ragdoll physics system for Roblox with smooth getup animations, collision management, and customizable velocity modes. Supports both R6 and R15 rigs with surface-aware positioning.",
   "main": "out/init.luau",
   "scripts": {