Aprenda
Classe do mecanismo
Mouse
Não criável

*Este conteúdo é traduzido por IA (Beta) e pode conter erros. Para ver a página em inglês, clique aqui.



Referência API
Propriedades
Hit
Somente leitura
Não replicado
Ler Parallel
Recursos: Input
Mouse.Hit:CFrame
Amostras de código
Feixe Laser do Mouse
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)
Origem do Mouse vs Impacto do Mouse vs Posição da Câmera Atual
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
Obsoleto

Icon
Ler Parallel
Recursos: Input
Mouse.Icon:ContentId
Amostras de código
Ícone de Rato Dragão
local Players = game:GetService("Players")
local mouse = Players.LocalPlayer:GetMouse()
mouse.Icon = "http://www.roblox.com/asset?id=163023520"

IconContent
Ler Parallel
Recursos: Input
Mouse.IconContent:Content
Amostras de código
Ícone de Rato Dragão
local Players = game:GetService("Players")
local mouse = Players.LocalPlayer:GetMouse()
mouse.Icon = "http://www.roblox.com/asset?id=163023520"

Origin
Somente leitura
Não replicado
Ler Parallel
Recursos: Input
Mouse.Origin:CFrame
Amostras de código
Origem do Mouse vs Impacto do Mouse vs Posição da Câmera Atual
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
Somente leitura
Não replicado
Ler Parallel
Recursos: Input
Mouse.Target:BasePart
Amostras de código
Ferramenta de Randomização de Cores
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("Clicado:", target:GetFullName())
if target:IsA("BasePart") then
target.BrickColor = BrickColor.random()
end
end
end)

target
Obsoleto

TargetFilter
Ler Parallel
Recursos: Input
Mouse.TargetFilter:Instance

TargetSurface
Somente leitura
Não replicado
Ler Parallel
Recursos: Input
Mouse.TargetSurface:Enum.NormalId
Amostras de código
Randomizador de Superfície
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()
-- certifique-se de que o mouse está apontando para uma parte
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
Somente leitura
Não replicado
Ler Parallel
Recursos: Input
Mouse.UnitRay:Ray

ViewSizeX
Somente leitura
Não replicado
Ler Parallel
Recursos: Input
Mouse.ViewSizeX:number
Amostras de código
Posição Normalizada do Mouse
local Players = game:GetService("Players")
-- Nota: Você deve usar ContextActionService ou UserInputService em vez de
-- o objeto Mouse para realizar esta tarefa.
local player = Players.LocalPlayer
local mouse = player:GetMouse()
local function onMouseMove()
-- Construir objetos Vector2 para a posição do mouse e o tamanho da tela
local position = Vector2.new(mouse.X, mouse.Y)
local size = Vector2.new(mouse.ViewSizeX, mouse.ViewSizeY)
-- Uma posição normalizada mapeará o canto superior esquerdo (logo abaixo da barra superior)
-- para (0, 0) o canto inferior direito para (1, 1), e o centro para (0.5, 0.5).
-- Isso é calculado dividindo a posição pelo tamanho total.
local normalizedPosition = position / size
print(normalizedPosition)
end
mouse.Move:Connect(onMouseMove)

ViewSizeY
Somente leitura
Não replicado
Ler Parallel
Recursos: Input
Mouse.ViewSizeY:number
Amostras de código
Posição Normalizada do Mouse
local Players = game:GetService("Players")
-- Nota: Você deve usar ContextActionService ou UserInputService em vez de
-- o objeto Mouse para realizar esta tarefa.
local player = Players.LocalPlayer
local mouse = player:GetMouse()
local function onMouseMove()
-- Construir objetos Vector2 para a posição do mouse e o tamanho da tela
local position = Vector2.new(mouse.X, mouse.Y)
local size = Vector2.new(mouse.ViewSizeX, mouse.ViewSizeY)
-- Uma posição normalizada mapeará o canto superior esquerdo (logo abaixo da barra superior)
-- para (0, 0) o canto inferior direito para (1, 1), e o centro para (0.5, 0.5).
-- Isso é calculado dividindo a posição pelo tamanho total.
local normalizedPosition = position / size
print(normalizedPosition)
end
mouse.Move:Connect(onMouseMove)

