@quenty/camera 14.22.1 → 14.22.2-canary.675e877.0

package/CHANGELOG.md

@@ -3,6 +3,24 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+## [14.22.2-canary.675e877.0](https://github.com/Quenty/NevermoreEngine/compare/@quenty/camera@14.22.1...@quenty/camera@14.22.2-canary.675e877.0) (2025-08-07)
+
+
+### Bug Fixes
+
+* Fix formatting ([41ceadb](https://github.com/Quenty/NevermoreEngine/commit/41ceadbc674b7860d8593019b5dc5d4cbe539deb))
+* Setting RobloxCFrame also assigns the override CFrame ([1014f69](https://github.com/Quenty/NevermoreEngine/commit/1014f69cce67eda8cde99f7cb7b4243a83ec9fba))
+
+
+### Features
+
+* Add CameraSubjectUtils ([5e32c47](https://github.com/Quenty/NevermoreEngine/commit/5e32c47a1cec33ca903c9f558463fffbc8f2daf4))
+* Add epsilon ([9f61ef3](https://github.com/Quenty/NevermoreEngine/commit/9f61ef3c7fdfc8b7ffc65c592873fd960a5ef126))
+
+
+
+
+
 ## [14.22.1](https://github.com/Quenty/NevermoreEngine/compare/@quenty/camera@14.22.0...@quenty/camera@14.22.1) (2025-07-14)
 
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@quenty/camera",
-  "version": "14.22.1",
+  "version": "14.22.2-canary.675e877.0",
   "description": "Quenty's camera system for Roblox",
   "keywords": [
     "Roblox",
@@ -25,27 +25,27 @@
     "Quenty"
   ],
   "dependencies": {
-    "@quenty/acceltween": "^2.5.3",
-    "@quenty/baseobject": "^10.9.0",
-    "@quenty/cframeutils": "^5.5.3",
-    "@quenty/cubicspline": "^10.9.0",
-    "@quenty/ducktype": "^5.9.0",
-    "@quenty/inputobjectutils": "^4.19.0",
-    "@quenty/loader": "^10.9.0",
-    "@quenty/maid": "^3.5.0",
-    "@quenty/math": "^2.7.3",
-    "@quenty/qframe": "^10.11.0",
-    "@quenty/rx": "^13.18.0",
-    "@quenty/servicebag": "^11.13.0",
-    "@quenty/spring": "^10.9.0",
-    "@quenty/valueobject": "^13.18.0",
-    "@quenty/vector3utils": "^10.9.0"
+    "@quenty/acceltween": "2.5.3",
+    "@quenty/baseobject": "10.9.0",
+    "@quenty/cframeutils": "5.5.3",
+    "@quenty/cubicspline": "10.9.0",
+    "@quenty/ducktype": "5.9.0",
+    "@quenty/inputobjectutils": "4.19.0",
+    "@quenty/loader": "10.9.0",
+    "@quenty/maid": "3.5.0",
+    "@quenty/math": "2.7.3",
+    "@quenty/qframe": "10.11.0",
+    "@quenty/rx": "13.18.0",
+    "@quenty/servicebag": "11.13.0",
+    "@quenty/spring": "10.9.0",
+    "@quenty/valueobject": "13.18.0",
+    "@quenty/vector3utils": "10.9.0"
   },
   "devDependencies": {
-    "@quenty/camerastoryutils": "^10.11.0"
+    "@quenty/camerastoryutils": "10.11.0"
   },
   "publishConfig": {
     "access": "public"
   },
-  "gitHead": "b37dbb03d406fe0bce6d4f9c2fd99f1be2e459e5"
+  "gitHead": "675e87759fbcf0f346c264580e679725819353e3"
 }

package/src/Client/Effects/DefaultCamera.lua

@@ -91,6 +91,10 @@ DefaultCamera.OverrideCameraState = DefaultCamera.SetRobloxCameraState
 ]=]
 function DefaultCamera.SetRobloxCFrame(self: DefaultCamera, cframe: CFrame)
 	self._cameraState.CFrame = cframe
+
+	if self._lastCameraFrame then
+		self._lastCameraFrame.CFrame = cframe
+	end
 end
 
 --[=[

package/src/Client/Effects/FadeBetween/FadeBetweenCamera3.lua

@@ -30,6 +30,7 @@ export type FadeBetweenCamera3 = typeof(setmetatable(
 		Speed: number,
 		Velocity: number,
 		Target: number,
+		Epsilon: number?,
 	},
 	{} :: typeof({ __index = FadeBetweenCamera3 })
 )) & CameraEffectUtils.CameraEffect
@@ -73,7 +74,7 @@ function FadeBetweenCamera3:__newindex(index, value)
 		self._spring.Target = value
 	elseif index == "Velocity" then
 		self._spring.Velocity = value
-	elseif index == "CameraA" or index == "CameraB" then
+	elseif index == "CameraA" or index == "CameraB" or index == "Epsilon" then
 		rawset(self, index, value)
 	else
 		error(string.format("%q is not a valid member of FadeBetweenCamera3", tostring(index)))
@@ -88,7 +89,7 @@ end
 ]=]
 function FadeBetweenCamera3:__index(index)
 	if index == "CameraState" then
-		local _, t = SpringUtils.animating(self._spring)
+		local _, t = SpringUtils.animating(self._spring, rawget(self, "Epsilon"))
 		if t == 0 then
 			return self.CameraStateA
 		elseif t == 1 then
@@ -146,24 +147,26 @@ function FadeBetweenCamera3:__index(index)
 	elseif index == "Damper" then
 		return self._spring.Damper
 	elseif index == "Value" then
-		local _, t = SpringUtils.animating(self._spring)
+		local _, t = SpringUtils.animating(self._spring, rawget(self, "Epsilon"))
 		return t
 	elseif index == "Speed" then
 		return self._spring.Speed
 	elseif index == "Target" then
 		return self._spring.Target
 	elseif index == "Velocity" then
-		local animating = SpringUtils.animating(self._spring)
+		local animating = SpringUtils.animating(self._spring, rawget(self, "Epsilon"))
 		if animating then
 			return self._spring.Velocity
 		else
 			return 0
 		end
 	elseif index == "HasReachedTarget" then
-		local animating = SpringUtils.animating(self._spring)
+		local animating = SpringUtils.animating(self._spring, rawget(self, "Epsilon"))
 		return not animating
 	elseif index == "Spring" then
 		return self._spring
+	elseif index == "Epsilon" then
+		return rawget(self, "Epsilon")
 	elseif FadeBetweenCamera3[index] then
 		return FadeBetweenCamera3[index]
 	else

package/src/Client/Utility/CameraStateTweener.lua

@@ -156,6 +156,10 @@ function CameraStateTweener.GetCameraBelow(self: CameraStateTweener): CameraEffe
 	return self._cameraBelow
 end
 
+function CameraStateTweener:SetEpsilon(epsilon: number?)
+	self._fadeBetween.Epsilon = epsilon
+end
+
 --[=[
 	Sets the percent visible target
 	@param target number

package/src/Client/Utility/CameraSubjectUtils.lua

@@ -0,0 +1,68 @@
+--[=[
+	@class CameraSubjectUtils
+]=]
+
+local CameraSubjectUtils = {}
+
+local HEAD_OFFSET = Vector3.new(0, 1.5, 0)
+local R15_HEAD_OFFSET = Vector3.new(0, 1.5, 0)
+local R15_HEAD_OFFSET_NO_SCALING = Vector3.new(0, 2, 0)
+local HUMANOID_ROOT_PART_SIZE = Vector3.new(2, 2, 1)
+
+--[=[
+	Follows the same logic as Roblox's default camera
+]=]
+function CameraSubjectUtils.getRobloxCameraSubjectCFrame(cameraSubject: Instance): CFrame?
+	if cameraSubject:IsA("Humanoid") then
+		local humanoid = cameraSubject
+		local humanoidIsDead = humanoid:GetState() == Enum.HumanoidStateType.Dead
+
+		local cameraOffset = humanoid.CameraOffset
+		local bodyPartToFollow: BasePart? = humanoid.RootPart
+
+		-- If the humanoid is dead, prefer their head part as a follow target, if it exists
+		if humanoidIsDead then
+			if humanoid.Parent and humanoid.Parent:IsA("Model") then
+				bodyPartToFollow = (humanoid.Parent:FindFirstChild("Head") :: BasePart) or bodyPartToFollow
+			end
+		end
+
+		if bodyPartToFollow and bodyPartToFollow:IsA("BasePart") then
+			local heightOffset
+			if humanoid.RigType == Enum.HumanoidRigType.R15 then
+				if humanoid.AutomaticScalingEnabled then
+					heightOffset = R15_HEAD_OFFSET
+
+					local rootPart = humanoid.RootPart
+					if bodyPartToFollow == rootPart then
+						local rootPartSizeOffset = (rootPart.Size.Y - HUMANOID_ROOT_PART_SIZE.Y) / 2
+						heightOffset = heightOffset + Vector3.new(0, rootPartSizeOffset, 0)
+					end
+				else
+					heightOffset = R15_HEAD_OFFSET_NO_SCALING
+				end
+			else
+				heightOffset = HEAD_OFFSET
+			end
+
+			if humanoidIsDead then
+				heightOffset = Vector3.zero
+			end
+
+			return bodyPartToFollow.CFrame * CFrame.new(heightOffset + cameraOffset)
+		end
+	elseif cameraSubject:IsA("BasePart") then
+		return cameraSubject.CFrame
+	elseif cameraSubject:IsA("Model") then
+		-- Model subjects are expected to have a PrimaryPart to determine orientation
+		if cameraSubject.PrimaryPart then
+			return (cameraSubject :: any):GetPrimaryPartCFrame()
+		else
+			return nil
+		end
+	end
+
+	return nil
+end
+
+return CameraSubjectUtils