Tested with: KSA Version 2026.10.19.5638
When a vessel or part is destroyed, the game plays an explosion: a light flash, a sound, volumetric fire and smoke, and particle emitters for debris and sparks. All of it is defined in
Content\Core\ExplosionAssets.xml, which Core lists under assets in its mod.toml. The file's comments are detailed and worth reading.
Since 2026.10.13.5602 there is one set of explosions for both atmosphere and vacuum. Each explosion adapts to the air pressure where it goes off.
The game picks one of four explosion ids by how much propellant was involved:
| Id | When |
|---|---|
Explosion_Conflagration |
5000 kg of propellant or more |
SmallFire |
more than 10 kg of propellant |
MetalBurst |
less, destroyed in a collision |
PopSmallExplosion |
less, any other cause. Also any single part that breaks off and holds no tank or solid fuel. |
These ids are fixed in code. You cannot add a new trigger from XML, but you can change what these four look like (see Replacing a stock explosion).
The size scales with the energy released, at 1 MJ per kg of propellant, against a reference of 50 GJ. Visuals grow with the cube root of that ratio, which is clamped to 0.05 to 100.
<Explosion Id="SmallFire">
<Flash PeakIntensity="500" Range="20" DecaySeconds="0.5" LifeSeconds="1" CastShadows="false" ColorMidAt="0.3">
<ColorStart R="1" G="0.97" B="0.9"/>
<ColorMid R="1" G="0.72" B="0.28"/>
<ColorEnd R="1" G="0.25" B="0.05"/>
</Flash>
<SoundEvent SoundId="Explosion"/>
<VolumeRef Id="FireballVolumeSmall" Delay="0" Intensity="1" FallbackEmitterId="FireBallSmall"/>
<EmitterRef Id="ExplosionSparks" Delay="0" Intensity="3"/>
<EmitterRef Id="Embers" Delay="0" Intensity="1"/>
</Explosion>
| Element | What it does |
|---|---|
<Flash> |
A point light. PeakIntensity, Range in metres, DecaySeconds, LifeSeconds, CastShadows, and a three-stop colour ramp with the middle stop at ColorMidAt. |
<SoundEvent SoundId> |
A sound or <MultiSound> id. Stock uses Explosion and ExplosionBig, defined further down the same file. |
<VolumeRef> |
A volumetric fire or smoke volume, by <ExplosionVolumeTemplate> id. |
<EmitterRef> |
A particle emitter, by id. |
<VolumeRef> and <EmitterRef> share these attributes:
| Attribute | What it does |
|---|---|
Delay |
Seconds after the explosion before this stage starts. |
Intensity |
Multiplier on this stage's size. |
MinPressurePa / MaxPressurePa |
Only play this stage if the air pressure is in this range. Stock uses 500 Pa to switch debris emitters between atmosphere and vacuum versions. |
FallbackEmitterId |
<VolumeRef> only. A particle emitter to use instead when the volume cannot be drawn. |
During fast time warp only the flash and sound play.
The volumetric fireballs and smoke. These have many attributes for the look of the fire, smoke and soot, plus curves for radius, fade, density, emission and temperature over the volume's life. The comments in ExplosionAssets.xml explain the stock values, and omitted attributes take the game's defaults. Volumes are authored at sea level and expand on their own in thinner air.
<ExplosionVolumeLook Id="ExplosionVolumeLook"> is a global grade over every volume.
Explosion ids are registered first come, first served, like shaders: a duplicate id is ignored, not merged.
To change a stock explosion, define an <Explosion> with the same id in your mod's assets, and list your mod above Core in manifest.toml. The Shaders page shows the manifest layout.
Copy the whole stock definition and edit it. Yours replaces it entirely.
explode <vehicle id> [explosion id] in the console destroys a vehicle, optionally with a specific explosion.Core. Core's version registers first and yours is ignored.MaxPressurePa vacuum variant for a debris emitter, so nothing plays in space.