X
Somente leitura
Não replicado
Ler Parallel
Recursos: Input
Mouse.X:number
Amostras de código
Posição Normalizada do Mouse
local Players = game:GetService("Players")
-- Nota: Você deve usar ContextActionService ou UserInputService em vez de
-- o objeto Mouse para realizar esta tarefa.
local player = Players.LocalPlayer
local mouse = player:GetMouse()
local function onMouseMove()
-- Construir objetos Vector2 para a posição do mouse e o tamanho da tela
local position = Vector2.new(mouse.X, mouse.Y)
local size = Vector2.new(mouse.ViewSizeX, mouse.ViewSizeY)
-- Uma posição normalizada mapeará o canto superior esquerdo (logo abaixo da barra superior)
-- para (0, 0) o canto inferior direito para (1, 1), e o centro para (0.5, 0.5).
-- Isso é calculado dividindo a posição pelo tamanho total.
local normalizedPosition = position / size
print(normalizedPosition)
end
mouse.Move:Connect(onMouseMove)

Y
Somente leitura
Não replicado
Ler Parallel
Recursos: Input
Mouse.Y:number
Amostras de código
Posição Normalizada do Mouse
local Players = game:GetService("Players")
-- Nota: Você deve usar ContextActionService ou UserInputService em vez de
-- o objeto Mouse para realizar esta tarefa.
local player = Players.LocalPlayer
local mouse = player:GetMouse()
local function onMouseMove()
-- Construir objetos Vector2 para a posição do mouse e o tamanho da tela
local position = Vector2.new(mouse.X, mouse.Y)
local size = Vector2.new(mouse.ViewSizeX, mouse.ViewSizeY)
-- Uma posição normalizada mapeará o canto superior esquerdo (logo abaixo da barra superior)
-- para (0, 0) o canto inferior direito para (1, 1), e o centro para (0.5, 0.5).
-- Isso é calculado dividindo a posição pelo tamanho total.
local normalizedPosition = position / size
print(normalizedPosition)
end
mouse.Move:Connect(onMouseMove)

Eventos
Button1Down
Recursos: Input
Mouse.Button1Down():RBXScriptSignal

Button1Up
Recursos: Input
Mouse.Button1Up():RBXScriptSignal

Button2Down
Recursos: Input
Mouse.Button2Down():RBXScriptSignal

Button2Up
Recursos: Input
Mouse.Button2Up():RBXScriptSignal

Idle
Recursos: Input
Mouse.Idle():RBXScriptSignal
Amostras de código
Mouse.Inativo
local Players = game:GetService("Players")
local RunService = game:GetService("RunService")
local player = Players.LocalPlayer
local mouse = player:GetMouse()
local events = {
"Button1Down",
"Button1Up",
"Button2Down",
"Button2Up",
"Inativo",
"Mover",
"RodaParaTrás",
"RodaParaFrente",
"TeclaParaBaixo",
"TeclaParaCima",
}
local currentEvent
local frame = 0
local function processInput()
frame = frame + 1
print("Quadro", frame, "- evento do mouse foi passado para", 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
Obsoleto

keyDown
Obsoleto

KeyUp
Obsoleto

Move
Recursos: Input
Mouse.Move():RBXScriptSignal
Amostras de código
Mover Peças com o Mouse
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
Recursos: Input
Mouse.WheelBackward():RBXScriptSignal
Amostras de código
Mouse.VoltarRoda
local Players = game:GetService("Players")
local player = Players.LocalPlayer
local mouse = player:GetMouse()
local function onWheelBackward()
print("A roda foi para trás!")
end
mouse.WheelBackward:Connect(onWheelBackward)

WheelForward
Recursos: Input
Mouse.WheelForward():RBXScriptSignal
Amostras de código
Rato.RodaParaFrente
local Players = game:GetService("Players")
local player = Players.LocalPlayer
local mouse = player:GetMouse()
local function onWheelForward()
print("A roda foi para frente!")
end
mouse.WheelForward:Connect(onWheelForward)

©2026 Roblox Corporation, Roblox, o logotipo Roblox e Powering Imagination estão entre nossas marcas registradas e não registradas nos EUA e em outros países.