@rbxts/falldown 1.0.4 → 1.1.1

package/out/index.d.ts

@@ -38,7 +38,7 @@ export interface IActiveRagdoll {
      * @see {@linkcode IActiveRagdoll.Destroyed}
      * @see {@linkcode Falldown.UnragdollCharacter}
      */
-    Destroy(): void;
+    Destroy(exitMode: (typeof Falldown.ExitMode)[keyof typeof Falldown.ExitMode]): void;
 }
 /**
  * Main Falldown class providing static methods for ragdolling characters in Roblox. Creates realistic ragdoll physics by replacing Motor6Ds with constraints, managing collision groups, and providing smooth getup animations.
@@ -64,6 +64,19 @@ export declare class Falldown {
         /** Each part gets a random velocity from 0 to the specified magnitude in the same direction. Creates varied motion, useful for explosions. */
         readonly RandomMax: 3;
     };
+    /**
+     * Enum used to represent how a ragdolled character should exit the ragdoll state.
+     * @static
+     * @readonly
+     * @enum {number}
+     * @see {@linkcode IActiveRagdoll.Destroy}
+     */
+    static ExitMode: {
+        /** Character will play the appropriate getup animation and stand up on their own. Default behavior. */
+        readonly Smooth: 0;
+        /** Character will be restored at its current exact ragdoll position, standing with no fade or animations */
+        readonly Immediate: 1;
+    };
     private static readonly _activeRagdolls;
     private static MakeProxies;
     private static CreateActiveRagdollR6;
@@ -81,7 +94,7 @@ export declare class Falldown {
      * @see {@linkcode Falldown.UnragdollCharacter}
      * @see {@linkcode Falldown.VelocityMode}
      */
-    static RagdollCharacter(character: Model, standupFadeTime: number, automaticDuration?: number, getupFront?: Animation, getupBack?: Animation): IActiveRagdoll | undefined;
+    static RagdollCharacter(character: Model, standupFadeTime: number, automaticDuration?: number, exitMode?: (typeof Falldown.ExitMode)[keyof typeof Falldown.ExitMode], getupFront?: Animation, getupBack?: Animation): IActiveRagdoll | undefined;
     /**
      * Manually ends the ragdoll state for a specific character. Equivalent to calling {@linkcode IActiveRagdoll.Destroy} on the ragdoll instance. If the character is not currently ragdolled, this method does nothing.
      * @static
@@ -91,7 +104,13 @@ export declare class Falldown {
      * @see {@linkcode Falldown.RagdollCharacter}
      * @see {@linkcode Falldown.UnragdollAllCharacters}
      */
-    static UnragdollCharacter(character: Model, delayTime?: number): void;
+    static UnragdollCharacter(character: Model, delayTime?: number, exitMode?: (typeof Falldown.ExitMode)[keyof typeof Falldown.ExitMode]): void;
+    /**
+     * @static
+     * @param character - The character `Model` to check
+     * @returns Whether the character is currently ragdolled
+     */
+    static IsCharacterRagdolled(character: Model): boolean;
     /**
      * Ends the ragdoll state for ALL currently ragdolled characters. Useful for game-wide effects like round resets or emergency cleanup. Each character performs their getup animation independently.
      * @static
@@ -99,5 +118,5 @@ export declare class Falldown {
      * @see {@linkcode Falldown.UnragdollCharacter}
      * @see {@linkcode Falldown.RagdollCharacter}
      */
-    static UnragdollAllCharacters(delayTime?: number): void;
+    static UnragdollAllCharacters(delayTime?: number, exitMode?: (typeof Falldown.ExitMode)[keyof typeof Falldown.ExitMode]): void;
 }

package/out/init.luau

@@ -374,7 +374,7 @@ do
 		local self = setmetatable({}, ActiveRagdoll)
 		return self:constructor(...) or self
 	end
