Explosion

顯示已棄用項目

*此內容是使用 AI（Beta 測試版）翻譯，可能含有錯誤。若要以英文檢視此頁面，請按一下這裡。

在爆炸的 BaseParts 內，對 BlastRadius 加以力量。這種力量會在爆炸的 Class

如果體驗正在執行時，任何 Explosion 是在資料模型中的任何位置，它會立即崩溃，並且在幾秒鐘內變成未屬性。它不會在 Instance:Destroy() 中被摧毀，因此連接不會被�

注意，Explosion 必須是 Workspace 的後代，才能播放爆炸視覺和物理/傷害效果才會有影響。

爆炸效果

Humanoids 被爆炸擊殺，因為爆炸會斷裂角色的 Model 臥頸關組合。與 ForceField 模型親綁會保護所有其子從爆炸擊殺效果。

如果您不想要在 BaseParts 之間的關節被斷斷，或者您想要實現自己的方式來傷害 Humanoids ，建議您將 Class.Explosion.DestroyJointRadiusPercent|Destroy

爆炸也可以設定為對 Terrain 造成傷害，創建孔，按照 ExplosionType 屬性設定。

注意，爆炸的效果會因 不 受阻礙而發生延遲，因此在其他零件/地形後方的零件/地形仍會受影響。

範例程式碼

Explosion Instantiation
local explosion = Instance.new("Explosion")

explosion.BlastRadius = 60

explosion.ExplosionType = Enum.ExplosionType.Craters -- damages terrain

explosion.Position = Vector3.new(0, 10, 0)

explosion.Parent = workspace

概要

屬性

檢視繼承自Instance的所有項目
檢視繼承自Object的所有項目

活動

檢視繼承自Instance的所有項目
檢視繼承自Object的所有項目

屬性

BlastPressure

number
平行讀取

用於確定 BaseParts 被捕捉在 Explosion.BlastRadius 中的力量。

目前此力應用程式的力量不會因為Explosion.Position距離而變化。無夾定的BaseParts會在爆破範圍內無論距離如何提升。

爆炸壓力會決定零件因爆炸而產生的加速度。它不會決定零件是否被破壞。當 Explosion.DestroyJointRadiusPercent 等於 1 時，所有零件之間的關節都會被摧毀，提供 Explosion.BlastRadius 的爆炸壓力大於 0 時，所有零件都會被

爆壓也不會決定給 Terrain 的傷害。提供的爆壓大於 0 和 Explosion.ExplosionType 未設為 Enum.ExplosionType.NoCraters 創建的火山是由爆壓 Explosion.BlastRadius 決定

將 BlastPressure 設為 0 會抹滅爆炸的效果，並且對開發人員重要，當他們想要使用 Explosion.Hit 事件程式自訂爆炸行為。

範例程式碼

Custom Explosion
local function customExplosion(position, radius, maxDamage)

	local explosion = Instance.new("Explosion")

	explosion.BlastPressure = 0 -- this could be set higher to still apply velocity to parts

	explosion.DestroyJointRadiusPercent = 0 -- joints are safe

	explosion.BlastRadius = radius

	explosion.Position = position



	-- set up a table to track the models hit

	local modelsHit = {}



	-- listen for contact

	explosion.Hit:Connect(function(part, distance)

		local parentModel = part.Parent

		if parentModel then

			-- check to see if this model has already been hit

			if modelsHit[parentModel] then

				return

			end

			-- log this model as hit

			modelsHit[parentModel] = true



			-- look for a humanoid

			local humanoid = parentModel:FindFirstChild("Humanoid")

			if humanoid then

				local distanceFactor = distance / explosion.BlastRadius -- get the distance as a value between 0 and 1

				distanceFactor = 1 - distanceFactor -- flip the amount, so that lower == closer == more damage

				humanoid:TakeDamage(maxDamage * distanceFactor) -- TakeDamage to respect ForceFields

			end

		end

	end)



	explosion.Parent = game.Workspace



	-- Roblox removes explosions after a few seconds, but does not destroy them.

  	-- To ensure our .Hit connection gets disconnected, destroy the explosion once it's removed.

	explosion.AncestryChanged:Connect(function()

		if not explosion.Parent then

			explosion:Destroy()

		end

	end)

end



customExplosion(Vector3.new(0, 10, 0), 12, 50)

BlastRadius

number
平行讀取

