学习
引擎类
Mouse
无法创建

*此内容使用人工智能(Beta)翻译,可能包含错误。若要查看英文页面,请点按 此处



API 参考
属性
Hit
只读
未复制
读取并联
功能: Input
Mouse.Hit:CFrame
代码示例
鼠标.命中激光束
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)
鼠标原点与鼠标击中的位置与当前相机位置
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
已弃用

Icon
读取并联
功能: Input
Mouse.Icon:ContentId
代码示例
龙鼠标图标
local Players = game:GetService("Players")
local mouse = Players.LocalPlayer:GetMouse()
mouse.Icon = "http://www.roblox.com/asset?id=163023520"

IconContent
读取并联
功能: Input
Mouse.IconContent:Content
代码示例
龙鼠标图标
local Players = game:GetService("Players")
local mouse = Players.LocalPlayer:GetMouse()
mouse.Icon = "http://www.roblox.com/asset?id=163023520"

Origin
只读
未复制
读取并联
功能: Input
Mouse.Origin:CFrame
代码示例
鼠标原点与鼠标击中的位置与当前相机位置
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
只读
未复制
读取并联
功能: Input
Mouse.Target:BasePart
代码示例
颜色随机工具
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("点击:", target:GetFullName())
if target:IsA("BasePart") then
target.BrickColor = BrickColor.random()
end
end
end)

target
已弃用

TargetFilter
读取并联
功能: Input
Mouse.TargetFilter:Instance

TargetSurface
只读
未复制
读取并联
功能: Input
Mouse.TargetSurface:Enum.NormalId
代码示例
表面随机器
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()
-- 确保鼠标指向一个部件
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
只读
未复制
读取并联
功能: Input
Mouse.UnitRay:Ray

ViewSizeX
只读
未复制
读取并联
功能: Input
Mouse.ViewSizeX:number
代码示例
规范化鼠标位置
local Players = game:GetService("Players")
-- 注意:你应该使用 ContextActionService 或 UserInputService,而不是
-- Mouse 对象来完成这个任务。
local player = Players.LocalPlayer
local mouse = player:GetMouse()
local function onMouseMove()
-- 为鼠标的位置和屏幕大小构造 Vector2 对象
local position = Vector2.new(mouse.X, mouse.Y)
local size = Vector2.new(mouse.ViewSizeX, mouse.ViewSizeY)
-- 一个规范化的位置将把左上角(刚好在顶部栏下方)
-- 映射到 (0, 0),右下角映射到 (1, 1),中心映射到 (0.5, 0.5)。
-- 这是通过将位置除以总大小来计算的。
local normalizedPosition = position / size
print(normalizedPosition)
end
mouse.Move:Connect(onMouseMove)

ViewSizeY
只读
未复制
读取并联
功能: Input
Mouse.ViewSizeY:number
代码示例
规范化鼠标位置
local Players = game:GetService("Players")
-- 注意:你应该使用 ContextActionService 或 UserInputService,而不是
-- Mouse 对象来完成这个任务。
local player = Players.LocalPlayer
local mouse = player:GetMouse()
local function onMouseMove()
-- 为鼠标的位置和屏幕大小构造 Vector2 对象
local position = Vector2.new(mouse.X, mouse.Y)
local size = Vector2.new(mouse.ViewSizeX, mouse.ViewSizeY)
-- 一个规范化的位置将把左上角(刚好在顶部栏下方)
-- 映射到 (0, 0),右下角映射到 (1, 1),中心映射到 (0.5, 0.5)。
-- 这是通过将位置除以总大小来计算的。
local normalizedPosition = position / size
print(normalizedPosition)
end
mouse.Move:Connect(onMouseMove)

X
只读
未复制
读取并联
功能: Input
Mouse.X:number
代码示例
规范化鼠标位置
local Players = game:GetService("Players")
-- 注意:你应该使用 ContextActionService 或 UserInputService,而不是
-- Mouse 对象来完成这个任务。
local player = Players.LocalPlayer
local mouse = player:GetMouse()
local function onMouseMove()
-- 为鼠标的位置和屏幕大小构造 Vector2 对象
local position = Vector2.new(mouse.X, mouse.Y)
local size = Vector2.new(mouse.ViewSizeX, mouse.ViewSizeY)
-- 一个规范化的位置将把左上角(刚好在顶部栏下方)
-- 映射到 (0, 0),右下角映射到 (1, 1),中心映射到 (0.5, 0.5)。
-- 这是通过将位置除以总大小来计算的。
local normalizedPosition = position / size
print(normalizedPosition)
end
mouse.Move:Connect(onMouseMove)

Y
只读
未复制
读取并联
功能: Input
Mouse.Y:number
代码示例
规范化鼠标位置
local Players = game:GetService("Players")
-- 注意:你应该使用 ContextActionService 或 UserInputService,而不是
-- Mouse 对象来完成这个任务。
local player = Players.LocalPlayer
local mouse = player:GetMouse()
local function onMouseMove()
-- 为鼠标的位置和屏幕大小构造 Vector2 对象
local position = Vector2.new(mouse.X, mouse.Y)
local size = Vector2.new(mouse.ViewSizeX, mouse.ViewSizeY)
-- 一个规范化的位置将把左上角(刚好在顶部栏下方)
-- 映射到 (0, 0),右下角映射到 (1, 1),中心映射到 (0.5, 0.5)。
-- 这是通过将位置除以总大小来计算的。
local normalizedPosition = position / size
print(normalizedPosition)
end
mouse.Move:Connect(onMouseMove)

活动
Button1Down
功能: Input
Mouse.Button1Down():RBXScriptSignal

Button1Up
功能: Input
Mouse.Button1Up():RBXScriptSignal

Button2Down
功能: Input
Mouse.Button2Down():RBXScriptSignal

Button2Up
功能: Input
Mouse.Button2Up():RBXScriptSignal

Idle
功能: Input
Mouse.Idle():RBXScriptSignal
代码示例
鼠标.空闲
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("帧", frame, "- 鼠标事件传递给了", currentEvent)
end
for _, event in pairs(events) do
mouse[event]:Connect(function()
currentEvent = event
end)
end
RunService:BindToRenderStep("处理输入", Enum.RenderPriority.Input.Value, processInput)

KeyDown
已弃用

keyDown
已弃用

KeyUp
已弃用

Move
功能: Input
Mouse.Move():RBXScriptSignal
代码示例
鼠标移动部件
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
功能: Input
Mouse.WheelBackward():RBXScriptSignal
代码示例
鼠标.向后滚动
local Players = game:GetService("Players")
local player = Players.LocalPlayer
local mouse = player:GetMouse()
local function onWheelBackward()
print("轮子向后滚动!")
end
mouse.WheelBackward:Connect(onWheelBackward)

WheelForward
功能: Input
Mouse.WheelForward():RBXScriptSignal
代码示例
鼠标.向前滚动
local Players = game:GetService("Players")
local player = Players.LocalPlayer
local mouse = player:GetMouse()
local function onWheelForward()
print("轮子向前滚动!")
end
mouse.WheelForward:Connect(onWheelForward)

©2026 Roblox Corporation、Roblox、Roblox 标志及 Powering Imagination 是我们在美国及其他国家或地区的注册与未注册商标。