@rbxts/falldown 1.1.8 → 1.2.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,13 @@ 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()
+		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)
@@ -832,6 +839,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()
@@ -861,6 +871,7 @@ do
 	function Falldown:SetupCollisionGroup(bodyPartMap, bodypartGroupId)
 		PhysicsService:RegisterCollisionGroup(bodypartGroupId)
 		PhysicsService:CollisionGroupSetCollidable(bodypartGroupId, bodypartGroupId, false)
+		PhysicsService:CollisionGroupSetCollidable(bodypartGroupId, "Debris", false)
 		for partName, originalPart in bodyPartMap do
 			originalPart.CollisionGroup = bodypartGroupId
 			if partName ~= "HumanoidRootPart" then
@@ -1643,6 +1654,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.8",
+  "version": "1.2.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": {