此屬性決定 Explosion 的範圍，以 stud 計。此屬性接受任何值之間 0 和 100。

此範圍將爆炸的效果區域定義為爆炸視覺的大小，而不是 BlastRadius (即使是 0) 。爆炸的視覺效果大小無論如何都一樣。

BaseParts 內的爆炸將受到爆炸的影響。意味著，如果 Explosion.BlastPressure 大於 0，力量將被應用到零件。爆炸範

BaseParts 被視為在 Explosion.BlastRadius 內，即使只是部分範圍內。

範例程式碼

Explosion Instantiation
local explosion = Instance.new("Explosion")

explosion.BlastRadius = 60

explosion.ExplosionType = Enum.ExplosionType.Craters -- damages terrain

explosion.Position = Vector3.new(0, 10, 0)

explosion.Parent = workspace

DestroyJointRadiusPercent

number
平行讀取

用於將 Explosion.BlastRadius 的比例設置在 0 和 1 之間，在此範圍內所有關節都將被摧毀。任何超出此範圍的內容將只有 Explosion 的力量適用。

例如，如果 Explosion.BlastRadius 設為 100 ，而 DestroyJointRadiusPercent 設為 0.5，任何超過範圍 50 的關節都會損壞。任何超過範圍 50 和 100 的關節都不會被摧毀

這個屬性允許開發人員將 Explosions 變成 Humanoids ，以設定 DestroyJointRadiusPercent 為 0。這意味著頸部關節不會被斷裂，當角色與 Explosion 接觸時。

範例程式碼

Non lethal explosions
local function onDescendantAdded(instance)

	if instance:IsA("Explosion") then

		local explosion = instance

		explosion.DestroyJointRadiusPercent = 0



		local destroyJointRadiusPercent = 1

		explosion.Hit:Connect(function(part, distance)

			-- check the part is in range to break joints

			if distance <= destroyJointRadiusPercent * explosion.BlastRadius then

				-- make sure the part does not belong to a character

				if not game.Players:GetPlayerFromCharacter(part.Parent) then

					part:BreakJoints()

				end

			end

		end)

	end

end



workspace.DescendantAdded:Connect(onDescendantAdded)
Custom Explosion
local function customExplosion(position, radius, maxDamage)

	local explosion = Instance.new("Explosion")

	explosion.BlastPressure = 0 -- this could be set higher to still apply velocity to parts

	explosion.DestroyJointRadiusPercent = 0 -- joints are safe

	explosion.BlastRadius = radius

	explosion.Position = position



	-- set up a table to track the models hit

	local modelsHit = {}



	-- listen for contact

	explosion.Hit:Connect(function(part, distance)

		local parentModel = part.Parent

		if parentModel then

			-- check to see if this model has already been hit

			if modelsHit[parentModel] then

				return

			end

			-- log this model as hit

			modelsHit[parentModel] = true



			-- look for a humanoid

			local humanoid = parentModel:FindFirstChild("Humanoid")

			if humanoid then

				local distanceFactor = distance / explosion.BlastRadius -- get the distance as a value between 0 and 1

				distanceFactor = 1 - distanceFactor -- flip the amount, so that lower == closer == more damage

				humanoid:TakeDamage(maxDamage * distanceFactor) -- TakeDamage to respect ForceFields

			end

		end

	end)



	explosion.Parent = game.Workspace



	-- Roblox removes explosions after a few seconds, but does not destroy them.

  	-- To ensure our .Hit connection gets disconnected, destroy the explosion once it's removed.

	explosion.AncestryChanged:Connect(function()

		if not explosion.Parent then

			explosion:Destroy()

		end

	end)

end



customExplosion(Vector3.new(0, 10, 0), 12, 50)

ExplosionType

Enum.ExplosionType
平行讀取

這個屬性決定 Explosion 與 Terrain 的交互方式。它是一個枚列值 Class.ExplosionType ，可以設置為三個選項之一。

  • 無法攻擊者 - 爆炸不會傷害地形
  • 火山口 - 爆炸會在地形中創造火山口
  • CratersAndDebris - 重複，與Craters相同

如果 ExplosionType 設定在 Terrain 中創建火山口，火山口的範圍將大約等同於 Explosion.BlastRadius 。火山口是在所有 Terrain 材料中，除水以外，其大小不會受到材料的影響。火山口的大小不會受

範例程式碼

Stop Explosions from Damaging Terrain
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

