1e:T22c4,--[[ AimHelperModule Client-side helper to lock highlight to the player under the mouse when in first-person. Place this module in ReplicatedStorage as "AimHelperModule". ]] local RunService = game:GetService("RunService") local Players = game:GetService("Players") local Workspace = game:GetService("Workspace") local UserInputService = game:GetService("UserInputService") local AimHelper = {} AimHelper.__index = AimHelper -- Helper: clamp-safe angle in degrees between two unit vectors local function angleBetween(u, v) local dot = math.clamp(u:Dot(v), -1, 1) return math.deg(math.acos(dot)) end -- Helper: check if any TextBox is focused (avoid toggling while typing) local function isTextInputFocused() local focused = UserInputService:GetFocusedTextBox() return focused ~= nil end -- Traverse upwards to find a Model with a Humanoid local function findCharacterModelFromPart(part) if not part or not part.Parent then return nil end local current = part while current and current:IsA("BasePart") do current = current.Parent end -- walk upwards until Model current = part while current and not current:IsA("Model") do current = current.Parent end if current and current:FindFirstChildOfClass("Humanoid") then return current end return nil end function AimHelper.new(player, opts) opts = opts or {} local self = setmetatable({}, AimHelper) self.player = player self.camera = Workspace.CurrentCamera -- Settings self.toggleKey = opts.toggleKey or Enum.KeyCode.X self.maxDistance = opts.maxDistance or 250 -- studs (ray distance) self.firstPersonThreshold = opts.firstPersonThreshold or 2.5 -- studs: max distance between camera and head/root to be considered first person self.updateRate = opts.updateRate or 0 -- 0 uses RenderStepped each frame -- State self.enabled = false self.currentTarget = nil self._connections = {} self._running = false -- Create a Highlight instance (client-only) local highlight = Instance.new("Highlight") highlight.Name = "AimHelperHighlight" highlight.FillColor = Color3.fromRGB(255, 150, 50) highlight.FillTransparency = 0.6 highlight.OutlineColor = Color3.fromRGB(255, 255, 255) highlight.OutlineTransparency = 0.6 highlight.Enabled = false highlight.Parent = Workspace self.highlight = highlight -- Raycast params (ignore local player's character) local RaycastParams = RaycastParams.new() RaycastParams.FilterType = Enum.RaycastFilterType.Blacklist self._rayParams = RaycastParams return self end function AimHelper:enableWithTarget(targetModel) if not targetModel then return end if not self:isValidTarget(targetModel) then return end self.currentTarget = targetModel self.highlight.Adornee = targetModel self.highlight.Enabled = true self.enabled = true end function AimHelper:enable() if self.enabled then return end self.enabled = true self.highlight.Enabled = true end function AimHelper:disable() if not self.enabled then return end self.enabled = false self.highlight.Enabled = false self.highlight.Adornee = nil self.currentTarget = nil end function AimHelper:toggle() if self.enabled then self:disable() else self:enable() end end -- Determines whether a candidate model is a valid target function AimHelper:isValidTarget(model) if not model or not model.Parent then return false end local humanoid = model:FindFirstChildOfClass("Humanoid") local hrp = model:FindFirstChild("HumanoidRootPart") or model:FindFirstChild("U