-	function ActiveRagdoll:constructor(character, objectiveHeight, standFadeTime, humanoid, humanoidRootPart, leftTouchObj, rightTouchObj, jointDestructionInfo, proxyGroupId, bodypartGroupId, proxyMapping, automaticDuration, getupFront, getupBack)
+	function ActiveRagdoll:constructor(character, objectiveHeight, standFadeTime, humanoid, humanoidRootPart, leftTouchObj, rightTouchObj, jointDestructionInfo, proxyGroupId, bodypartGroupId, proxyMapping, automaticDuration, exitMode, getupFront, getupBack)
 		self.Destroyed = Signal.new()
 		self.Ended = Signal.new()
 		character.Destroying:Once(function()
@@ -417,7 +417,12 @@ do
 		end
 		if _condition ~= 0 and _condition == _condition and _condition then
 			delay(self._automaticDuration, function()
-				self:Destroy()
+				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)
 			end)
 		end
 	end
@@ -492,7 +497,7 @@ do
 			end
 		end
 	end
-	function ActiveRagdoll:Destroy(overrideDeathLock)
+	function ActiveRagdoll:Destroy(exitMode, overrideDeathLock)
 		if self.Character.Parent == nil then
 			return nil
 		end
@@ -502,55 +507,7 @@ do
 		if #self._jointDestructionInfo == 0 or next(self._proxyMapping) == nil then
 			return nil
 		end
-		local clonedCharacter = Instance.new("Model")
-		clonedCharacter.Name = "Falldown_FadeClone_Temp"
-		local humanoid = Instance.new("Humanoid")
-		local animator = humanoid:FindFirstChildOfClass("Animator")
-		humanoid.RigType = self.Humanoid.RigType
-		humanoid.RequiresNeck = false
-		humanoid.AutoRotate = false
-		if animator then
-			for _, anim in animator:GetPlayingAnimationTracks() do
-				anim:Stop()
-			end
-			animator:Destroy()
-		end
-		local cloneCG = HttpService:GenerateGUID(false)
-		PhysicsService:RegisterCollisionGroup(cloneCG)
-		PhysicsService:CollisionGroupSetCollidable(cloneCG, "Default", false)
-		PhysicsService:CollisionGroupSetCollidable(cloneCG, self._bodypartGroupId, false)
-		PhysicsService:CollisionGroupSetCollidable(cloneCG, cloneCG, false)
-		local cloneToRealMap = {}
-		local originalTransparencies = {}
-		for _, descendant in self.Character:GetDescendants() do
-			if descendant:IsA("BasePart") then
-				local partClone = descendant:Clone()
-				partClone.Anchored = true
-				partClone.CollisionGroup = cloneCG
-				partClone.CFrame = descendant.CFrame
-				cloneToRealMap[partClone] = descendant
-				local _transparency = descendant.Transparency
-				originalTransparencies[descendant] = _transparency
-				for _1, partDesc in partClone:GetDescendants() do
-					if partDesc:IsA("JointInstance") or partDesc:IsA("Constraint") or partDesc:IsA("Attachment") then
-						partDesc:Destroy()
-					elseif partDesc:IsA("Decal") then
-						local _arg0 = descendant:FindFirstChild(partDesc.Name)
-						local _transparency_1 = partDesc.Transparency
-						originalTransparencies[_arg0] = _transparency_1
-					end
-				end
-				partClone.Parent = clonedCharacter
-			elseif descendant:IsA("Clothing") then
-				local clothingClone = descendant:Clone()
-				clothingClone.Parent = clonedCharacter
-			end
-		end
-		humanoid.Parent = clonedCharacter
-		clonedCharacter.Parent = Workspace
-		for thing, originalTransparency in originalTransparencies do
-			thing.Transparency = 1
-		end
+		-- ── Shared: remove ragdoll constraints, restore Motor6Ds ──
 		for _, info in self._jointDestructionInfo do
 			info.Replaced.Enabled = true
 			info.Constraint:Destroy()
@@ -574,21 +531,12 @@ do
 				descendant.AssemblyAngularVelocity = Vector3.zero
 			end
 		end
-		self.Humanoid.PlatformStand = false
-		self.Humanoid:ChangeState(Enum.HumanoidStateType.GettingUp)
-		self.HumanoidRootPart.Anchored = true
-		--const thisAnimator = this.Humanoid.FindFirstChildOfClass("Animator");
-		--if (thisAnimator) {
-		--    for (const anim of thisAnimator.GetPlayingAnimationTracks()) {
-		--        anim.Stop(0);
-		--    }
-		--}
+		-- ── Shared: destroy proxy parts ──
 		for _, proxyPart in self._proxyMapping do
 			proxyPart:Destroy()
 		end
 		table.clear(self._proxyMapping)
