Informacje o wersji
Edukacja
Klasa silnika
Mouse
Brak możliwości tworzenia

*Ta zawartość została przetłumaczona przy użyciu narzędzi AI (w wersji beta) i może zawierać błędy. Aby wyświetlić tę stronę w języku angielskim, kliknij tutaj.



Materiały referencyjne dotyczące interfejsów API
Właściwości
Hit
Tylko do odczytu
Bez replikacji
Odczyt równoległy
Możliwości: Input
Mouse.Hit:CFrame
Przykłady kodu
Promień lasera myszki
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)
Pochodzenie myszy vs Trafienie myszy vs Pozycja CurrentCamera
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
Przestarzałe

Icon
Odczyt równoległy
Możliwości: Input
Mouse.Icon:ContentId
Przykłady kodu
Ikona Myszy Smoka
local Players = game:GetService("Players")
local mouse = Players.LocalPlayer:GetMouse()
mouse.Icon = "http://www.roblox.com/asset?id=163023520"

IconContent
Odczyt równoległy
Możliwości: Input
Mouse.IconContent:Content
Przykłady kodu
Ikona Myszy Smoka
local Players = game:GetService("Players")
local mouse = Players.LocalPlayer:GetMouse()
mouse.Icon = "http://www.roblox.com/asset?id=163023520"

Origin
Tylko do odczytu
Bez replikacji
Odczyt równoległy
Możliwości: Input
Mouse.Origin:CFrame
Przykłady kodu
Pochodzenie myszy vs Trafienie myszy vs Pozycja CurrentCamera
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
Tylko do odczytu
Bez replikacji
Odczyt równoległy
Możliwości: Input
Mouse.Target:BasePart
Przykłady kodu
Narzędzie losowania kolorów
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("Kliknięto:", target:GetFullName())
if target:IsA("BasePart") then
target.BrickColor = BrickColor.random()
end
end
end)

target
Przestarzałe

TargetFilter
Odczyt równoległy
Możliwości: Input
Mouse.TargetFilter:Instance

TargetSurface
Tylko do odczytu
Bez replikacji
Odczyt równoległy
Możliwości: Input
Mouse.TargetSurface:Enum.NormalId
Przykłady kodu
Losowy powieżchnię
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()
-- upewnij się, że mysz wskazuje na część
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
Tylko do odczytu
Bez replikacji
Odczyt równoległy
Możliwości: Input
Mouse.UnitRay:Ray

ViewSizeX
Tylko do odczytu
Bez replikacji
Odczyt równoległy
Możliwości: Input
Mouse.ViewSizeX:number
Przykłady kodu
Znormalizowana pozycja kursora
local Players = game:GetService("Players")
-- Uwaga: Należy użyć ContextActionService lub UserInputService zamiast
-- obiektu Mouse, aby zrealizować to zadanie.
local player = Players.LocalPlayer
local mouse = player:GetMouse()
local function onMouseMove()
-- Tworzenie obiektów Vector2 dla pozycji kursora i rozmiaru ekranu
local position = Vector2.new(mouse.X, mouse.Y)
local size = Vector2.new(mouse.ViewSizeX, mouse.ViewSizeY)
-- Znormalizowana pozycja mapuje lewy górny róg (tuż pod paskiem narzędzi)
-- na (0, 0), prawy dolny róg na (1, 1), a środek na (0.5, 0.5).
-- Jest to obliczane poprzez podzielenie pozycji przez całkowity rozmiar.
local normalizedPosition = position / size
print(normalizedPosition)
end
mouse.Move:Connect(onMouseMove)

ViewSizeY
Tylko do odczytu
Bez replikacji
Odczyt równoległy
Możliwości: Input
Mouse.ViewSizeY:number
Przykłady kodu
Znormalizowana pozycja kursora
local Players = game:GetService("Players")
-- Uwaga: Należy użyć ContextActionService lub UserInputService zamiast
-- obiektu Mouse, aby zrealizować to zadanie.
local player = Players.LocalPlayer
local mouse = player:GetMouse()
local function onMouseMove()
-- Tworzenie obiektów Vector2 dla pozycji kursora i rozmiaru ekranu
local position = Vector2.new(mouse.X, mouse.Y)
local size = Vector2.new(mouse.ViewSizeX, mouse.ViewSizeY)
-- Znormalizowana pozycja mapuje lewy górny róg (tuż pod paskiem narzędzi)
-- na (0, 0), prawy dolny róg na (1, 1), a środek na (0.5, 0.5).
-- Jest to obliczane poprzez podzielenie pozycji przez całkowity rozmiar.
local normalizedPosition = position / size
print(normalizedPosition)
end
mouse.Move:Connect(onMouseMove)

