Apprendre
Classe de moteur
Mouse
Création impossible

*Ce contenu est traduit en utilisant l'IA (Beta) et peut contenir des erreurs. Pour consulter cette page en anglais, clique ici.



Référence API
Propriétés
Hit
Lecture uniquement
Non répliqué
Lecture parallèle
Capacités : Input
Mouse.Hit:CFrame
Échantillons de code
Faisceau Laser du Souris
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)
Origine de la souris vs Impact de la souris vs Position de 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
Déprécié

Icon
Lecture parallèle
Capacités : Input
Mouse.Icon:ContentId
Échantillons de code
Icône de souris dragon
local Players = game:GetService("Players")
local mouse = Players.LocalPlayer:GetMouse()
mouse.Icon = "http://www.roblox.com/asset?id=163023520"

IconContent
Lecture parallèle
Capacités : Input
Mouse.IconContent:Content
Échantillons de code
Icône de souris dragon
local Players = game:GetService("Players")
local mouse = Players.LocalPlayer:GetMouse()
mouse.Icon = "http://www.roblox.com/asset?id=163023520"

Origin
Lecture uniquement
Non répliqué
Lecture parallèle
Capacités : Input
Mouse.Origin:CFrame
Échantillons de code
Origine de la souris vs Impact de la souris vs Position de 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
Lecture uniquement
Non répliqué
Lecture parallèle
Capacités : Input
Mouse.Target:BasePart
Échantillons de code
Outil de Randomisation de Couleur
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("Cliqué :", target:GetFullName())
if target:IsA("BasePart") then
target.BrickColor = BrickColor.random()
end
end
end)

target
Déprécié

TargetFilter
Lecture parallèle
Capacités : Input
Mouse.TargetFilter:Instance

TargetSurface
Lecture uniquement
Non répliqué
Lecture parallèle
Capacités : Input
Mouse.TargetSurface:Enum.NormalId
Échantillons de code
Randomiseur de Surface
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()
-- assurez-vous que la souris pointe vers une pièce
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
Lecture uniquement
Non répliqué
Lecture parallèle
Capacités : Input
Mouse.UnitRay:Ray

ViewSizeX
Lecture uniquement
Non répliqué
Lecture parallèle
Capacités : Input
Mouse.ViewSizeX:number
Échantillons de code
Position de la souris normalisée
local Players = game:GetService("Players")
-- Remarque : Vous devriez utiliser ContextActionService ou UserInputService plutôt que
-- l'objet Mouse pour accomplir cette tâche.
local player = Players.LocalPlayer
local mouse = player:GetMouse()
local function onMouseMove()
-- Construire des objets Vector2 pour la position de la souris et la taille de l'écran
local position = Vector2.new(mouse.X, mouse.Y)
local size = Vector2.new(mouse.ViewSizeX, mouse.ViewSizeY)
-- Une position normalisée fera correspondre le coin supérieur gauche (juste sous la barre du haut)
-- à (0, 0), le coin inférieur droit à (1, 1) et le centre à (0.5, 0.5).
-- Cela est calculé en divisant la position par la taille totale.
local normalizedPosition = position / size
print(normalizedPosition)
end
mouse.Move:Connect(onMouseMove)

ViewSizeY
Lecture uniquement
Non répliqué
Lecture parallèle
Capacités : Input
Mouse.ViewSizeY:number
Échantillons de code
Position de la souris normalisée
local Players = game:GetService("Players")
-- Remarque : Vous devriez utiliser ContextActionService ou UserInputService plutôt que
-- l'objet Mouse pour accomplir cette tâche.
local player = Players.LocalPlayer
local mouse = player:GetMouse()
local function onMouseMove()
-- Construire des objets Vector2 pour la position de la souris et la taille de l'écran
local position = Vector2.new(mouse.X, mouse.Y)
local size = Vector2.new(mouse.ViewSizeX, mouse.ViewSizeY)
-- Une position normalisée fera correspondre le coin supérieur gauche (juste sous la barre du haut)
-- à (0, 0), le coin inférieur droit à (1, 1) et le centre à (0.5, 0.5).
-- Cela est calculé en divisant la position par la taille totale.
local normalizedPosition = position / size
print(normalizedPosition)
end
mouse.Move:Connect(onMouseMove)

