Học
Lớp công cụ
Mouse
Không Thể Tạo

*Nội dung này được dịch bằng AI (Beta) và có thể có lỗi. Để xem trang này bằng tiếng Anh, hãy nhấp vào đây.



Tài Liệu Tham Khảo API
Thuộc Tính
Hit
Chỉ Đọc
Không Sao Chép
Đọc Song Song
Các khả năng: Input
Mouse.Hit:CFrame
Mẫu mã
Chuột.Hit Tia Laser
local Players = game:GetService("Players")
local RunService = game:GetService("RunService")
local player = Players.LocalPlayer
local mouse = player:GetMouse()
local beam = Instance.new("Beam")
beam.Segments = 1
beam.Width0 = 0.2
beam.Width1 = 0.2
beam.Color = ColorSequence.new(Color3.new(1, 0, 0))
beam.FaceCamera = true
local attachment0 = Instance.new("Attachment")
local attachment1 = Instance.new("Attachment")
beam.Attachment0 = attachment0
beam.Attachment1 = attachment1
beam.Parent = workspace.Terrain
attachment0.Parent = workspace.Terrain
attachment1.Parent = workspace.Terrain
local function onRenderStep()
local character = player.Character
if not character then
beam.Enabled = false
return
end
local head = character:FindFirstChild("Head")
if not head then
beam.Enabled = false
return
end
beam.Enabled = true
local origin = head.Position
local finish = mouse.Hit.Position
attachment0.Position = origin
attachment1.Position = finish
end
RunService.RenderStepped:Connect(onRenderStep)
Vị trí Chuột so với Va chạm Chuột so với Vị trí Camera Hiện tại
local Players = game:GetService("Players")
local Workspace = game:GetService("Workspace")
local player = Players.LocalPlayer
local camera = Workspace.CurrentCamera
local mouse = player:GetMouse()
local camPos = camera.CFrame.Position
local function onButton1Down()
print("Va chạm Chuột:", mouse.Hit.Position)
print("camPos:", camPos)
print("Gốc Chuột:", mouse.Origin.Position)
print("Độ lớn:", (mouse.Origin.Position - camPos).Magnitude)
end
mouse.Button1Down:Connect(onButton1Down)

hit
Đã Lỗi Thời

Icon
Đọc Song Song
Các khả năng: Input
Mouse.Icon:ContentId
Mẫu mã
Biểu Tượng Chuột Rồng
local Players = game:GetService("Players")
local mouse = Players.LocalPlayer:GetMouse()
mouse.Icon = "http://www.roblox.com/asset?id=163023520"

IconContent
Đọc Song Song
Các khả năng: Input
Mouse.IconContent:Content
Mẫu mã
Biểu Tượng Chuột Rồng
local Players = game:GetService("Players")
local mouse = Players.LocalPlayer:GetMouse()
mouse.Icon = "http://www.roblox.com/asset?id=163023520"

Origin
Chỉ Đọc
Không Sao Chép
Đọc Song Song
Các khả năng: Input
Mouse.Origin:CFrame
Mẫu mã
Vị trí Chuột so với Va chạm Chuột so với Vị trí Camera Hiện tại
local Players = game:GetService("Players")
local Workspace = game:GetService("Workspace")
local player = Players.LocalPlayer
local camera = Workspace.CurrentCamera
local mouse = player:GetMouse()
local camPos = camera.CFrame.Position
local function onButton1Down()
print("Va chạm Chuột:", mouse.Hit.Position)
print("camPos:", camPos)
print("Gốc Chuột:", mouse.Origin.Position)
print("Độ lớn:", (mouse.Origin.Position - camPos).Magnitude)
end
mouse.Button1Down:Connect(onButton1Down)

Target
Chỉ Đọc
Không Sao Chép
Đọc Song Song
Các khả năng: Input
Mouse.Target:BasePart
Mẫu mã
Công Cụ Ngẫu Nhiên Màu
local Players = game:GetService("Players")
local player = Players.LocalPlayer
local mouse = player:GetMouse()
mouse.Button1Down:Connect(function()
local target = mouse.Target
if target then
print("Đã nhấp:", target:GetFullName())
if target:IsA("BasePart") then
target.BrickColor = BrickColor.random()
end
end
end)

target
Đã Lỗi Thời

TargetFilter
Đọc Song Song
Các khả năng: Input
Mouse.TargetFilter:Instance

