Enhance grapple flight physics and max shoot distance

Introduces a maximum shooting distance, stopping the grapple hook if it doesn't attach within this range.

Applies full rope physics simulation during the hook's flight phase, leading to more realistic rope behavior before attachment.
If the player moves away while the airborne hook is at its maximum extension, the player is now pulled to maintain rope tension.

Consolidates and refines the logic for handling rope length limits.

Author: OpenTools-run

Data/Base.rte/Devices/Tools/GrappleGun/Grapple.lua

@@ -22,6 +22,7 @@ function Create(self)
 
     self.fireVel = 40      -- This immediately overwrites the .ini FireVel
     self.maxLineLength = 400   -- Shorter rope for faster gameplay
+    self.maxShootDistance = self.maxLineLength * 0.95 -- 95% of maxLineLength (5% less shooting distance)
     self.setLineLength = 0
     self.lineStrength = 10000 -- EXTREMELY HIGH force threshold - virtually unbreakable (was 120)
 
@@ -134,17 +135,30 @@ function Update(self)
 					self.lineLength = self.lineVec.Magnitude
 					self.currentLineLength = self.lineLength
 
+					-- Check if we\'ve reached the maximum shooting distance during flight
+					if self.lineLength >= self.maxShootDistance then
+						-- Stop the claw at max shooting distance but keep it in flight mode
+						local maxShootVec = self.lineVec:SetMagnitude(self.maxShootDistance)
+						self.Pos = self.parent.Pos + maxShootVec
+						self.Vel = Vector(0, 0) -- Stop the claw
+						self.currentLineLength = self.maxShootDistance
+						self.limitReached = true
+						-- Keep actionMode = 1 (flight) so it can still detect collisions
+						self.clickSound:Play(self.parent.Pos)
+					end
+					
 					-- Update rope anchor points directly for flight mode
 					self.apx[0] = self.parent.Pos.X
 					self.apy[0] = self.parent.Pos.Y
 					self.apx[self.currentSegments] = self.Pos.X
 					self.apy[self.currentSegments] = self.Pos.Y
 
 					-- Set all lastX/lastY positions to prevent velocity inheritance from previous mode
-					for i = 0, self.currentSegments do
-						self.lastX[i] = self.apx[i]
-						self.lastY[i] = self.apy[i]
-					end
+					-- Commenting out this loop allows for rope physics during flight
+					-- for i = 0, self.currentSegments do
+					-- 	self.lastX[i] = self.apx[i]
+					-- 	self.lastY[i] = self.apy[i]
+					-- end
 				end
 
 				-- Calculate optimal number of segments based on rope length using our module function
@@ -161,28 +175,22 @@ function Update(self)
 				-- Proper rope physics simulation using the RopePhysics module
 				local endPos = self.Pos
 
-				-- Choose physics simulation based on rope mode
-				if self.actionMode == 1 then
-					-- Flight mode - keep rope tight and straight
-					RopePhysics.updateRopeFlightPath(self)
-				else
-					-- Attached mode - run full physics simulation
-					RopePhysics.updateRopePhysics(self, startPos, endPos, self.currentLineLength)
-					
-					-- Apply constraints and check for rope breaking (extremely high threshold)
-					local ropeBreaks = RopePhysics.applyRopeConstraints(self, self.currentLineLength)
-					if ropeBreaks or self.shouldBreak then
-						-- Rope snapped due to EXTREME tension (500% stretch)
-						self.ToDelete = true
-						if self.parent and self.parent:IsPlayerControlled() then
-							-- Add screen shake and sound effect when rope breaks
-							FrameMan:SetScreenScrollSpeed(10.0) -- More dramatic shake for extreme break
-							if self.returnSound then
-								self.returnSound:Play(self.parent.Pos)
-							end
+				-- Use full rope physics simulation for both flight and attached modes
+				RopePhysics.updateRopePhysics(self, startPos, endPos, self.currentLineLength)
+				
+				-- Apply constraints and check for rope breaking (extremely high threshold)
+				local ropeBreaks = RopePhysics.applyRopeConstraints(self, self.currentLineLength)
+				if ropeBreaks or self.shouldBreak then
+					-- Rope snapped due to EXTREME tension (500% stretch)
+					self.ToDelete = true
+					if self.parent and self.parent:IsPlayerControlled() then
+						-- Add screen shake and sound effect when rope breaks
+						FrameMan:SetScreenScrollSpeed(10.0) -- More dramatic shake for extreme break
+						if self.returnSound then
+							self.returnSound:Play(self.parent.Pos)
 						end
-						return -- Exit early since rope is breaking
 					end
