scripts/Modules/TargetFinder.module.lua

scripts/Modules/LockController.module.lua

Notes

- The lock is client-side: it highlights the target and smoothly orients your camera to face them. - The script auto-unlocks if the target dies or leaves. - If you prefer server-side actions (movement/aiming), adapt the pattern and validate on server for security.

Files in this folder

scripts/
  LocalScripts/
    lock_on.client.lua
  Modules/
    TargetFinder.module.lua
    LockController.module.lua
README.md

1d:T94b,-- lock_on.client.lua -- LocalScript: press X to lock onto the player under your mouse. -- Place this LocalScript in StarterPlayer -> StarterPlayerScripts. local Players = game:GetService("Players") local UserInputService = game:GetService("UserInputService") local ReplicatedStorage = game:GetService("ReplicatedStorage") local localPlayer = Players.LocalPlayer local camera = workspace.CurrentCamera -- Wait for modules stored in ReplicatedStorage.LockOnModules local modulesFolder = ReplicatedStorage:WaitForChild("LockOnModules") local TargetFinder = require(modulesFolder:WaitForChild("TargetFinder")) local LockControllerModule = require(modulesFolder:WaitForChild("LockController")) local lockController = LockControllerModule.new(localPlayer) local TOGGLE_KEY = Enum.KeyCode.X -- Toggle lock: on press X, if locked -> unlock, else attempt to find player under mouse and lock UserInputService.InputBegan:Connect(function(input, gameProcessed) if gameProcessed then return end if input.UserInputType == Enum.UserInputType.Keyboard and input.KeyCode == TOGGLE_KEY then if lockController.lockedPlayer then lockController:unlock() return end -- Get mouse screen position (client-side). Returns Vector2 in pixels. local mousePos = UserInputService:GetMouseLocation() local screenX, screenY = mousePos.X, mo