Aprenda
Classe do mecanismo
Explosion

*Este conteúdo é traduzido por IA (Beta) e pode conter erros. Para ver a página em inglês, clique aqui.


Amostras de código
Instanciação de Explosão
local explosion = Instance.new("Explosion")
explosion.BlastRadius = 60
explosion.ExplosionType = Enum.ExplosionType.Craters -- danifica o terreno
explosion.Position = Vector3.new(0, 10, 0)
explosion.Parent = workspace

Referência API
Propriedades
BlastPressure
Ler Parallel
Recursos: AvatarBehavior
Explosion.BlastPressure:number
Amostras de código
Explosão Personalizada
local function customExplosion(position, radius, maxDamage)
local explosion = Instance.new("Explosion")
explosion.BlastPressure = 0 -- isso pode ser configurado mais alto para ainda aplicar velocidade às partes
explosion.DestroyJointRadiusPercent = 0 -- articulações estão seguras
explosion.BlastRadius = radius
explosion.Position = position
-- configurar uma tabela para rastrear os modelos atingidos
local modelsHit = {}
-- ouvir o contato
explosion.Hit:Connect(function(part, distance)
local parentModel = part.Parent
if parentModel then
-- verificar se este modelo já foi atingido
if modelsHit[parentModel] then
return
end
-- registrar este modelo como atingido
modelsHit[parentModel] = true
-- procurar um humanoide
local humanoid = parentModel:FindFirstChild("Humanoid")
if humanoid then
local distanceFactor = distance / explosion.BlastRadius -- obter a distância como um valor entre 0 e 1
distanceFactor = 1 - distanceFactor -- inverter a quantidade, para que menor == mais próximo == mais dano
humanoid:TakeDamage(maxDamage * distanceFactor) -- TakeDamage para respeitar os ForceFields
end
end
end)
explosion.Parent = game.Workspace
-- Roblox remove explosões após alguns segundos, mas não as destrói.
-- Para garantir que nossa conexão .Hit seja desconectada, destrua a explosão assim que ela for removida.
explosion.AncestryChanged:Connect(function()
if not explosion.Parent then
explosion:Destroy()
end
end)
end
customExplosion(Vector3.new(0, 10, 0), 12, 50)

BlastRadius
Ler Parallel
Recursos: AvatarBehavior
Explosion.BlastRadius:number
Amostras de código
Instanciação de Explosão
local explosion = Instance.new("Explosion")
explosion.BlastRadius = 60
explosion.ExplosionType = Enum.ExplosionType.Craters -- danifica o terreno
explosion.Position = Vector3.new(0, 10, 0)
explosion.Parent = workspace

DestroyJointRadiusPercent
Ler Parallel
Recursos: AvatarBehavior
Explosion.DestroyJointRadiusPercent:number
Amostras de código
Explosões não letais
local function onDescendantAdded(instance)
if instance:IsA("Explosion") then
local explosion = instance
explosion.DestroyJointRadiusPercent = 0
local destroyJointRadiusPercent = 1
explosion.Hit:Connect(function(part, distance)
-- verifica se a parte está na distância para quebrar juntas
if distance <= destroyJointRadiusPercent * explosion.BlastRadius then
-- certifique-se de que a parte não pertence a um personagem
if not game.Players:GetPlayerFromCharacter(part.Parent) then
part:BreakJoints()
end
end
end)
end
end
workspace.DescendantAdded:Connect(onDescendantAdded)
Explosão Personalizada
local function customExplosion(position, radius, maxDamage)
local explosion = Instance.new("Explosion")
explosion.BlastPressure = 0 -- isso pode ser configurado mais alto para ainda aplicar velocidade às partes
explosion.DestroyJointRadiusPercent = 0 -- articulações estão seguras
explosion.BlastRadius = radius
explosion.Position = position
-- configurar uma tabela para rastrear os modelos atingidos
local modelsHit = {}
-- ouvir o contato
explosion.Hit:Connect(function(part, distance)
local parentModel = part.Parent
if parentModel then
-- verificar se este modelo já foi atingido
if modelsHit[parentModel] then
return
end
-- registrar este modelo como atingido
modelsHit[parentModel] = true
-- procurar um humanoide
local humanoid = parentModel:FindFirstChild("Humanoid")
if humanoid then
local distanceFactor = distance / explosion.BlastRadius -- obter a distância como um valor entre 0 e 1
distanceFactor = 1 - distanceFactor -- inverter a quantidade, para que menor == mais próximo == mais dano
humanoid:TakeDamage(maxDamage * distanceFactor) -- TakeDamage para respeitar os ForceFields
end
end
end)
explosion.Parent = game.Workspace
-- Roblox remove explosões após alguns segundos, mas não as destrói.
-- Para garantir que nossa conexão .Hit seja desconectada, destrua a explosão assim que ela for removida.
explosion.AncestryChanged:Connect(function()
if not explosion.Parent then
explosion:Destroy()
end
end)
end
customExplosion(Vector3.new(0, 10, 0), 12, 50)