-		local facing = ActiveRagdoll:GetVerticalDirection(self.HumanoidRootPart.CFrame.LookVector)
-		local activeAnimation = nil
+		-- ── Shared: raycast for ground & compute stand CFrame ──
 		local _cFrame = self.LeftTouchPart.CFrame
 		local _cFrame_1 = CFrame.new(0, -(self.LeftTouchPart.Size.Y / 2), 0)
 		local leftToes = _cFrame * _cFrame_1
@@ -627,6 +575,7 @@ do
 		local gDot = gravity:Dot(groundNormal)
 		local _arg0_1 = groundNormal * gDot
 		local downhill = gravity - _arg0_1
+		local isSloped = downhill.Magnitude >= 0.05
 		if downhill.Magnitude < 1e-3 then
 			downhill = Vector3.new(0, 0, 1)
 		end
@@ -646,7 +595,7 @@ do
 			if along.Magnitude < 1e-3 then
 				along = downhill
 			end
-			if along:Dot(downhill) < 0 then
+			if isSloped and along:Dot(downhill) < 0 then
 				along = along * (-1)
 			end
 			return along.Unit
@@ -660,79 +609,10 @@ do
 		end
 		right = right.Unit
 		local forwardOnSurface = right:Cross(groundNormal).Unit
-		if facing == 0 then
-			activeAnimation = self.GetupBackAnimation
-		else
-			activeAnimation = self.GetupFrontAnimation
-		end
-		task.spawn(function()
-			if activeAnimation then
-				local targetCFrame = CFrame.fromMatrix(centerPoint, forwardOnSurface, groundNormal)
-				self.Character:PivotTo(targetCFrame)
-				activeAnimation:Play(0, 1, 0)
-				while not activeAnimation.IsPlaying do
-					task.wait()
-				end
-				activeAnimation.TimePosition = 0.0
-				task.wait()
-				local activeLerp = 0
-				task.spawn(function()
-					while true do
-						local dt = task.wait(1 / 60)
-						local lerpAlpha = activeLerp + (dt / math.min(self._standFadeTime, activeAnimation.Length))
-						local ended = false
-						if lerpAlpha >= 1 then
-							ended = true
-							lerpAlpha = 1
-						end
-						for partClone, realPart in cloneToRealMap do
-							partClone.CFrame = partClone.CFrame:Lerp(realPart.CFrame, lerpAlpha)
-						end
-						activeLerp = lerpAlpha
-						if ended then
-							for partClone, realPart in cloneToRealMap do
-								partClone:Destroy()
-							end
-							for thing, originalTransparency in originalTransparencies do
-								thing.Transparency = originalTransparency
-							end
-							return nil
-						end
-					end
-				end)
-				activeAnimation:AdjustSpeed(1)
-				activeAnimation.Ended:Wait()
-			else
-				local targetCFrame = CFrame.fromMatrix(centerPoint, forwardOnSurface, groundNormal)
-				self.Character:PivotTo(targetCFrame)
-				task.wait()
-				local activeLerp = 0
-				task.spawn(function()
-					while true do
-						local dt = task.wait(1 / 60)
-						local lerpAlpha = activeLerp + (dt / self._standFadeTime)
-						local ended = false
-						if lerpAlpha >= 1 then
-							ended = true
-							lerpAlpha = 1
-						end
-						for partClone, realPart in cloneToRealMap do
-							partClone.CFrame = partClone.CFrame:Lerp(realPart.CFrame, lerpAlpha)
-						end
-						activeLerp = lerpAlpha
-						if ended then
-							for partClone, realPart in cloneToRealMap do
-								partClone:Destroy()
-							end
-							for thing, originalTransparency in originalTransparencies do
-								thing.Transparency = originalTransparency
-							end
-							return nil
-						end
-					end
-				end)
-				task.wait(self._standFadeTime)
-			end
+		local targetCFrame = CFrame.fromMatrix(centerPoint, forwardOnSurface, groundNormal)
+		if exitMode == Falldown.ExitMode.Immediate then
+			-- ── Immediate: snap character to standing pose, no clone or animation ──
+			self.Character:PivotTo(targetCFrame)
 			for _, descendant in self.Character:GetDescendants() do
 				if descendant:IsA("BasePart") then
 					descendant.Anchored = false
@@ -746,21 +626,174 @@ do
 			end
 			self.Humanoid.PlatformStand = false
 			self.HumanoidRootPart.Anchored = false
-			RunService.Heartbeat:Wait()
+			self.Humanoid.EvaluateStateMachine = true
+			self.Humanoid:SetStateEnabled(Enum.HumanoidStateType.Jumping, true)
+			self.Humanoid:SetStateEnabled(Enum.HumanoidStateType.GettingUp, true)
+			self.Humanoid:ChangeState(Enum.HumanoidStateType.Running)
 			task.defer(function()
 				while self.Humanoid.MoveDirection.Magnitude <= 0 do
 					RunService.Stepped:Wait()
 				end
 				self.HumanoidRootPart:SetNetworkOwner(self.Owner)
 			end)
-			self.Humanoid.EvaluateStateMachine = true
-			self.Humanoid:SetStateEnabled(Enum.HumanoidStateType.Jumping, true)
-			self.Humanoid:SetStateEnabled(Enum.HumanoidStateType.GettingUp, true)
-			self.Humanoid:ChangeState(Enum.HumanoidStateType.Running)
 			self.Ended:Fire()
 			self.Ended:Destroy()
-			clonedCharacter:Destroy()
-		end)
+		else
+			-- ── Smooth: create fade clone, play getup animation, tween ──
+			local clonedCharacter = Instance.new("Model")
+			clonedCharacter.Name = "Falldown_FadeClone_Temp"
+			local humanoid = Instance.new("Humanoid")
+			local animator = humanoid:FindFirstChildOfClass("Animator")
+			humanoid.RigType = self.Humanoid.RigType
+			humanoid.RequiresNeck = false
+			humanoid.AutoRotate = false
+			if animator then
+				for _, anim in animator:GetPlayingAnimationTracks() do
+					anim:Stop()
+				end
+				animator:Destroy()
+			end
+			local cloneCG = HttpService:GenerateGUID(false)
+			PhysicsService:RegisterCollisionGroup(cloneCG)
+			PhysicsService:CollisionGroupSetCollidable(cloneCG, "Default", false)
+			PhysicsService:CollisionGroupSetCollidable(cloneCG, self._bodypartGroupId, false)
+			PhysicsService:CollisionGroupSetCollidable(cloneCG, cloneCG, false)
+			local cloneToRealMap = {}
+			local originalTransparencies = {}
+			for _, descendant in self.Character:GetDescendants() do
+				if descendant:IsA("BasePart") then
+					local partClone = descendant:Clone()
+					partClone.Anchored = true
+					partClone.CollisionGroup = cloneCG
+					partClone.CFrame = descendant.CFrame
+					cloneToRealMap[partClone] = descendant
+					local _transparency = descendant.Transparency
+					originalTransparencies[descendant] = _transparency
+					for _1, partDesc in partClone:GetDescendants() do
+						if partDesc:IsA("JointInstance") or partDesc:IsA("Constraint") or partDesc:IsA("Attachment") then
+							partDesc:Destroy()
+						elseif partDesc:IsA("Decal") then
+							local _arg0_2 = descendant:FindFirstChild(partDesc.Name)
+							local _transparency_1 = partDesc.Transparency
+							originalTransparencies[_arg0_2] = _transparency_1
+						end
+					end
+					partClone.Parent = clonedCharacter
+				elseif descendant:IsA("Clothing") then
+					local clothingClone = descendant:Clone()
+					clothingClone.Parent = clonedCharacter
+				end
+			end
+			humanoid.Parent = clonedCharacter
+			clonedCharacter.Parent = Workspace
+			for thing, originalTransparency in originalTransparencies do
+				thing.Transparency = 1
+			end
+			self.Humanoid.PlatformStand = false
+			self.Humanoid:ChangeState(Enum.HumanoidStateType.GettingUp)
+			self.HumanoidRootPart.Anchored = true
+			local facing = ActiveRagdoll:GetVerticalDirection(self.HumanoidRootPart.CFrame.LookVector)
+			local activeAnimation = nil
+			if facing == 0 then
+				activeAnimation = self.GetupBackAnimation
+			else
+				activeAnimation = self.GetupFrontAnimation
+			end
+			task.spawn(function()
+				if activeAnimation then
+					self.Character:PivotTo(targetCFrame)
+					activeAnimation:Play(0, 1, 0)
+					while not activeAnimation.IsPlaying do
+						task.wait()
+					end
+					activeAnimation.TimePosition = 0.0
+					task.wait()
+					local activeLerp = 0
+					task.spawn(function()
+						while true do
+							local dt = task.wait(1 / 60)
+							local lerpAlpha = activeLerp + (dt / math.min(self._standFadeTime, activeAnimation.Length))
+							local ended = false
+							if lerpAlpha >= 1 then
+								ended = true
+								lerpAlpha = 1
+							end
+							for partClone, realPart in cloneToRealMap do
+								partClone.CFrame = partClone.CFrame:Lerp(realPart.CFrame, lerpAlpha)
+							end
+							activeLerp = lerpAlpha
+							if ended then
+								for partClone, realPart in cloneToRealMap do
+									partClone:Destroy()
+								end
+								for thing, originalTransparency in originalTransparencies do
+									thing.Transparency = originalTransparency
+								end
+								return nil
+							end
+						end
+					end)
+					activeAnimation:AdjustSpeed(1)
+					activeAnimation.Ended:Wait()
+				else
+					self.Character:PivotTo(targetCFrame)
+					task.wait()
+					local activeLerp = 0
+					task.spawn(function()
+						while true do
+							local dt = task.wait(1 / 60)
+							local lerpAlpha = activeLerp + (dt / self._standFadeTime)
+							local ended = false
+							if lerpAlpha >= 1 then
+								ended = true
+								lerpAlpha = 1
+							end
+							for partClone, realPart in cloneToRealMap do
+								partClone.CFrame = partClone.CFrame:Lerp(realPart.CFrame, lerpAlpha)
+							end
+							activeLerp = lerpAlpha
+							if ended then
+								for partClone, realPart in cloneToRealMap do
+									partClone:Destroy()
+								end
+								for thing, originalTransparency in originalTransparencies do
+									thing.Transparency = originalTransparency
+								end
+								return nil
+							end
+						end
+					end)
+					task.wait(self._standFadeTime)
+				end
+				for _, descendant in self.Character:GetDescendants() do
+					if descendant:IsA("BasePart") then
+						descendant.Anchored = false
+						descendant.AssemblyLinearVelocity = Vector3.zero
+						descendant.AssemblyAngularVelocity = Vector3.zero
+						if descendant:GetAttribute("Falldown_Reverse_CC_To") ~= nil then
+							descendant.CanCollide = descendant:GetAttribute("Falldown_Reverse_CC_To")
+							descendant:SetAttribute("Falldown_Reverse_CC_To", nil)
+						end
+					end
+				end
+				self.Humanoid.PlatformStand = false
+				self.HumanoidRootPart.Anchored = false
+				RunService.Heartbeat:Wait()
+				task.defer(function()
+					while self.Humanoid.MoveDirection.Magnitude <= 0 do
+						RunService.Stepped:Wait()
+					end
+					self.HumanoidRootPart:SetNetworkOwner(self.Owner)
+				end)
+				self.Humanoid.EvaluateStateMachine = true
+				self.Humanoid:SetStateEnabled(Enum.HumanoidStateType.Jumping, true)
+				self.Humanoid:SetStateEnabled(Enum.HumanoidStateType.GettingUp, true)
+				self.Humanoid:ChangeState(Enum.HumanoidStateType.Running)
+				self.Ended:Fire()
+				self.Ended:Destroy()
+				clonedCharacter:Destroy()
+			end)
+		end
 		PhysicsService:UnregisterCollisionGroup(self._proxyGroupId)
 		PhysicsService:UnregisterCollisionGroup(self._bodypartGroupId)
 		self.Destroyed:Fire()