+					return -- Exit early since rope is breaking
 				end
 
 				-- Special handling for attached targets (MO grabbing)
@@ -237,16 +245,15 @@ function Update(self)
 					self.setLineLength = self.currentLineLength
 				end
 
-				-- Single length limit check - removed redundant checkLineLengthUpdate call
+				-- Single length limit check - now handled during flight phase
 				if self.currentLineLength > self.maxLineLength then
 					self.currentLineLength = self.maxLineLength
 					self.setLineLength = self.maxLineLength
-					if not self.limitReached then
-						self.limitReached = true
-						self.clickSound:Play(self.parent.Pos)
-					end
+					-- limitReached is now set during flight phase
 				else
-					self.limitReached = false
+					if self.actionMode > 1 then  -- Only reset limit flag when attached, not during flight
+						self.limitReached = false
+					end
 				end
 
 				if self.parentGun and self.parentGun.ID ~= rte.NoMOID then

Data/Base.rte/Devices/Tools/GrappleGun/Scripts/RopePhysics.lua

@@ -307,7 +307,8 @@ function RopePhysics.applyRopeConstraints(grappleInstance, currentTotalCableLeng
         local constraintDirection = ropeVector:SetMagnitude(1)
 
         -- Check if hook is anchored (attached to terrain or MO)
-        if grappleInstance.actionMode >= 2 then
+        -- if grappleInstance.actionMode >= 2 then  -- Original condition
+        if grappleInstance.actionMode == 2 then -- Changed: Actor anchored to claw only in mode 2
             -- Hook is anchored - apply PROPER SWINGING CONSTRAINT
             -- This allows free tangential movement (swinging) while constraining radial movement
 
@@ -351,8 +352,25 @@ function RopePhysics.applyRopeConstraints(grappleInstance, currentTotalCableLeng
                 grappleInstance.apx[0] = grappleInstance.parent.Pos.X
                 grappleInstance.apy[0] = grappleInstance.parent.Pos.Y
             end
+        elseif grappleInstance.actionMode == 1 then -- Added: Claw anchored to actor in mode 1
+            -- Hook is in flight, anchor it to the player
+            local correctionVector = constraintDirection * excessDistance
+            -- Move the player instead of the hook
+            grappleInstance.parent.Pos = grappleInstance.parent.Pos + correctionVector
+            -- Update rope anchor to match corrected player position
+            grappleInstance.apx[0] = grappleInstance.parent.Pos.X
+            grappleInstance.apy[0] = grappleInstance.parent.Pos.Y
+
+            -- Clear any tension forces since rope is not under tension
+            grappleInstance.ropeTensionForce = nil
+            grappleInstance.ropeTensionDirection = nil
+
+            -- Recalculate after constraint
+            playerPos = grappleInstance.parent.Pos -- update playerPos for subsequent calculations
+            ropeVector = SceneMan:ShortestDistance(playerPos, hookPos, grappleInstance.mapWrapsX)
+            totalRopeDistance = ropeVector.Magnitude
         else
-            -- Hook is in flight - we can move it to maintain rope length
+            -- Hook is in flight - we can move it to maintain rope length (default case)
             local correctionVector = constraintDirection * excessDistance
             grappleInstance.apx[segments] = grappleInstance.apx[segments] - correctionVector.X
             grappleInstance.apy[segments] = grappleInstance.apy[segments] - correctionVector.Y

Data/Base.rte/Devices/Tools/GrappleGun/Scripts/RopeStateManager.lua

@@ -64,6 +64,10 @@ function RopeStateManager.checkAttachmentCollisions(grappleInstance)
         grappleInstance.Vel = Vector() -- Stop the hook
         grappleInstance.PinStrength = 1000
         grappleInstance.Frame = 1 -- Change appearance
+        
+        -- Reset rope physics initialization when transitioning from flight to attached
+        grappleInstance.ropePhysicsInitialized = false
+        grappleInstance.limitReached = false -- Reset limit when attaching
     end
 
     return stateChanged
@@ -72,6 +76,14 @@ end
 -- Handle exceeding maximum length - SIMPLIFIED VERSION
 -- Main length control is now centralized in Grapple.lua
 function RopeStateManager.checkLengthLimit(grappleInstance)
+    -- During flight, the claw automatically stops at max rope length
+    -- This function now mainly handles attached mode length limits
+    if grappleInstance.actionMode == 1 then
+        -- Flight mode - length limit is handled in main Grapple.lua Update function
+        return grappleInstance.limitReached
+    end
+    
+    -- Attached mode - check if rope is at maximum length
     if grappleInstance.lineLength > grappleInstance.maxLineLength then
         if grappleInstance.limitReached == false then
             grappleInstance.limitReached = true