Utility/Effects/FreezeEffect.cs

Static helper that spawns the freeze or unfreeze particle prefab on a target GameObject and flashes any related outlines. Respects the physgun freeze effect preferences and leaves broadcasting to the caller.

/// <summary>
/// The burst of particles on something being frozen or unfrozen, by the physgun or while driving it.
/// </summary>
public static class FreezeEffect
{
	const string FreezePrefab = "/weapons/physgun/effects/freeze.prefab";
	const string UnfreezePrefab = "/weapons/physgun/effects/unfreeze.prefab";

	/// <summary>
	/// Play the freeze or unfreeze effect on <paramref name="target"/>, here only. Callers broadcast it themselves.
	/// </summary>
	public static void Play( GameObject target, bool frozen, IEnumerable<GameObject> flash = null )
	{
		if ( !target.IsValid() ) return;
		if ( !(frozen ? GamePreferences.PhysgunFreezeEffect : GamePreferences.PhysgunUnfreezeEffect) ) return;

		if ( ResourceLibrary.Get<PrefabFile>( frozen ? FreezePrefab : UnfreezePrefab ) is { } prefab )
		{
			var effect = GameObject.Clone( prefab, new CloneConfig { Transform = target.WorldTransform, StartEnabled = true } );
			foreach ( var emitter in effect.GetComponentsInChildren<ParticleModelEmitter>() )
			{
				emitter.Target = target;
			}
		}

		if ( flash is null ) return;

		foreach ( var outlined in flash.Select( ObjectHighlight.GetTarget ).Distinct() )
		{
			ObjectHighlight.Flash( outlined, HighlightStyle.Selected );
		}
	}
}