Aprender
Clase de motor
Tool

*Este contenido se traduce usando la IA (Beta) y puede contener errores. Para ver esta página en inglés, haz clic en aquí.


Muestras de código
Ejemplo de Herramienta de Explosión
local tool = script.Parent
local function explode(point)
local e = Instance.new("Explosion")
e.DestroyJointRadiusPercent = 0 -- Hacer que la explosión no sea letal
e.Position = point
e.Parent = workspace
end
local function onActivated()
-- Obtener el Humanoid que activó la herramienta
local human = tool.Parent.Humanoid
-- Llamar a explode con el punto actual al que el Humanoid está apuntando
explode(human.TargetPoint)
end
tool.Activated:Connect(onActivated)
Ejemplo de herramienta de espada
local tool = script.Parent
local function onTouch(partOther)
-- Primero, intenta ver si la parte que tocamos era parte de un Humanoide
local humanOther = partOther.Parent:FindFirstChild("Humanoid")
-- Ignora toques de no-humanoides
if not humanOther then
return
end
-- Ignora toques del Humanoide que lleva la espada
if humanOther.Parent == tool.Parent then
return
end
humanOther:TakeDamage(5)
end
-- Desencadena una animación de corte
local function slash()
-- Los scripts de personaje predeterminados escucharán un "toolanim" StringValue
local value = Instance.new("StringValue")
value.Name = "toolanim"
value.Value = "Corte" -- prueba también: Lanzamiento
value.Parent = tool
end
tool.Activated:Connect(slash)
tool.Handle.Touched:Connect(onTouch)

Referencia API
Propiedades
CanBeDropped
Leer paralelo
Capacidades: Input
Tool.CanBeDropped:boolean

Enabled
Leer paralelo
Capacidades: Input
Acceso a la simulación
Tool.Enabled:boolean
Muestras de código
Herramienta de Super Salto
local Players = game:GetService("Players")
local player = Players.LocalPlayer
local character = player.Character or player.CharacterAdded:Wait()
local humanoid = character:WaitForChild("Humanoid")
local tool = Instance.new("Tool")
tool.Name = "SuperJump"
tool.RequiresHandle = false
tool.Parent = player.Backpack
function toolActivated()
humanoid.JumpPower = 150
tool.Enabled = false
task.wait(5)
tool.Enabled = true
humanoid.JumpPower = 50
end
tool.Activated:Connect(toolActivated)
tool.Unequipped:Connect(function()
humanoid.JumpPower = 50
end)

Grip
Leer paralelo
Capacidades: Input
Acceso a la simulación
Tool.Grip:CFrame
Muestras de código
Palanca de Agarre
local Players = game:GetService("Players")
local player = Players.LocalPlayer
local tool = Instance.new("Tool")
tool.Name = "Stick"
tool.Parent = player.Backpack
local handle = Instance.new("Part")
handle.Name = "Handle"
handle.Parent = tool
handle.Size = Vector3.new(0.1, 3, 0.1)
handle.Color = Color3.fromRGB(108, 88, 75) -- Marrón
tool.Activated:Connect(function()
print(tool.Grip)
print(tool.GripUp)
print(tool.GripRight)
print(tool.GripForward)
print(tool.GripPos)
end)

GripForward
Oculto
No replicado
Leer paralelo
Capacidades: Input
Tool.GripForward:Vector3
Muestras de código
Palanca de Agarre
local Players = game:GetService("Players")
local player = Players.LocalPlayer
local tool = Instance.new("Tool")
tool.Name = "Stick"
tool.Parent = player.Backpack
local handle = Instance.new("Part")
handle.Name = "Handle"
handle.Parent = tool
handle.Size = Vector3.new(0.1, 3, 0.1)
handle.Color = Color3.fromRGB(108, 88, 75) -- Marrón
tool.Activated:Connect(function()
print(tool.Grip)
print(tool.GripUp)
print(tool.GripRight)
print(tool.GripForward)
print(tool.GripPos)
end)

GripPos
Oculto
No replicado
Leer paralelo
Capacidades: Input
Tool.GripPos:Vector3
Muestras de código
Palanca de Agarre
local Players = game:GetService("Players")
local player = Players.LocalPlayer
local tool = Instance.new("Tool")
tool.Name = "Stick"
tool.Parent = player.Backpack
local handle = Instance.new("Part")
handle.Name = "Handle"
handle.Parent = tool
handle.Size = Vector3.new(0.1, 3, 0.1)
handle.Color = Color3.fromRGB(108, 88, 75) -- Marrón
tool.Activated:Connect(function()
print(tool.Grip)
print(tool.GripUp)
print(tool.GripRight)
print(tool.GripForward)
print(tool.GripPos)
end)

GripRight
Oculto
No replicado
Leer paralelo
Capacidades: Input
Tool.GripRight:Vector3
Muestras de código
Palanca de Agarre
local Players = game:GetService("Players")
local player = Players.LocalPlayer
local tool = Instance.new("Tool")
tool.Name = "Stick"
tool.Parent = player.Backpack
local handle = Instance.new("Part")
handle.Name = "Handle"
handle.Parent = tool
handle.Size = Vector3.new(0.1, 3, 0.1)
handle.Color = Color3.fromRGB(108, 88, 75) -- Marrón
tool.Activated:Connect(function()
print(tool.Grip)
print(tool.GripUp)
print(tool.GripRight)
print(tool.GripForward)
print(tool.GripPos)
end)