X
Lecture uniquement
Non répliqué
Lecture parallèle
Capacités : Input
Mouse.X:number
Échantillons de code
Position de la souris normalisée
local Players = game:GetService("Players")
-- Remarque : Vous devriez utiliser ContextActionService ou UserInputService plutôt que
-- l'objet Mouse pour accomplir cette tâche.
local player = Players.LocalPlayer
local mouse = player:GetMouse()
local function onMouseMove()
-- Construire des objets Vector2 pour la position de la souris et la taille de l'écran
local position = Vector2.new(mouse.X, mouse.Y)
local size = Vector2.new(mouse.ViewSizeX, mouse.ViewSizeY)
-- Une position normalisée fera correspondre le coin supérieur gauche (juste sous la barre du haut)
-- à (0, 0), le coin inférieur droit à (1, 1) et le centre à (0.5, 0.5).
-- Cela est calculé en divisant la position par la taille totale.
local normalizedPosition = position / size
print(normalizedPosition)
end
mouse.Move:Connect(onMouseMove)

Y
Lecture uniquement
Non répliqué
Lecture parallèle
Capacités : Input
Mouse.Y:number
Échantillons de code
Position de la souris normalisée
local Players = game:GetService("Players")
-- Remarque : Vous devriez utiliser ContextActionService ou UserInputService plutôt que
-- l'objet Mouse pour accomplir cette tâche.
local player = Players.LocalPlayer
local mouse = player:GetMouse()
local function onMouseMove()
-- Construire des objets Vector2 pour la position de la souris et la taille de l'écran
local position = Vector2.new(mouse.X, mouse.Y)
local size = Vector2.new(mouse.ViewSizeX, mouse.ViewSizeY)
-- Une position normalisée fera correspondre le coin supérieur gauche (juste sous la barre du haut)
-- à (0, 0), le coin inférieur droit à (1, 1) et le centre à (0.5, 0.5).
-- Cela est calculé en divisant la position par la taille totale.
local normalizedPosition = position / size
print(normalizedPosition)
end
mouse.Move:Connect(onMouseMove)

Événements
Button1Down
Capacités : Input
Mouse.Button1Down():RBXScriptSignal

Button1Up
Capacités : Input
Mouse.Button1Up():RBXScriptSignal

Button2Down
Capacités : Input
Mouse.Button2Down():RBXScriptSignal

Button2Up
Capacités : Input
Mouse.Button2Up():RBXScriptSignal

Idle
Capacités : Input
Mouse.Idle():RBXScriptSignal
Échantillons de code
Souris.Inactive
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("Image", frame, "- l'événement de la souris a été transmis à", 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
Déprécié

keyDown
Déprécié

KeyUp
Déprécié

Move
Capacités : Input
Mouse.Move():RBXScriptSignal
Échantillons de code
Déplacer les pièces avec la souris
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
Capacités : Input
Mouse.WheelBackward():RBXScriptSignal
Échantillons de code
Souris.RouletteVersArrière
local Players = game:GetService("Players")
local player = Players.LocalPlayer
local mouse = player:GetMouse()
local function onWheelBackward()
print("La roulette est allée en arrière !")
end
mouse.WheelBackward:Connect(onWheelBackward)

WheelForward
Capacités : Input
Mouse.WheelForward():RBXScriptSignal
Échantillons de code
Souris.AvanceRoulette
local Players = game:GetService("Players")
local player = Players.LocalPlayer
local mouse = player:GetMouse()
local function onWheelForward()
print("La roulette est avancée!")
end
mouse.WheelForward:Connect(onWheelForward)

©2026 Société Roblox. Roblox, le logo Roblox et Powering Imagination font partie de nos marques déposées aux États-Unis et dans d'autres pays.