cutTrailsOnEntity

open fun cutTrailsOnEntity(entity: CombatEntityAPI)

"Cuts" all trails on a designated entity, forcing new trail pieces to not link up with old ones. Should be used before teleporting any entity, since it may have trails attached to it which will otherwise stretch in unintended ways.

This can also be called (with a potential 1-frame delay) by adding an entity to any CustomData in the CombatEngineAPI with a key containing the phrase "MagicTrailPlugin_LIB_FREE_TRAIL_CUT" (note: *containing*. there must be more to the key than this, as it should be unique [optimally, use your modID and the ID of the ship trying to cut the trails]). This alternate calling method does not require MagicLib, and may thus be optimal for smaller mods or mods that don't want any other MagicLib features but still needs trail-cutting support

Parameters

entity

The entity you want to cut all trails on