TargetSurface
Chỉ Đọc
Không Sao Chép
Đọc Song Song
Các khả năng: Input
Mouse.TargetSurface:Enum.NormalId
Mẫu mã
Trình Ngẫu Nhiên Bề Mặt
local Players = game:GetService("Players")
local player = Players.LocalPlayer
local mouse = player:GetMouse()
local surfaceTypes = {
Enum.SurfaceType.Smooth,
Enum.SurfaceType.Glue,
Enum.SurfaceType.Weld,
Enum.SurfaceType.Studs,
Enum.SurfaceType.Inlet,
Enum.SurfaceType.Universal,
Enum.SurfaceType.Hinge,
Enum.SurfaceType.Motor,
}
local function onMouseClick()
-- đảm bảo rằng chuột đang chỉ vào một phần
local target = mouse.Target
if not target then
return
end
local surfaceType = surfaceTypes[math.random(1, #surfaceTypes)]
local surface = mouse.TargetSurface
local propertyName = surface.Name .. "Surface"
mouse.Target[propertyName] = surfaceType
end
mouse.Button1Down:Connect(onMouseClick)
Bề mặt mục tiêu
local Players = game:GetService("Players")
local player = Players.LocalPlayer
local mouse = player:GetMouse()
-- Kiểm tra xem có một phần nào đó mà chuột đang chỉ vào
if mouse.Target then
print("Chuột đang chỉ vào " .. mouse.TargetSurface.Name .. " mặt của " .. mouse.Target.Name)
else
print("Chuột không chỉ vào bất cứ thứ gì.")
end

UnitRay
Chỉ Đọc
Không Sao Chép
Đọc Song Song
Các khả năng: Input
Mouse.UnitRay:Ray
Mẫu mã
Unit Ray
local Players = game:GetService("Players")
local player = Players.LocalPlayer
local mouse = player:GetMouse()
print(mouse.UnitRay.Direction.Magnitude) -- Luôn luôn 1

ViewSizeX
Chỉ Đọc
Không Sao Chép
Đọc Song Song
Các khả năng: Input
Mouse.ViewSizeX:number
Mẫu mã
Vị Trí Chuột Đã Chuẩn Hóa
local Players = game:GetService("Players")
-- Lưu ý: Bạn nên sử dụng ContextActionService hoặc UserInputService thay vì
-- đối tượng Mouse để thực hiện nhiệm vụ này.
local player = Players.LocalPlayer
local mouse = player:GetMouse()
local function onMouseMove()
-- Tạo các đối tượng Vector2 cho vị trí của chuột và kích thước màn hình
local position = Vector2.new(mouse.X, mouse.Y)
local size = Vector2.new(mouse.ViewSizeX, mouse.ViewSizeY)
-- Một vị trí đã chuẩn hóa sẽ ánh xạ phía trên bên trái (ngay dưới thanh trên cùng)
-- đến (0, 0) phía dưới bên phải đến (1, 1), và trung tâm đến (0.5, 0.5).
-- Điều này được tính toán bằng cách chia vị trí cho kích thước tổng.
local normalizedPosition = position / size
print(normalizedPosition)
end
mouse.Move:Connect(onMouseMove)

ViewSizeY
Chỉ Đọc
Không Sao Chép
Đọc Song Song
Các khả năng: Input
Mouse.ViewSizeY:number
Mẫu mã
Vị Trí Chuột Đã Chuẩn Hóa
local Players = game:GetService("Players")
-- Lưu ý: Bạn nên sử dụng ContextActionService hoặc UserInputService thay vì
-- đối tượng Mouse để thực hiện nhiệm vụ này.
local player = Players.LocalPlayer
local mouse = player:GetMouse()
local function onMouseMove()
-- Tạo các đối tượng Vector2 cho vị trí của chuột và kích thước màn hình
local position = Vector2.new(mouse.X, mouse.Y)
local size = Vector2.new(mouse.ViewSizeX, mouse.ViewSizeY)
-- Một vị trí đã chuẩn hóa sẽ ánh xạ phía trên bên trái (ngay dưới thanh trên cùng)
-- đến (0, 0) phía dưới bên phải đến (1, 1), và trung tâm đến (0.5, 0.5).
-- Điều này được tính toán bằng cách chia vị trí cho kích thước tổng.
local normalizedPosition = position / size
print(normalizedPosition)
end
mouse.Move:Connect(onMouseMove)

X
Chỉ Đọc
Không Sao Chép
Đọc Song Song
Các khả năng: Input
Mouse.X:number
Mẫu mã
Vị Trí Chuột Đã Chuẩn Hóa
local Players = game:GetService("Players")
-- Lưu ý: Bạn nên sử dụng ContextActionService hoặc UserInputService thay vì
-- đối tượng Mouse để thực hiện nhiệm vụ này.
local player = Players.LocalPlayer
local mouse = player:GetMouse()
local function onMouseMove()
-- Tạo các đối tượng Vector2 cho vị trí của chuột và kích thước màn hình
local position = Vector2.new(mouse.X, mouse.Y)
local size = Vector2.new(mouse.ViewSizeX, mouse.ViewSizeY)
-- Một vị trí đã chuẩn hóa sẽ ánh xạ phía trên bên trái (ngay dưới thanh trên cùng)
-- đến (0, 0) phía dưới bên phải đến (1, 1), và trung tâm đến (0.5, 0.5).
-- Điều này được tính toán bằng cách chia vị trí cho kích thước tổng.
local normalizedPosition = position / size
print(normalizedPosition)
end
mouse.Move:Connect(onMouseMove)

Y
Chỉ Đọc
Không Sao Chép
Đọc Song Song
Các khả năng: Input
Mouse.Y:number
Mẫu mã
Vị Trí Chuột Đã Chuẩn Hóa
local Players = game:GetService("Players")
-- Lưu ý: Bạn nên sử dụng ContextActionService hoặc UserInputService thay vì
-- đối tượng Mouse để thực hiện nhiệm vụ này.
local player = Players.LocalPlayer
local mouse = player:GetMouse()
local function onMouseMove()
-- Tạo các đối tượng Vector2 cho vị trí của chuột và kích thước màn hình
local position = Vector2.new(mouse.X, mouse.Y)
local size = Vector2.new(mouse.ViewSizeX, mouse.ViewSizeY)
-- Một vị trí đã chuẩn hóa sẽ ánh xạ phía trên bên trái (ngay dưới thanh trên cùng)
-- đến (0, 0) phía dưới bên phải đến (1, 1), và trung tâm đến (0.5, 0.5).
-- Điều này được tính toán bằng cách chia vị trí cho kích thước tổng.
local normalizedPosition = position / size
print(normalizedPosition)
end
mouse.Move:Connect(onMouseMove)

Sự Kiện
Button1Down
Các khả năng: Input
Mouse.Button1Down():RBXScriptSignal

Button1Up
Các khả năng: Input
Mouse.Button1Up():RBXScriptSignal

Button2Down
Các khả năng: Input
Mouse.Button2Down():RBXScriptSignal

Button2Up
Các khả năng: Input
Mouse.Button2Up():RBXScriptSignal

Idle
Các khả năng: Input
Mouse.Idle():RBXScriptSignal
Mẫu mã
Mouse.Idle
local Players = game:GetService("Players")
local RunService = game:GetService("RunService")
local player = Players.LocalPlayer
local mouse = player:GetMouse()
local events = {
"Button1Down",
"Button1Up",
"Button2Down",
"Button2Up",
"Idle",
"Move",
"WheelBackward",
"WheelForward",
"KeyDown",
"KeyUp",
}
local currentEvent
local frame = 0
local function processInput()
frame = frame + 1
print("Khung hình", frame, "- sự kiện chuột đã được truyền đến", currentEvent)
end
for _, event in pairs(events) do
mouse[event]:Connect(function()
currentEvent = event
end)
end
RunService:BindToRenderStep("ProcessInput", Enum.RenderPriority.Input.Value, processInput)

KeyDown
Đã Lỗi Thời

keyDown
Đã Lỗi Thời

KeyUp
Đã Lỗi Thời

Move
Các khả năng: Input
Mouse.Move():RBXScriptSignal
Mẫu mã
Di chuyển các phần bằng chuột
local Players = game:GetService("Players")
local player = Players.LocalPlayer
local mouse = player:GetMouse()
local point
local down
local function selectPart()
if mouse.Target and not mouse.Target.Locked then
point = mouse.Target
mouse.TargetFilter = point
down = true
end
end
local function movePart()
if down and point then
local posX, posY, posZ = mouse.Hit.X, mouse.Hit.Y, mouse.Hit.Z
point.Position = Vector3.new(posX, posY, posZ)
end
end
local function deselectPart()
down = false
point = nil
mouse.TargetFilter = nil
end
mouse.Button1Down:Connect(selectPart)
mouse.Button1Up:Connect(deselectPart)
mouse.Move:Connect(movePart)

WheelBackward
Các khả năng: Input
Mouse.WheelBackward():RBXScriptSignal
Mẫu mã
Mouse.WheelBackward
local Players = game:GetService("Players")
local player = Players.LocalPlayer
local mouse = player:GetMouse()
local function onWheelBackward()
print("Bánh xe đã quay ngược!")
end
mouse.WheelBackward:Connect(onWheelBackward)

WheelForward
Các khả năng: Input
Mouse.WheelForward():RBXScriptSignal
Mẫu mã
Mouse.WheelForward
local Players = game:GetService("Players")
local player = Players.LocalPlayer
local mouse = player:GetMouse()
local function onWheelForward()
print("Bánh xe đã tiến về phía trước!")
end
mouse.WheelForward:Connect(onWheelForward)

©2026 Roblox Corporation. Roblox, logo Roblox và Powering Imagination là các nhãn hiệu đã đăng ký và chưa đăng ký của chúng tôi tại Hoa Kỳ và các quốc gia khác.