@rbxts/falldown 1.1.5 → 1.1.7

package/out/index.d.ts

@@ -78,11 +78,11 @@ export declare class Falldown {
         readonly Immediate: 1;
     };
     private static readonly _activeRagdolls;
-    private static MakeProxies;
+    private static SetupCollisionGroup;
     private static CreateActiveRagdollR6;
     private static CreateActiveRagdollR15;
     /**
-     * Converts a character into a ragdoll with physics-based movement. Detects R6/R15 rig automatically, replaces Motor6Ds with constraints, creates collision proxies, and sets up automatic recovery.
+     * Converts a character into a ragdoll with physics-based movement. Detects R6/R15 rig automatically, replaces Motor6Ds with constraints, manages collision groups, and sets up automatic recovery.
      * @static
      * @param character - The character `Model` to ragdoll. Must have a Humanoid.
      * @param standupFadeTime - Duration (in seconds) for the fade clone to remain visible after standing up. Recommended: 0.3-0.7 seconds.

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, exitMode, getupFront, getupBack)
+	function ActiveRagdoll:constructor(character, objectiveHeight, standFadeTime, humanoid, humanoidRootPart, leftTouchObj, rightTouchObj, jointDestructionInfo, bodypartGroupId, automaticDuration, exitMode, getupFront, getupBack)
 		self.Destroyed = Signal.new()
 		self.Ended = Signal.new()
 		character.Destroying:Once(function()
@@ -406,9 +406,7 @@ do
 		end
 		self._automaticDuration = automaticDuration
 		self._jointDestructionInfo = jointDestructionInfo
-		self._proxyGroupId = proxyGroupId
 		self._bodypartGroupId = bodypartGroupId
-		self._proxyMapping = proxyMapping
 		self._objectiveHeight = objectiveHeight
 		self._standFadeTime = standFadeTime
 		local _condition = self._automaticDuration
@@ -440,7 +438,7 @@ do
 		if self.Character.Parent == nil then
 			return nil
 		end
-		if #self._jointDestructionInfo == 0 or next(self._proxyMapping) == nil then
+		if #self._jointDestructionInfo == 0 then
 			return nil
 		end
 		local velocityDirection = velocity.Unit
@@ -487,7 +485,7 @@ do
 		if self.Character.Parent == nil then
 			return nil
 		end
-		if #self._jointDestructionInfo == 0 or next(self._proxyMapping) == nil then
+		if #self._jointDestructionInfo == 0 then
 			return nil
 		end
 		for _, descendant in self.Character:GetDescendants() do
@@ -504,7 +502,7 @@ do
 		if self.CharacterDead and not overrideDeathLock then
 			return nil
 		end
-		if #self._jointDestructionInfo == 0 or next(self._proxyMapping) == nil then
+		if #self._jointDestructionInfo == 0 then
 			return nil
 		end
 		-- ── Shared: remove ragdoll constraints, restore Motor6Ds ──
@@ -531,11 +529,6 @@ do
 				descendant.AssemblyAngularVelocity = Vector3.zero
 			end
 		end
-		-- ── Shared: destroy proxy parts ──
-		for _, proxyPart in self._proxyMapping do
-			proxyPart:Destroy()
-		end
-		table.clear(self._proxyMapping)
 		-- ── Shared: raycast for ground & compute stand CFrame ──
 		local _cFrame = self.LeftTouchPart.CFrame
 		local _cFrame_1 = CFrame.new(0, -(self.LeftTouchPart.Size.Y / 2), 0)
@@ -630,11 +623,14 @@ do
 			local immGroundPoint = _condition_2
 			local _vector3_1 = Vector3.new(0, self._objectiveHeight, 0)
 			local immCenter = immGroundPoint + _vector3_1
-			-- Face along the flattened feet-to-head direction (XZ plane)
+			-- Determine facing: front (belly down) = feet->head, back = head->feet
+			local immFacing_raw = ActiveRagdoll:GetVerticalDirection(self.HumanoidRootPart.CFrame.LookVector)
 			local head = self.Character:FindFirstChild("Head")
 			local feetMid = self.LeftTouchPart.Position:Lerp(self.RightTouchPart.Position, 0.5)
 			local headPos = if (head and head:IsA("BasePart")) then head.Position else self.HumanoidRootPart.Position
-			local immFacing = Vector3.new(headPos.X - feetMid.X, 0, headPos.Z - feetMid.Z)
+			local feetToHead = Vector3.new(headPos.X - feetMid.X, 0, headPos.Z - feetMid.Z)
+			-- facing === 1 means belly down (front), 0 means back down
+			local immFacing = if immFacing_raw == 1 then feetToHead else feetToHead * (-1)
 			if immFacing.Magnitude < 1e-3 then
 				immFacing = Vector3.new(self.HumanoidRootPart.CFrame.LookVector.X, 0, self.HumanoidRootPart.CFrame.LookVector.Z)
 			end
@@ -836,7 +832,6 @@ do
 				clonedCharacter:Destroy()
 			end)
 		end
-		PhysicsService:UnregisterCollisionGroup(self._proxyGroupId)
 		PhysicsService:UnregisterCollisionGroup(self._bodypartGroupId)
 		self.Destroyed:Fire()
 		self.Destroyed:Destroy()
@@ -863,47 +858,12 @@ do
 	end
 	function Falldown:constructor()
 	end
-	function Falldown:MakeProxies(bodyPartMap, proxyGroupId, bodypartGroupId, owner)
-		PhysicsService:RegisterCollisionGroup(proxyGroupId)
+	function Falldown:SetupCollisionGroup(bodyPartMap, bodypartGroupId)
 		PhysicsService:RegisterCollisionGroup(bodypartGroupId)
-		PhysicsService:CollisionGroupSetCollidable(proxyGroupId, bodypartGroupId, false)
-		PhysicsService:CollisionGroupSetCollidable(proxyGroupId, "Default", true)
-		PhysicsService:CollisionGroupSetCollidable(bodypartGroupId, "Default", false)
 		PhysicsService:CollisionGroupSetCollidable(bodypartGroupId, bodypartGroupId, false)
-		local proxyMap = {}
-		for partName, originalPart in bodyPartMap do
-			local proxyPart = Instance.new("Part")
-			proxyPart.Name = partName .. "_Colprox"
-			proxyPart.Size = originalPart.Size
-			proxyPart.Transparency = 1
-			proxyPart.CastShadow = false
-			proxyPart.CanCollide = true
-			proxyPart.CanQuery = false
-			proxyPart.CanTouch = false
-			proxyPart.Anchored = false
-			proxyPart.Massless = false
-			proxyPart.CFrame = originalPart.CFrame
-			proxyPart.CustomPhysicalProperties = PhysicalProperties.new(1, 2, 0, 1, 1)
-			if partName == "HumanoidRootPart" then
-				proxyPart.CanCollide = false
-			end
-			local weld = Instance.new("Weld")
-			weld.Name = partName .. "_Colprox_Weld"
-			weld.Part0 = originalPart
-			weld.Part1 = proxyPart
-			weld.C0 = CFrame.identity
-			weld.Parent = proxyPart
-			proxyPart.Parent = Workspace
-			if not proxyPart.Anchored then
-				pcall(function()
-					proxyPart:SetNetworkOwner(owner)
-				end)
-			end
-			proxyPart.CollisionGroup = proxyGroupId
+		for _, originalPart in bodyPartMap do
 			originalPart.CollisionGroup = bodypartGroupId
-			proxyMap[partName] = proxyPart
 		end
-		return proxyMap
 	end
 	function Falldown:CreateActiveRagdollR6(character, humanoid, standFadeTime, automaticDuration, exitMode, getupFront, getupBack)
 		local leftArm = character:FindFirstChild("Left Arm")
@@ -937,19 +897,15 @@ do
 		BodyPartMapping.Head = head
 		BodyPartMapping.HumanoidRootPart = humanoidRootPart
 		local owner = Players:GetPlayerFromCharacter(character)
-		local proxyGroupId = HttpService:GenerateGUID(false)
 		local bodypartGroupId = HttpService:GenerateGUID(false)
 		for _1, descendant in character:GetDescendants() do
-			if descendant:IsA("BasePart") then
-				if not descendant.Anchored then
-					pcall(function()
-						descendant:SetNetworkOwner(owner)
-					end)
-				end
-				descendant.CollisionGroup = bodypartGroupId
+			if descendant:IsA("BasePart") and not descendant.Anchored then
+				pcall(function()
+					descendant:SetNetworkOwner(owner)
+				end)
 			end
 		end
-		local ProxyMapping = self:MakeProxies(BodyPartMapping, proxyGroupId, bodypartGroupId, owner)
+		self:SetupCollisionGroup(BodyPartMapping, bodypartGroupId)
 		humanoid:SetStateEnabled(Enum.HumanoidStateType.Jumping, false)
 		humanoid:SetStateEnabled(Enum.HumanoidStateType.GettingUp, false)
 		humanoid.PlatformStand = true
@@ -1088,14 +1044,6 @@ do
 			joint.UpperAngle = info.Info.UpperAngle
 			joint.TwistUpperAngle = info.Info.TwistUpperAngle
 			joint.TwistLowerAngle = info.Info.TwistLowerAngle
-			local proxyNoCol0 = Instance.new("NoCollisionConstraint")
-			proxyNoCol0.Name = constraintName .. "_NoColProxyOnly"
-			local _name = part0.Name
-			proxyNoCol0.Parent = ProxyMapping[_name]
-			local _name_1 = part0.Name
-			proxyNoCol0.Part0 = ProxyMapping[_name_1]
-			local _name_2 = part1.Name
-			proxyNoCol0.Part1 = ProxyMapping[_name_2]
 			replacing.Enabled = false
 			local _arg0 = {
 				Attachment0 = at0,
@@ -1118,14 +1066,6 @@ do
 			weld.Parent = part0
 			weld.Part0 = part0
 			weld.Part1 = part1
-			local proxyNoCol0 = Instance.new("NoCollisionConstraint")
-			proxyNoCol0.Name = constraintName .. "_NoColProxyOnly"
-			local _name = part0.Name
-			proxyNoCol0.Parent = ProxyMapping[_name]
-			local _name_1 = part0.Name
-			proxyNoCol0.Part0 = ProxyMapping[_name_1]
-			local _name_2 = part1.Name
-			proxyNoCol0.Part1 = ProxyMapping[_name_2]
 			replacing.Enabled = false
 			local _arg0 = {
 				Attachment0 = nil,
@@ -1148,7 +1088,7 @@ do
 			end
 		end
 		humanoid.EvaluateStateMachine = false
-		return ActiveRagdoll.new(character, height, standFadeTime, humanoid, humanoidRootPart, leftLeg, rightLeg, destructionInfo, proxyGroupId, bodypartGroupId, ProxyMapping, automaticDuration, exitMode, getupFrontTrack, getupBackTrack)
+		return ActiveRagdoll.new(character, height, standFadeTime, humanoid, humanoidRootPart, leftLeg, rightLeg, destructionInfo, bodypartGroupId, automaticDuration, exitMode, getupFrontTrack, getupBackTrack)
 	end
 	function Falldown:CreateActiveRagdollR15(character, humanoid, standFadeTime, automaticDuration, exitMode, getupFront, getupBack)
 		local leftUpperArm = character:FindFirstChild("LeftUpperArm")
@@ -1200,19 +1140,15 @@ do
 		BodyPartMapping.Head = head
 		BodyPartMapping.HumanoidRootPart = humanoidRootPart
 		local owner = Players:GetPlayerFromCharacter(character)
-		local proxyGroupId = HttpService:GenerateGUID(false)
 		local bodypartGroupId = HttpService:GenerateGUID(false)
 		for _1, descendant in character:GetDescendants() do
-			if descendant:IsA("BasePart") then
-				if not descendant.Anchored then
-					pcall(function()
-						descendant:SetNetworkOwner(owner)
-					end)
-				end
-				descendant.CollisionGroup = bodypartGroupId
+			if descendant:IsA("BasePart") and not descendant.Anchored then
+				pcall(function()
+					descendant:SetNetworkOwner(owner)
+				end)
 			end
 		end
-		local ProxyMapping = self:MakeProxies(BodyPartMapping, proxyGroupId, bodypartGroupId, owner)
+		self:SetupCollisionGroup(BodyPartMapping, bodypartGroupId)
 		humanoid:SetStateEnabled(Enum.HumanoidStateType.Jumping, false)
 		humanoid:SetStateEnabled(Enum.HumanoidStateType.GettingUp, false)
 		humanoid.PlatformStand = true
@@ -1505,14 +1441,6 @@ do
 			joint.UpperAngle = info.Info.UpperAngle
 			joint.TwistUpperAngle = info.Info.TwistUpperAngle
 			joint.TwistLowerAngle = info.Info.TwistLowerAngle
-			local proxyNoCol0 = Instance.new("NoCollisionConstraint")
-			proxyNoCol0.Name = constraintName .. "_NoColProxyOnly"
-			local _name = part0.Name
-			proxyNoCol0.Parent = ProxyMapping[_name]
-			local _name_1 = part0.Name
-			proxyNoCol0.Part0 = ProxyMapping[_name_1]
-			local _name_2 = part1.Name
-			proxyNoCol0.Part1 = ProxyMapping[_name_2]
 			replacing.Enabled = false
 			local _arg0 = {
 				Attachment0 = at0,
@@ -1547,14 +1475,6 @@ do
 			joint.LimitsEnabled = info.Info.LimitsEnabled
 			joint.UpperAngle = info.Info.UpperAngle
 			joint.LowerAngle = info.Info.LowerAngle
-			local proxyNoCol0 = Instance.new("NoCollisionConstraint")
-			proxyNoCol0.Name = constraintName .. "_NoColProxyOnly"
-			local _name = part0.Name
-			proxyNoCol0.Parent = ProxyMapping[_name]
-			local _name_1 = part0.Name
-			proxyNoCol0.Part0 = ProxyMapping[_name_1]
-			local _name_2 = part1.Name
-			proxyNoCol0.Part1 = ProxyMapping[_name_2]
 			replacing.Enabled = false
 			local _arg0 = {
 				Attachment0 = at0,
@@ -1577,14 +1497,6 @@ do
 			weld.Parent = part0
 			weld.Part0 = part0
 			weld.Part1 = part1
-			local proxyNoCol0 = Instance.new("NoCollisionConstraint")
-			proxyNoCol0.Name = constraintName .. "_NoColProxyOnly"
-			local _name = part0.Name
-			proxyNoCol0.Parent = ProxyMapping[_name]
-			local _name_1 = part0.Name
-			proxyNoCol0.Part0 = ProxyMapping[_name_1]
-			local _name_2 = part1.Name
-			proxyNoCol0.Part1 = ProxyMapping[_name_2]
 			replacing.Enabled = false
 			local _arg0 = {
 				Attachment0 = nil,
@@ -1607,7 +1519,7 @@ do
 			end
 		end
 		humanoid.EvaluateStateMachine = false
-		return ActiveRagdoll.new(character, height, standFadeTime, humanoid, humanoidRootPart, leftFoot, rightFoot, destructionInfo, proxyGroupId, bodypartGroupId, ProxyMapping, automaticDuration, exitMode, getupFrontTrack, getupBackTrack)
+		return ActiveRagdoll.new(character, height, standFadeTime, humanoid, humanoidRootPart, leftFoot, rightFoot, destructionInfo, bodypartGroupId, automaticDuration, exitMode, getupFrontTrack, getupBackTrack)
 	end
 	function Falldown:RagdollCharacter(character, standupFadeTime, automaticDuration, exitMode, getupFront, getupBack)
 		local __activeRagdolls = self._activeRagdolls

package/package.json

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