@@ -826,7 +859,7 @@ do
 		end
 		return proxyMap
 	end
-	function Falldown:CreateActiveRagdollR6(character, humanoid, standFadeTime, automaticDuration, getupFront, getupBack)
+	function Falldown:CreateActiveRagdollR6(character, humanoid, standFadeTime, automaticDuration, exitMode, getupFront, getupBack)
 		local leftArm = character:FindFirstChild("Left Arm")
 		local rightArm = character:FindFirstChild("Right Arm")
 		local leftLeg = character:FindFirstChild("Left Leg")
@@ -844,7 +877,7 @@ do
 		local _cFrame_2 = rightLeg.CFrame
 		local _cFrame_3 = CFrame.new(0, -rightLeg.Size.Y / 2, 0)
 		local endPos = _:Lerp((_cFrame_2 * _cFrame_3).Position, 0.5)
-		local height = (primaryPos - endPos).Magnitude
+		local height = math.abs(primaryPos.Y - endPos.Y)
 		humanoid:ChangeState(Enum.HumanoidStateType.Physics)
 		local animator = humanoid:FindFirstChildOfClass("Animator") or Instance.new("Animator", humanoid)
 		local getupFrontTrack = if getupFront then animator:LoadAnimation(getupFront) else nil
@@ -1064,9 +1097,9 @@ do
 			end
 		end
 		humanoid.EvaluateStateMachine = false