ExplosionType
Ler Parallel
Recursos: AvatarBehavior
Explosion.ExplosionType:Enum.ExplosionType
Amostras de código
Impedir Explosões de Danificar o Terreno
local function onDescendantAdded(instance)
if instance:IsA("Explosion") then
instance.ExplosionType = Enum.ExplosionType.NoCraters
instance:GetPropertyChangedSignal("ExplosionType"):Connect(function()
instance.ExplosionType = Enum.ExplosionType.NoCraters
end)
end
end
workspace.DescendantAdded:Connect(onDescendantAdded)

LocalTransparencyModifier
Oculto
Não replicado
Ler Parallel
Recursos: AvatarBehavior
Explosion.LocalTransparencyModifier:number

Position
Ler Parallel
Recursos: AvatarBehavior
Explosion.Position:Vector3
Amostras de código
Instanciação de Explosão
local explosion = Instance.new("Explosion")
explosion.BlastRadius = 60
explosion.ExplosionType = Enum.ExplosionType.Craters -- danifica o terreno
explosion.Position = Vector3.new(0, 10, 0)
explosion.Parent = workspace

TimeScale
Ler Parallel
Recursos: AvatarBehavior
Explosion.TimeScale:number

Visible
Ler Parallel
Recursos: AvatarBehavior
Explosion.Visible:boolean
Amostras de código
Explosão Visuais Personalizados
local function customExplosion(position)
local explosion = Instance.new("Explosion")
explosion.Position = position
explosion.Visible = false
local attachment = Instance.new("Attachment")
attachment.Position = position
attachment.Parent = workspace.Terrain
local particleEmitter = Instance.new("ParticleEmitter")
particleEmitter.Enabled = false
particleEmitter.Parent = attachment
particleEmitter.Speed = NumberRange.new(5, 30)
particleEmitter.SpreadAngle = Vector2.new(-90, 90)
explosion.Parent = workspace
particleEmitter:Emit(20)
task.delay(5, function()
if attachment then
attachment:Destroy()
end
end)
end
customExplosion(Vector3.new(0, 10, 0))

Eventos
Hit
Recursos: AvatarBehavior
Explosion.Hit(
part:BasePart, distance:number
Parâmetros
distance:number
Amostras de código
Explosão Personalizada
local function customExplosion(position, radius, maxDamage)
local explosion = Instance.new("Explosion")
explosion.BlastPressure = 0 -- isso pode ser configurado mais alto para ainda aplicar velocidade às partes
explosion.DestroyJointRadiusPercent = 0 -- articulações estão seguras
explosion.BlastRadius = radius
explosion.Position = position
-- configurar uma tabela para rastrear os modelos atingidos
local modelsHit = {}
-- ouvir o contato
explosion.Hit:Connect(function(part, distance)
local parentModel = part.Parent
if parentModel then
-- verificar se este modelo já foi atingido
if modelsHit[parentModel] then
return
end
-- registrar este modelo como atingido
modelsHit[parentModel] = true
-- procurar um humanoide
local humanoid = parentModel:FindFirstChild("Humanoid")
if humanoid then
local distanceFactor = distance / explosion.BlastRadius -- obter a distância como um valor entre 0 e 1
distanceFactor = 1 - distanceFactor -- inverter a quantidade, para que menor == mais próximo == mais dano
humanoid:TakeDamage(maxDamage * distanceFactor) -- TakeDamage para respeitar os ForceFields
end
end
end)
explosion.Parent = game.Workspace
-- Roblox remove explosões após alguns segundos, mas não as destrói.
-- Para garantir que nossa conexão .Hit seja desconectada, destrua a explosão assim que ela for removida.
explosion.AncestryChanged:Connect(function()
if not explosion.Parent then
explosion:Destroy()
end
end)
end
customExplosion(Vector3.new(0, 10, 0), 12, 50)

©2026 Roblox Corporation, Roblox, o logotipo Roblox e Powering Imagination estão entre nossas marcas registradas e não registradas nos EUA e em outros países.