배우기
엔진 클래스
Mouse
만들 수 없음

*이 콘텐츠는 AI(베타)를 사용해 번역되었으며, 오류가 있을 수 있습니다. 이 페이지를 영어로 보려면 여기를 클릭하세요.



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)
마우스 원점 vs 마우스 히트 vs 현재 카메라 위치
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
코드 샘플
마우스 원점 vs 마우스 히트 vs 현재 카메라 위치
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")
-- 참고: 이 작업을 수행하기 위해서는 Mouse 객체 대신 ContextActionService 또는 UserInputService를 사용해야 합니다.
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")
-- 참고: 이 작업을 수행하기 위해서는 Mouse 객체 대신 ContextActionService 또는 UserInputService를 사용해야 합니다.
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")
-- 참고: 이 작업을 수행하기 위해서는 Mouse 객체 대신 ContextActionService 또는 UserInputService를 사용해야 합니다.
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")
-- 참고: 이 작업을 수행하기 위해서는 Mouse 객체 대신 ContextActionService 또는 UserInputService를 사용해야 합니다.
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("Input 처리", 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'은 미국 및 기타 국가 내 당사의 등록 및 미등록 상표입니다.