-		return ActiveRagdoll.new(character, height, standFadeTime, humanoid, humanoidRootPart, leftLeg, rightLeg, destructionInfo, proxyGroupId, bodypartGroupId, ProxyMapping, automaticDuration, getupFrontTrack, getupBackTrack)
+		return ActiveRagdoll.new(character, height, standFadeTime, humanoid, humanoidRootPart, leftLeg, rightLeg, destructionInfo, proxyGroupId, bodypartGroupId, ProxyMapping, automaticDuration, exitMode, getupFrontTrack, getupBackTrack)
 	end
-	function Falldown:CreateActiveRagdollR15(character, humanoid, standFadeTime, automaticDuration, getupFront, getupBack)
+	function Falldown:CreateActiveRagdollR15(character, humanoid, standFadeTime, automaticDuration, exitMode, getupFront, getupBack)
 		local leftUpperArm = character:FindFirstChild("LeftUpperArm")
 		local leftLowerArm = character:FindFirstChild("LeftLowerArm")
 		local leftHand = character:FindFirstChild("LeftHand")
@@ -1093,7 +1126,7 @@ do
 		local _cFrame_2 = rightFoot.CFrame
 		local _cFrame_3 = CFrame.new(0, -rightFoot.Size.Y / 2, 0)
 		local endPos = _:Lerp((_cFrame_2 * _cFrame_3).Position, 0.5)