X
Tylko do odczytu
Bez replikacji
Odczyt równoległy
Możliwości: Input
Mouse.X:number
Przykłady kodu
Znormalizowana pozycja kursora
local Players = game:GetService("Players")
-- Uwaga: Należy użyć ContextActionService lub UserInputService zamiast
-- obiektu Mouse, aby zrealizować to zadanie.
local player = Players.LocalPlayer
local mouse = player:GetMouse()
local function onMouseMove()
-- Tworzenie obiektów Vector2 dla pozycji kursora i rozmiaru ekranu
local position = Vector2.new(mouse.X, mouse.Y)
local size = Vector2.new(mouse.ViewSizeX, mouse.ViewSizeY)
-- Znormalizowana pozycja mapuje lewy górny róg (tuż pod paskiem narzędzi)
-- na (0, 0), prawy dolny róg na (1, 1), a środek na (0.5, 0.5).
-- Jest to obliczane poprzez podzielenie pozycji przez całkowity rozmiar.
local normalizedPosition = position / size
print(normalizedPosition)
end
mouse.Move:Connect(onMouseMove)

Y
Tylko do odczytu
Bez replikacji
Odczyt równoległy
Możliwości: Input
Mouse.Y:number
Przykłady kodu
Znormalizowana pozycja kursora
local Players = game:GetService("Players")
-- Uwaga: Należy użyć ContextActionService lub UserInputService zamiast
-- obiektu Mouse, aby zrealizować to zadanie.
local player = Players.LocalPlayer
local mouse = player:GetMouse()
local function onMouseMove()
-- Tworzenie obiektów Vector2 dla pozycji kursora i rozmiaru ekranu
local position = Vector2.new(mouse.X, mouse.Y)
local size = Vector2.new(mouse.ViewSizeX, mouse.ViewSizeY)
-- Znormalizowana pozycja mapuje lewy górny róg (tuż pod paskiem narzędzi)
-- na (0, 0), prawy dolny róg na (1, 1), a środek na (0.5, 0.5).
-- Jest to obliczane poprzez podzielenie pozycji przez całkowity rozmiar.
local normalizedPosition = position / size
print(normalizedPosition)
end
mouse.Move:Connect(onMouseMove)

Zdarzenia
Button1Down
Możliwości: Input
Mouse.Button1Down():RBXScriptSignal

Button1Up
Możliwości: Input
Mouse.Button1Up():RBXScriptSignal

Button2Down
Możliwości: Input
Mouse.Button2Down():RBXScriptSignal

Button2Up
Możliwości: Input
Mouse.Button2Up():RBXScriptSignal

Idle
Możliwości: Input
Mouse.Idle():RBXScriptSignal
Przykłady kodu
Mysz.Nieaktywna
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("Klatka", frame, "- zdarzenie myszy zostało przekazane do", 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
Przestarzałe

keyDown
Przestarzałe

KeyUp
Przestarzałe

Move
Możliwości: Input
Mouse.Move():RBXScriptSignal
Przykłady kodu
Przesuwanie części za pomocą myszy
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
Możliwości: Input
Mouse.WheelBackward():RBXScriptSignal
Przykłady kodu
Mysz.KółkoWstecz
local Players = game:GetService("Players")
local player = Players.LocalPlayer
local mouse = player:GetMouse()
local function onWheelBackward()
print("Kółko poszło wstecz!")
end
mouse.WheelBackward:Connect(onWheelBackward)

WheelForward
Możliwości: Input
Mouse.WheelForward():RBXScriptSignal
Przykłady kodu
Mysz.KołoDoPrzodu
local Players = game:GetService("Players")
local player = Players.LocalPlayer
local mouse = player:GetMouse()
local function onWheelForward()
print("Koło poszło do przodu!")
end
mouse.WheelForward:Connect(onWheelForward)

©2026 Roblox Corporation. Nazwa Roblox, logo Roblox oraz hasło „Powering Imagination” należą do naszych zarejestrowanych i niezarejestrowanych znaków towarowych na terenie Stanów Zjednoczonych oraz w innych krajach.