@quenty/humanoidteleportutils 8.0.0 → 9.0.0

package/CHANGELOG.md

@@ -3,6 +3,17 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# [9.0.0](https://github.com/Quenty/NevermoreEngine/compare/@quenty/humanoidteleportutils@8.0.0...@quenty/humanoidteleportutils@9.0.0) (2024-02-13)
+
+
+### Features
+
+* Allow full character teleportation ([190ba96](https://github.com/Quenty/NevermoreEngine/commit/190ba96af390db1188693c4f2f59150551e582d3))
+
+
+
+
+
 # [8.0.0](https://github.com/Quenty/NevermoreEngine/compare/@quenty/humanoidteleportutils@7.3.0...@quenty/humanoidteleportutils@8.0.0) (2024-02-13)
 
 **Note:** Version bump only for package @quenty/humanoidteleportutils

package/LICENSE.md

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2014-2023 James Onnen (Quenty)
+Copyright (c) 2014-2024 James Onnen (Quenty)
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@quenty/humanoidteleportutils",
-  "version": "8.0.0",
+  "version": "9.0.0",
   "description": "Utility for teleporting humanoids",
   "keywords": [
     "Roblox",
@@ -25,11 +25,11 @@
     "Quenty"
   ],
   "dependencies": {
-    "@quenty/loader": "^8.0.0",
+    "@quenty/loader": "^9.0.0",
     "@quenty/raycaster": "^3.2.0"
   },
   "publishConfig": {
     "access": "public"
   },
-  "gitHead": "5736b108e4d23cd4c9e761bbe4cc9fed6fb32dfa"
+  "gitHead": "f113de0adce246ebd8115adf49a80533ede329cc"
 }

package/src/Shared/HumanoidTeleportUtils.lua

@@ -75,6 +75,38 @@ function HumanoidTeleportUtils.teleportRootPart(humanoid, rootPart, position)
 	rootPart.CFrame = rootPart.CFrame - rootPart.Position + position + offset
 end
 
+--[=[
+	Teleports a humanoid to a given location including all attached parts
+
+	@param humanoid Humanoid
+	@param rootPart BasePart
+	@param parts { BasePart }
+	@param position Vector3
+]=]
+function HumanoidTeleportUtils.teleportParts(humanoid, rootPart, parts, position)
+	assert(typeof(humanoid) == "Instance" and humanoid:IsA("Humanoid"), "Bad humanoid")
+	assert(typeof(rootPart) == "Instance" and rootPart:IsA("BasePart"), "Bad rootPart")
+	assert(type(parts) == "table", "Bad parts")
+	assert(typeof(position) == "Vector3", "Bad position")
+
+	local offset = HumanoidTeleportUtils.getRootPartOffset(humanoid, rootPart)
+	local rootPartCFrame = rootPart.CFrame
+	local newRootPartCFrame = rootPartCFrame - rootPartCFrame.Position + position + offset
+
+	local relCFrame = {}
+	for _, part in pairs(parts) do
+		relCFrame[part] = rootPartCFrame:toObjectSpace(part.CFrame)
+	end
+
+	relCFrame[rootPart] = nil
+
+	for part, relative in pairs(relCFrame) do
+		part.CFrame = newRootPartCFrame:toWorldSpace(relative)
+	end
+
+	rootPart.CFrame = newRootPartCFrame
+end
+
 --[=[
 	Tries to teleport the character to a given position