User Tools

Site Tools


add_effect

Add Effect


Adds an effect at the specified coordinate within the map. The entity ID is optional and will be assigned to the new effect if supplied. If the effect is configured as “One Shot”, it will need to be enabled via the Enable Effect function once it has been added to the map.

Signature:

add_effect(effect_name, coordinate, entity_id)
ArgumentDescriptionTypeRequired
effect_nameParticle effect to use for the new effect.StringYes
coordinateCoordinate where the effect will be placed.CoordinateYes
entity_idUnique entity ID that will be assigned.StringNo

The Remove Entity function can be triggered later to remove an effect that was previously added to the scene with the Add Effect function.

Return ValueDescriptionType
Effect AddedReturns a reference to the effect that was added.Entity

Example:

add_effect("flame", coord[0, 0, 0], "flame_01");

Results: A flame effect will be added to the map at the XYZ coordinate of (0, 0, 0) and will be assigned an ID of “flame_01”.

Use the Add Effect function to add weather or environmental effects to a scene, e.g. rain or snow to cover an outdoor map, or flames to indicate that something has caught on fire.


Editor Node:

add_effect.txt · Last modified: 2024/01/27 14:24 by justin