-		local height = (primaryPos - endPos).Magnitude
+		local height = math.abs(primaryPos.Y - endPos.Y)
 		humanoid:ChangeState(Enum.HumanoidStateType.Physics)
 		local animator = humanoid:FindFirstChildOfClass("Animator") or Instance.new("Animator", humanoid)
 		local getupFrontTrack = if getupFront then animator:LoadAnimation(getupFront) else nil
@@ -1518,9 +1551,9 @@ do
 			end
 		end
 		humanoid.EvaluateStateMachine = false
-		return ActiveRagdoll.new(character, height, standFadeTime, humanoid, humanoidRootPart, leftFoot, rightFoot, destructionInfo, proxyGroupId, bodypartGroupId, ProxyMapping, automaticDuration, getupFrontTrack, getupBackTrack)
+		return ActiveRagdoll.new(character, height, standFadeTime, humanoid, humanoidRootPart, leftFoot, rightFoot, destructionInfo, proxyGroupId, bodypartGroupId, ProxyMapping, automaticDuration, exitMode, getupFrontTrack, getupBackTrack)
 	end
-	function Falldown:RagdollCharacter(character, standupFadeTime, automaticDuration, getupFront, getupBack)
+	function Falldown:RagdollCharacter(character, standupFadeTime, automaticDuration, exitMode, getupFront, getupBack)
 		local __activeRagdolls = self._activeRagdolls
 		local _character = character
 		if __activeRagdolls[_character] ~= nil then
@@ -1531,7 +1564,7 @@ do
 			return nil
 		end
 		if humanoid.RigType == Enum.HumanoidRigType.R6 then
