Ghi chú phát hành
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ã
Tia chạm 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 Vị trí va chạm chuột và 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("Mouse.Hit:", mouse.Hit.Position)
print("camPos:", camPos)
print("Mouse.Origin:", mouse.Origin.Position)
print("Magnitude:", (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 Vị trí va chạm chuột và 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("Mouse.Hit:", mouse.Hit.Position)
print("camPos:", camPos)
print("Mouse.Origin:", mouse.Origin.Position)
print("Magnitude:", (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 Nhâ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)

UnitRay
Chỉ Đọc
Không Sao Chép
Đọc Song Song
Các khả năng: Input
Mouse.UnitRay:Ray

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 đố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ạ góc trên bên trái (ngay dưới thanh công cụ)
-- đến (0, 0) góc 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 bằng cách chia vị trí cho kích thước tổng thể.
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 đố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ạ góc trên bên trái (ngay dưới thanh công cụ)
-- đến (0, 0) góc 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 bằng cách chia vị trí cho kích thước tổng thể.
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 đố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ạ góc trên bên trái (ngay dưới thanh công cụ)
-- đến (0, 0) góc 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 bằng cách chia vị trí cho kích thước tổng thể.
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 đố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ạ góc trên bên trái (ngay dưới thanh công cụ)
-- đến (0, 0) góc 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 bằng cách chia vị trí cho kích thước tổng thể.
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ã
Chuột.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 tới", 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 với 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ã
Chuột.MộtQuayLại
local Players = game:GetService("Players")
local player = Players.LocalPlayer
local mouse = player:GetMouse()
local function onWheelBackward()
print("Bánh xe đã quay lại!")
end
mouse.WheelBackward:Connect(onWheelBackward)

WheelForward
Các khả năng: Input
Mouse.WheelForward():RBXScriptSignal
Mẫu mã
Chuột.WheelForward
local Players = game:GetService("Players")
local player = Players.LocalPlayer
local mouse = player:GetMouse()
local function onWheelForward()
print("Bánh xe đã di chuyể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.