vfx-hit-spark

Call HitSpark.spawn_hit_spark with the scene tree root, the raycast hit position, and the hit normal. The helper instantiates the spark scene, orients it to the surface normal, restarts the one-shot burst, and frees it after the particle lifetime.

Set one_shot = true, emitting = false, and explosiveness = 1.0 so all particles spawn in the first frame. Then call restart() and set emitting = true when the burst should fire, and free the node after the lifetime expires.

BaseMaterial3D is abstract and cannot be constructed, so calling BaseMaterial3D.new() is a parse error that breaks the whole script. Instantiate StandardMaterial3D instead; the BaseMaterial3D.* enum constants remain valid for setting transparency, blend mode, and billboard mode.

The emitter was never oriented to the impact normal. The spawn helper uses look_at toward position plus normal, then rotates -90 degrees around local X because look_at uses -Z as forward, aligning the cone direction with the surface.

Use hit sparks for a spray of particles at the impact point. Use a muzzle-flash recipe for a flash at the gun end, and spawn RigidBody3D shards for physical debris like rock pieces, optionally layering sparks on top.

Spawn sparks client-side based on hit events rather than replicating the spark node itself, since replicating transient particle nodes wastes bandwidth. Each client instantiates its own local burst when it receives the hit event.