GripUp
Oculto
No replicado
Leer paralelo
Capacidades: Input
Tool.GripUp:Vector3
Muestras de código
Palanca de Agarre
local Players = game:GetService("Players")
local player = Players.LocalPlayer
local tool = Instance.new("Tool")
tool.Name = "Stick"
tool.Parent = player.Backpack
local handle = Instance.new("Part")
handle.Name = "Handle"
handle.Parent = tool
handle.Size = Vector3.new(0.1, 3, 0.1)
handle.Color = Color3.fromRGB(108, 88, 75) -- Marrón
tool.Activated:Connect(function()
print(tool.Grip)
print(tool.GripUp)
print(tool.GripRight)
print(tool.GripForward)
print(tool.GripPos)
end)

ManualActivationOnly
Leer paralelo
Capacidades: Input
Tool.ManualActivationOnly:boolean
Muestras de código
Herramienta de Sprint
local Players = game:GetService("Players")
local player = Players.LocalPlayer
local character = player.Character or player.CharacterAdded:Wait()
local humanoid = character:WaitForChild("Humanoid")
local tool = Instance.new("Tool")
tool.Name = "Sprint"
tool.RequiresHandle = false
tool.Parent = player:WaitForChild("Backpack")
function toolActivated()
humanoid.WalkSpeed = 30
tool.ManualActivationOnly = true
task.wait(5)
tool.ManualActivationOnly = false
humanoid.WalkSpeed = 16
end
tool.Activated:Connect(toolActivated)
tool.Unequipped:Connect(function()
humanoid.WalkSpeed = 16
end)

RequiresHandle
Leer paralelo
Capacidades: Input
Tool.RequiresHandle:boolean

ToolTip
Leer paralelo
Capacidades: Input
Tool.ToolTip:string

Métodos
Activate
Capacidades: Input
Tool:Activate():()
Devuelve
()
Muestras de código
Herramienta de Invisibilidad
local Players = game:GetService("Players")
local player = Players.LocalPlayer
local character = player.Character
local tool = Instance.new("Tool")
tool.Name = "Herramienta de Invisibilidad"
tool.RequiresHandle = false
tool.Parent = player.Backpack
local invisible = false
local function toolActivated()
if invisible then
return
end
invisible = true
for _, bodypart in pairs(character:GetChildren()) do
if bodypart:IsA("MeshPart") or bodypart:IsA("Part") then
bodypart.Transparency = 1
end
end
task.wait(3)
tool:Deactivate()
task.wait(1)
invisible = false
end
local function toolDeactivated()
if not invisible then
return
end
for _, bodypart in pairs(character:GetChildren()) do
if bodypart.Name ~= "HumanoidRootPart" then
if bodypart:IsA("MeshPart") or bodypart:IsA("Part") then
bodypart.Transparency = 0
end
end
end
end
local function toolEquipped()
tool:Activate()
end
tool.Equipped:Connect(toolEquipped)
tool.Activated:Connect(toolActivated)
tool.Deactivated:Connect(toolDeactivated)
tool.Unequipped:Connect(toolDeactivated)

Deactivate
Capacidades: Input
Tool:Deactivate():()
Devuelve
()
Muestras de código
Herramienta de Invisibilidad
local Players = game:GetService("Players")
local player = Players.LocalPlayer
local character = player.Character
local tool = Instance.new("Tool")
tool.Name = "Herramienta de Invisibilidad"
tool.RequiresHandle = false
tool.Parent = player.Backpack
local invisible = false
local function toolActivated()
if invisible then
return
end
invisible = true
for _, bodypart in pairs(character:GetChildren()) do
if bodypart:IsA("MeshPart") or bodypart:IsA("Part") then
bodypart.Transparency = 1
end
end
task.wait(3)
tool:Deactivate()
task.wait(1)
invisible = false
end
local function toolDeactivated()
if not invisible then
return
end
for _, bodypart in pairs(character:GetChildren()) do
if bodypart.Name ~= "HumanoidRootPart" then
if bodypart:IsA("MeshPart") or bodypart:IsA("Part") then
bodypart.Transparency = 0
end
end
end
end
local function toolEquipped()
tool:Activate()
end
tool.Equipped:Connect(toolEquipped)
tool.Activated:Connect(toolActivated)
tool.Deactivated:Connect(toolDeactivated)
tool.Unequipped:Connect(toolDeactivated)

Eventos
Activated
Capacidades: Input
Tool.Activated():RBXScriptSignal

Deactivated
Capacidades: Input
Tool.Deactivated():RBXScriptSignal

Equipped
Capacidades: Input
Tool.Equipped(mouse:Mouse):RBXScriptSignal
Parámetros
mouse:Mouse
Muestras de código
Imprimir cuando un Jugador Equipar una Herramienta
local Tool = script.Parent
local function onEquipped(_mouse)
print("La herramienta fue equipada")
end
Tool.Equipped:Connect(onEquipped)

Unequipped
Capacidades: Input
Tool.Unequipped():RBXScriptSignal

©2026 Roblox Corporation. Roblox, el logotipo de Roblox y "Powering Imagination" son algunas de nuestras marcas registradas y no registradas en los Estados Unidos y otros países.