-- modules/rig.lua -- R6 rig helper: clone, map Motor6Ds, create attachments for head/hands, basic rig setup -- Designed for local-player usage in VR (R6 rigs only) local Rig = {} Rig.__index = Rig local Players = game:GetService("Players") local function findMotor6D(part, name) for _, c in ipairs(part:GetChildren()) do if c:IsA("Motor6D") and c.Name == name then return c end end return nil end function Rig.new(character) assert(character, "Character required") local self = setmetatable({}, Rig) self.character = character self.humanoid = character:FindFirstChildOfClass("Humanoid") assert(self.humanoid and self.humanoid.RigType == Enum.HumanoidRigType.R6, "R6 rig required") -- map Motor6Ds self.motors = {} -- common R6 motor names local motorNames = { "Neck", "Right Shoulder", "Left Shoulder", "Right Hip", "Left Hip", "RootJoint", "Right Elbow", "Left Elbow" } for _, name in ipairs(motorNames) do -- search whole character for _, part in ipairs(character:GetDescendants()) do if part:IsA("Motor6D") and part.Name == name then self.motors[name] = part end end end -- ensure Neck exists self.neck = self.motors.Neck -- create attachments for head and hands for easier transforms self.attachments = {} local function ensureAttachment(parent, attName, cframe) local existing = parent:FindFirstChild(attName) if existing and existing:IsA("Attachment") then return existing end local att = Instance.new("Attachment") att.Name = attName if cframe then att.Transform = cframe end att.Parent = parent return att end local head = character:FindFirstChild("Head") local torso = character:FindFirstChild("Torso") or character:FindFirstChild("UpperTorso") or character:FindFirstChild("HumanoidRootPart") local rightHand = character:FindFirstChild("Right Arm") or character:FindFirstChild("RightHand") local leftHand = character:FindFirstChild("Left Arm") or character:FindFirstChild("LeftHand") if head then self.attachments.Head = ensureAttachment(head, "VR_Head") end if rightHand then self.attachments.RightHand = ensureAttachment(rightHand, "VR_RightHand") end if leftHand then self.attachments.LeftHand = ensureAttachment(leftHand, "VR_LeftHand") end if torso then self.attachments.Torso = ensureAttachment(torso, "VR_Torso") end -- store initial motor C0 snapshots for restoration self.initialC0 = {} for name, motor in pairs(self.motors) do self.initialC0[name] = motor.C0 end return self end function Rig:setNeckC0(cframe) if self.neck then self.neck.C0 = cframe end end function Rig:setMotorC0(name, c0) local motor = self.motors[name] if motor then motor.C0 = c0 end end function Rig:getAttachment(name) return self.attachments[name] end function Rig:restoreInitial() for name, motor in pairs(self.motors) do if self.initialC0[name] then motor.C0 = self.initialC0[name] end end end return Rig -- modules/joint_editor.lua -- Safe Motor6D C0/C1 editing utilities with smoothing support local JointEditor = {} JointEditor.__index = JointEditor local TweenService = game:GetService("TweenService") local RunService = game:GetService("RunService") -- Smoothly tween a Motor6D C0 to target CFrame function JointEditor.tweenC0(motor, targetC0, time, easingStyle, easingDirection) if not motor or not motor:IsA("Motor6D") then return end time = time or 0.12 easingStyle = easingStyle or Enum.EasingStyle.Quad easingDirection = easingDirection or Enum.EasingDirection.Out -- Motor6D C0 cannot be tweened directly; tween a Vector3 and Quaternion via Attributes on a dummy local proxy = Instance.new("Part") proxy.Transparency = 1 proxy.Anchored = true proxy.CanCollide = false proxy.CastShadow = false proxy.Parent = workspace local current = motor.C0 proxy.CFrame = current local tweenInfo = TweenInfo.new(time, easingStyle, easingDirection) local tween = TweenService:Create(proxy, tweenInfo, {CFrame = targetC0}) tween:Play() tween.Completed:Wait() motor.C0 = proxy.CFrame proxy:Destroy() end -- Directly set motor C0 without smoothing function JointEditor.setC0(motor, c0) if not motor or not motor:IsA("Motor6D") then return end motor.C0 = c0 end -- Blend motor C0 between two CFrames by alpha function JointEditor.blendC0(motor, fromC0, toC0, alpha) if not motor or not motor:IsA("Motor6D") then return end local newC0 = fromC0:Lerp(toC0, alpha) motor.C0 = newC0 end return JointEditor -- modules/gui_animator.lua -- VR GUI and hand indicator animations for local player local GUI = {} GUI.__index = GUI local TweenService = game:GetService("TweenService") local Players = game:GetService("Players") function GUI.new(player) local self = setmetatable({}, GUI) self.player = player self.gui = Instance.new("ScreenGui") self.gui.Name = "SSVR_GUI" self.gui.ResetOnSpawn = false self.gui.Parent = player:WaitForChild("PlayerGui") -- Crosshair local cross = Instance.new("ImageLabel") cross.Name = "Crosshair" cross.Size = UDim2.new(0, 32, 0, 32) cross.Position = UDim2.new(0.5, -16, 0.5, -16) cross.BackgroundTransparency = 1 cross.Image = "rbxassetid://3926305904" -- placeholder cross.Parent = self.gui self.cross = cross -- Fade frame (for teleport) local fade = Instance.new("Frame") fade.Name = "Fade" fade.Size = UDim2.new(1, 0, 1, 0) fade.Position = UDim2.new(0,0,0,0) fade.BackgroundColor3 = Color3.new(0,0,0) fade.BackgroundTransparency = 1 fade.ZIndex = 50 fade.Parent = self.gui self.fade = fade return self end function GUI:pulseCrosshair(intensity, time) intensity = intensity or 1 time = time or 0.2 local tweenInfo = TweenInfo.new(time, Enum.EasingStyle.Quad, Enum.EasingDirection.Out) TweenService:Create(self.cross, tweenInfo, {ImageTransparency = 1 - intensity, Size = UDim2.new(0, 32*intensity, 0, 32*intensity)}):Play() end function GUI:fadeOut(time) time = time or 0.3 TweenService:Create(self.fade, TweenInfo.new(time), {BackgroundTransparency = 0}):Play() end function GUI:fadeIn(time) time = time or 0.3 TweenService:Create(self.fade, TweenInfo.new(time), {BackgroundTransparency = 1}):Play() end return GUI -- modules/ik.lua -- Two-bone IK solver for R6 arms (upper arm, lower arm) -- Works by computing shoulder C0 rotation to reach hand target and rotate elbow via simple bend plane local IK = {} IK.__index = IK local function toCFrameAxes(cf) return cf.XVector, cf.YVector, cf.ZVector end local function angleBetween(a, b) return math.acos(math.clamp(a:Dot(b), -1, 1)) end -- Compute two-bone IK for positions in torso space -- shoulderPos, upperPos, lowerPos, handPos: Vector3 positions in world space (or shared space) -- upperLen, lowerLen: lengths of upper and lower arm -- bendDirection: Vector3 -- Returns shoulderRotationCFrame, elbowAngle (radians), solvedHandPosition function IK.solveTwoBone(shoulderPos, upperLen, lowerLen, targetPos, bendDirection) local toTarget = targetPos - shoulderPos local dist = toTarget.Magnitude -- clamp distance for reach local maxReach = upperLen + lowerLen local minReach = math.abs(upperLen - lowerLen) local clamped = math.clamp(dist, minReach + 1e-4, maxReach - 1e-4) -- Law of cosines for angles local cosAngle0 = (upperLen*upperLen + clamped*clamped - lowerLen*lowerLen) / (2 * upperLen * clamped) cosAngle0 = math.clamp(cosAngle0, -1, 1) local angle0 = math.acos(cosAngle0) -- angle at shoulder between upper arm and direction to target local cosAngle1 = (upperLen*upperLen + lowerLen*lowerLen - clamped*clamped) / (2 * upperLen * lowerLen) cosAngle1 = math.clamp(cosAngle1, -1, 1) local angle1 = math.acos(cosAngle1) -- elbow angle -- base orientation to look at target local look = CFrame.new(shoulderPos, targetPos) -- compute rotation to apply angle0 around bendDirection local bendAxis = bendDirection.Unit local shoulderRotation = CFrame.Angles(0, 0, 0) * CFrame.Angles(-angle0, 0, 0) -- final: use look * rotation where rotation attempts to bend on local X -- For robustness, we return look and angles for caller to convert to Motor6D C0s as needed return look, angle0, angle1 end -- Build a target C0 for a shoulder Motor6D from desired shoulderCFrame in torso space and baseC0 function IK.buildShoulderC0(baseC0, desiredWorldCFrame, rootCFrame) -- baseC0 is the initial Motor6D C0 (attachment frame from torso to upper arm) -- desiredWorldCFrame is the desired world CFrame for upper arm attachment -- rootCFrame is the torso world CFrame local relative = rootCFrame:ToObjectSpace(desiredWorldCFrame) -- Motor6D.C0 = relative return relative end return IK -- modules/input.lua -- VR input abstraction: headset & controllers; fallbacks to mouse/keyboard for testing -- Exposes :isVR(), :getHeadCFrame(), :getLeftCFrame(), :getRightCFrame() local Input = {} Input.__index = Input local RunService = game:GetService("RunService") local UserInputService = game:GetService("UserInputService") local success, VRService = pcall(function() return game:GetService("VRService") end) function Input.new() local self = setmetatable({}, Input) self.VR = success and VRService self.user = UserInputService self.fake = false self.fakeHead = CFrame.new(0, 5, 0) self.fakeLeft = CFrame.new(-0.3, 4.5, -0.5) self.fakeRight = CFrame.new(0.3, 4.5, -0.5) return self end function Input:isVR() return self.VR and self.VR.VREnabled end function Input:getHeadCFrame() if self:isVR() then local ok, cf = pcall(function() return self.VR:GetUserCFrameEnabled() and self.VR:GetUserCFrame(Enum.UserCFrame.Head) or workspace.CurrentCamera.CFrame end) if ok and cf then return cf end end -- fallback to camera return workspace.CurrentCamera and workspace.CurrentCamera.CFrame or self.fakeHead end function Input:getRightCFrame() if self:isVR() then local ok, cf = pcall(function() return self.VR:GetUserCFrame(Enum.UserCFrame.RightHand) end) if ok and cf then return cf end end -- fallback to mouse and camera relative local cam = workspace.CurrentCamera if cam then local mouse = self.user:GetMouseLocation() local nx = (mouse.X - (cam.ViewportSize.X/2))/cam.ViewportSize.X local ny = (mouse.Y - (cam.ViewportSize.Y/2))/cam.ViewportSize.Y local pos = cam.CFrame * CFrame.new(0, 0, -1) return pos * CFrame.new(0.4 + nx, -0.2 + ny, -0.4) end return self.fakeRight end function Input:getLeftCFrame() if self:isVR() then local ok, cf = pcall(function() return self.VR:GetUserCFrame(Enum.UserCFrame.LeftHand) end) if ok and cf then return cf end end -- fallback mirrored from right local rcf = self:getRightCFrame() return rcf * CFrame.new(-0.6, 0, 0) end return Input -- SSVR.lua -- Single entry script that composes modules to create a robust R6 VR system -- Place this in StarterPlayerScripts for local player behavior -- Modules: -- modules/rig.lua -- modules/joint_editor.lua -- modules/gui_animator.lua -- modules/ik.lua -- modules/input.lua local Players = game:GetService("Players") local RunService = game:GetService("RunService") local ReplicatedStorage = game:GetService("ReplicatedStorage") local Debris = game:GetService("Debris") local RigModule = require(script:FindFirstChild("modules") and script.modules:FindFirstChild("rig") or script:WaitForChild("modules"):WaitForChild("rig")) local JointEditor = require(script:FindFirstChild("modules") and script.modules:FindFirstChild("joint_editor") or script:WaitForChild("modules"):WaitForChild("joint_editor")) local GUIAnimator = require(script:FindFirstChild("modules") and script.modules:FindFirstChild("gui_animator") or script:WaitForChild("modules"):WaitForChild("gui_animator")) local IK = require(script:FindFirstChild("modules") and script.modules:FindFirstChild("ik") or script:WaitForChild("modules"):WaitForChild("ik")) local Input = require(script:FindFirstChild("modules") and script.modules:FindFirstChild("input") or script:WaitForChild("modules"):WaitForChild("input")) -- Setup modules folder convenience (for local testing if placed as single script) -- If running as stand-alone, ensure a 'modules' folder exists as children of this script -- If deployed in Roblox Studio as single ModuleScripts under a ModuleScript named "modules", adjust requires accordingly. local player = Players.LocalPlayer local character = player.Character or player.CharacterAdded:Wait() local input = Input.new() local rigHelper = RigModule.new(character) local gui = GUIAnimator.new(player) -- Arm lengths heuristics for R6 local function getArmLengths(char) local upper = 1 local lower = 1 local rightUpper = char:FindFirstChild("Right Arm") if rightUpper and rightUpper:IsA("BasePart") then upper = (rightUpper.Size.Magnitude) * 0.9 end local rightLower = rightUpper -- R6 has one arm part; approximate lower = upper * 0.9 return upper, lower end local upperLen, lowerLen = getArmLengths(character) -- Teleport helper local function teleportTo(position) local hrp = character:FindFirstChild("HumanoidRootPart") if hrp then hrp.CFrame = CFrame.new(position) * CFrame.new(0, 2, 0) end end -- Main update loop: apply head and hand transforms, run IK local RunUpdate do local lastDt = 0 RunUpdate = function(dt) lastDt = dt -- head local headCFrame = input:getHeadCFrame() -- map head to neck motor local neck = rigHelper.motors and rigHelper.motors.Neck if neck then -- compute desired neck C0 relative to Torso (assumes head part's CFrame is attached to the neck motor's Part0) local headPart = character:FindFirstChild("Head") local torsoPart = character:FindFirstChild("Torso") or character:FindFirstChild("UpperTorso") or character:FindFirstChild("HumanoidRootPart") if headPart and torsoPart then -- world desired head cframe -> convert to torso-space relative transform for neck.C0 local desiredNeckC0 = torsoPart.CFrame:ToObjectSpace(headCFrame) -- apply smoothing JointEditor.tweenC0(neck, desiredNeckC0, 0.06) end end -- hands local rightCFrame = input:getRightCFrame() local leftCFrame = input:getLeftCFrame() -- place attachments local rAttach = rigHelper:getAttachment("RightHand") local lAttach = rigHelper:getAttachment("LeftHand") if rAttach then rAttach.WorldCFrame = rightCFrame end if lAttach then lAttach.WorldCFrame = leftCFrame end -- simple IK: compute a shoulder C0 that aims upper arm towards hand attachment local torso = character:FindFirstChild("Torso") or character:FindFirstChild("UpperTorso") or character:FindFirstChild("HumanoidRootPart") local shoulderMotor = rigHelper.motors["Right Shoulder"] local elbowMotor = rigHelper.motors["Right Elbow"] if torso and shoulderMotor and elbowMotor and rAttach then local shoulderWorld = torso.CFrame * shoulderMotor.C0 local shoulderPos = shoulderWorld.Position local targetPos = rAttach.WorldPosition -- Solve two-bone local lookCFrame, shoulderAngle, elbowAngle = IK.solveTwoBone(shoulderPos, upperLen, lowerLen, targetPos, torso.CFrame.UpVector) -- Build new shoulder C0 in torso space to orient upper arm towards target -- For simplicity, rotate shoulder's C0 to match lookCFrame relative to torso local desiredC0 = torso.CFrame:ToObjectSpace(CFrame.new(shoulderPos) * (lookCFrame - lookCFrame.Position)) -- Blend toward desired local currentC0 = shoulderMotor.C0 local blended = currentC0:Lerp(desiredC0, math.clamp(30 * dt, 0, 1)) shoulderMotor.C0 = blended -- Apply elbow bend by rotating elbow.C0 around X by elbowAngle local baseElbowC0 = rigHelper.initialC0["Right Elbow"] or elbowMotor.C0 elbowMotor.C0 = baseElbowC0 * CFrame.Angles(0, 0, -elbowAngle) end -- left shoulder mirror local lShoulder = rigHelper.motors["Left Shoulder"] local lElbow = rigHelper.motors["Left Elbow"] if torso and lShoulder and lElbow and lAttach then local shoulderWorld = torso.CFrame * lShoulder.C0 local shoulderPos = shoulderWorld.Position local targetPos = lAttach.WorldPosition local lookCFrame, shoulderAngle, elbowAngle = IK.solveTwoBone(shoulderPos, upperLen, lowerLen, targetPos, torso.CFrame.UpVector) local desiredC0 = torso.CFrame:ToObjectSpace(CFrame.new(shoulderPos) * (lookCFrame - lookCFrame.Position)) local currentC0 = lShoulder.C0 lShoulder.C0 = currentC0:Lerp(desiredC0, math.clamp(30 * dt, 0, 1)) local baseElbowC0 = rigHelper.initialC0["Left Elbow"] or lElbow.C0 lElbow.C0 = baseElbowC0 * CFrame.Angles(0, 0, elbowAngle) end -- GUI pulse based on speed local humanoid = character:FindFirstChildOfClass("Humanoid") if humanoid and humanoid.MoveDirection then local speed = humanoid.WalkSpeed or 16 if speed > 0.1 then gui:pulseCrosshair(1, 0.15) end end end end -- Connect render stepped local conn conn = RunService.RenderStepped:Connect(function(dt) if character.Parent == nil then conn:Disconnect() return end pcall(function() RunUpdate(dt) end) end) -- Basic VR toggle and teleport input handling local UserInputService = game:GetService("UserInputService") local function onInputBegan(inputObj, gameProcessed) if gameProcessed then return end if inputObj.UserInputType == Enum.UserInputType.MouseButton1 then -- teleport forward a short distance from head look local headC = input:getHeadCFrame() local forward = headC.LookVector local pos = headC.Position + forward * 6 teleportTo(pos) gui:fadeOut(0.12) wait(0.06) gui:fadeIn(0.12) elseif inputObj.KeyCode == Enum.KeyCode.T then local headC = input:getHeadCFrame() local pos = headC.Position teleportTo(pos) end end UserInputService.InputBegan:Connect(onInputBegan) -- Clean up on character removing player.CharacterRemoving:Connect(function() if conn then conn:Disconnect() conn = nil end end) -- Expose API for other scripts if desired local SSVR = { enabled = true, input = input, rig = rigHelper, gui = gui } return SSVR -- NOTE: -- Some environments place ModuleScripts as direct children. This duplicate ensures require paths -- succeed whether modules are children of this script or separate ModuleScripts named accordingly. -- It's identical to modules/rig.lua and will be ignored if the main modules folder exists. local Rig = {} Rig.__index = Rig local Players = game:GetService("Players") local function findMotor6D(part, name) for _, c in ipairs(part:GetChildren()) do if c:IsA("Motor6D") and c.Name == name then return c end end return nil end function Rig.new(character) assert(character, "Character required") local self = setmetatable({}, Rig) self.character = character self.humanoid = character:FindFirstChildOfClass("Humanoid") assert(self.humanoid and self.humanoid.RigType == Enum.HumanoidRigType.R6, "R6 rig required") self.motors = {} local motorNames = { "Neck", "Right Shoulder", "Left Shoulder", "Right Hip", "Left Hip", "RootJoint", "Right Elbow", "Left Elbow" } for _, name in ipairs(motorNames) do for _, part in ipairs(character:GetDescendants()) do if part:IsA("Motor6D") and part.Name == name then self.motors[name] = part end end end self.neck = self.motors.Neck self.attachments = {} local function ensureAttachment(parent, attName, cframe) local existing = parent:FindFirstChild(attName) if existing and existing:IsA("Attachment") then return existing end local att = Instance.new("Attachment") att.Name = attName if cframe then att.Transform = cframe end att.Parent = parent return att end local head = character:FindFirstChild("Head") local torso = character:FindFirstChild("Torso") or character:FindFirstChild("UpperTorso") or character:FindFirstChild("HumanoidRootPart") local rightHand = character:FindFirstChild("Right Arm") or character:FindFirstChild("RightHand") local leftHand = character:FindFirstChild("Left Arm") or character:FindFirstChild("LeftHand") if head then self.attachments.Head = ensureAttachment(head, "VR_Head") end if rightHand then self.attachments.RightHand = ensureAttachment(rightHand, "VR_RightHand") end if leftHand then self.attachments.LeftHand = ensureAttachment(leftHand, "VR_LeftHand") end if torso then self.attachments.Torso = ensureAttachment(torso, "VR_Torso") end self.initialC0 = {} for name, motor in pairs(self.motors) do self.initialC0[name] = motor.C0 end return self end function Rig:setNeckC0(cframe) if self.neck then self.neck.C0 = cframe end end function Rig:setMotorC0(name, c0) local motor = self.motors[name] if motor then motor.C0 = c0 end end function Rig:getAttachment(name) return self.attachments[name] end function Rig:restoreInitial() for name, motor in pairs(self.motors) do if self.initialC0[name] then motor.C0 = self.initialC0[name] end end end return Rig