-			local createdActiveRagdoll = self:CreateActiveRagdollR6(character, humanoid, standupFadeTime, automaticDuration, getupFront, getupBack)
+			local createdActiveRagdoll = self:CreateActiveRagdollR6(character, humanoid, standupFadeTime, automaticDuration, exitMode, getupFront, getupBack)
 			if createdActiveRagdoll then
 				local __activeRagdolls_1 = self._activeRagdolls
 				local _character_1 = character
@@ -1550,7 +1583,7 @@ do
 				return nil
 			end
 		else
-			local createdActiveRagdoll = self:CreateActiveRagdollR15(character, humanoid, standupFadeTime, automaticDuration, getupFront, getupBack)
+			local createdActiveRagdoll = self:CreateActiveRagdollR15(character, humanoid, standupFadeTime, automaticDuration, exitMode, getupFront, getupBack)
 			if createdActiveRagdoll then
 				local __activeRagdolls_1 = self._activeRagdolls
 				local _character_1 = character
@@ -1570,7 +1603,7 @@ do
 			end
 		end
 	end
-	function Falldown:UnragdollCharacter(character, delayTime)
+	function Falldown:UnragdollCharacter(character, delayTime, exitMode)
 		local __activeRagdolls = self._activeRagdolls
 		local _character = character
 		local activeRagdoll = __activeRagdolls[_character]
@@ -1583,7 +1616,11 @@ do
 						local __activeRagdolls_2 = self._activeRagdolls
 						local _character_2 = character
 						__activeRagdolls_2[_character_2] = nil
-						activeRagdoll:Destroy()
+						local _condition = exitMode
+						if not (_condition ~= 0 and _condition == _condition and _condition) then
+							_condition = Falldown.ExitMode.Smooth
+						end
+						activeRagdoll:Destroy(_condition)
 					end
 				end)
 			else
@@ -1593,18 +1630,31 @@ do
 					local __activeRagdolls_2 = self._activeRagdolls
 					local _character_2 = character
 					__activeRagdolls_2[_character_2] = nil
-					activeRagdoll:Destroy()
+					local _condition = exitMode
+					if not (_condition ~= 0 and _condition == _condition and _condition) then
+						_condition = Falldown.ExitMode.Smooth
+					end
+					activeRagdoll:Destroy(_condition)
 				end
 			end
 		end
 	end
-	function Falldown:UnragdollAllCharacters(delayTime)
+	function Falldown:IsCharacterRagdolled(character)
+		local __activeRagdolls = self._activeRagdolls
+		local _character = character
+		return __activeRagdolls[_character] ~= nil
+	end
+	function Falldown:UnragdollAllCharacters(delayTime, exitMode)
 		if delayTime ~= 0 and delayTime == delayTime and delayTime then
 			delay(delayTime, function()
 				for character, activeRagdoll in self._activeRagdolls do
 					if self._activeRagdolls[character] ~= nil then
 						self._activeRagdolls[character] = nil
-						activeRagdoll:Destroy()
+						local _condition = exitMode
+						if not (_condition ~= 0 and _condition == _condition and _condition) then
+							_condition = Falldown.ExitMode.Smooth
+						end
+						activeRagdoll:Destroy(_condition)
 					end
 				end
 			end)
@@ -1612,7 +1662,11 @@ do
 			for character, activeRagdoll in self._activeRagdolls do
 				if self._activeRagdolls[character] ~= nil then
 					self._activeRagdolls[character] = nil
-					activeRagdoll:Destroy()
+					local _condition = exitMode
+					if not (_condition ~= 0 and _condition == _condition and _condition) then
+						_condition = Falldown.ExitMode.Smooth
+					end
+					activeRagdoll:Destroy(_condition)
 				end
 			end
 		end
@@ -1623,6 +1677,10 @@ do
 		SplitEqual = 2,
 		RandomMax = 3,
 	}
+	Falldown.ExitMode = {
+		Smooth = 0,
+		Immediate = 1,
+	}
 	Falldown._activeRagdolls = {}
 end
 return {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rbxts/falldown",
-  "version": "1.0.4",
+  "version": "1.1.1",
   "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": {