number
隱藏
未複製
平行讀取

Position

Vector3
平行讀取

此屬性是 Explosion 的中心位置。它在世界空間中定義，並且不受 Explosion 的父元素親影響。

BaseParts 會受到 Explosion 的影響，如果它們位於 Explosion.BlastRadius 的爆炸範圍內。

爆炸的效果是即時的。這意味著爆炸的位置在設定後即可變更，但在它被設定後兩個區域之間無法影響。一旦爆炸被「爆炸」，在父輩對一個子孫的 Class.Workspace 後，它就不會再次發生。在某些情況下，爆炸的視覺效果會移動，但它沒有效果。

因此，如果開發人員想要爆炸出現在不同的位置，就必須建立新的爆炸。

範例程式碼

Explosion Instantiation
local explosion = Instance.new("Explosion")

explosion.BlastRadius = 60

explosion.ExplosionType = Enum.ExplosionType.Craters -- damages terrain

explosion.Position = Vector3.new(0, 10, 0)

explosion.Parent = workspace

TimeScale

number
平行讀取

一個值在 0 和 1 之間，控制粒子效果的速度。在 1 時，它以正常速度執行，在 0.5 時，它以半速度執行，並在 0 時凍結時間。

Visible

bool
平行讀取

此屬性決定是否顯示或不顯示 Explosion 的視覺效果。

當 Visible 設為 false 時，爆炸仍會影響 BaseParts 在其 Explosion.BlastRadius 中，唯一的區別是它不會被看到。

這個屬性的使用方式之一是，開發人員可以使用 ParticleEmitter 來自己製作自訂爆炸效果，而且保留 Explosion 的預設功能。

範例程式碼

Explosion Custom Visuals
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))
檢視繼承自Instance的所有項目
檢視繼承自Object的所有項目

方法

檢視繼承自Instance的所有項目
檢視繼承自Object的所有項目

活動

Hit

發生在 Explosion 擊中 BasePart 內的 Explosion.BlastRadius 內。返回零件擊以及零件從 1>Class.Explosion.Position1> 的距離。

注意，Explosion 的效果對障礙物不會受到影響，這意味著在其後的零件仍然會被擊中，即使BasePart 在障礙物後面錨定。

此事件還會在 Explosion.BlastPressure 與零相等時發生。這表示開發人員可以程式自己的自訂行為以對爆炸造成影響，而不會受到爆炸對 BaseParts 和 Terrain 的影響。

注意，這個事件會在每次擊中 BasePart 時發生。這意味著它可以發生多次對同一個玩家角色 (由角色 Model 組成的多個部分)。因此，當使用 Explosion.Hit 事件來

參數

part: BasePart

Class.BasePart 被 Explosion 擊中。

distance: number

從 Explosion.Position 的距離。


範例程式碼

Custom Explosion
local function customExplosion(position, radius, maxDamage)

	local explosion = Instance.new("Explosion")

	explosion.BlastPressure = 0 -- this could be set higher to still apply velocity to parts

	explosion.DestroyJointRadiusPercent = 0 -- joints are safe

	explosion.BlastRadius = radius

	explosion.Position = position



	-- set up a table to track the models hit

	local modelsHit = {}



	-- listen for contact

	explosion.Hit:Connect(function(part, distance)

		local parentModel = part.Parent

		if parentModel then

			-- check to see if this model has already been hit

			if modelsHit[parentModel] then

				return

			end

			-- log this model as hit

			modelsHit[parentModel] = true



			-- look for a humanoid

			local humanoid = parentModel:FindFirstChild("Humanoid")

			if humanoid then

				local distanceFactor = distance / explosion.BlastRadius -- get the distance as a value between 0 and 1

				distanceFactor = 1 - distanceFactor -- flip the amount, so that lower == closer == more damage

				humanoid:TakeDamage(maxDamage * distanceFactor) -- TakeDamage to respect ForceFields

			end

		end

	end)



	explosion.Parent = game.Workspace



	-- Roblox removes explosions after a few seconds, but does not destroy them.

  	-- To ensure our .Hit connection gets disconnected, destroy the explosion once it's removed.

	explosion.AncestryChanged:Connect(function()

		if not explosion.Parent then

			explosion:Destroy()

		end

	end)

end



customExplosion(Vector3.new(0, 10, 0), 12, 50)
檢視繼承自Instance的所有項目
檢視繼承自Object的所有項目