Forces (Effects) - emd4600/SporeModder-FX GitHub Wiki

Forces are not effect components, but they are used in some components like particles, metaParticles and ribbon.

These components can have local and global forces. Local forces can be accumulated with multiple force attributes, and end up just being a global vector3 force; for example, applying gravity is just increasing the -Z coordinate of the force vector.

Forces are a single command with many options. They use the keyword force.

Options

-reset

Resets the local forces to none. This can be used to clear the forces from a parent component.


-gravity <float>

Specifies the force of gravity, pulling the particles downwards (or upwards if the value is negative). This increases the global force in the -Z direction.


-wind <vector3> (<float>)

Specifies the local wind force. The first argument specifies the direction, and the second argument the strength factor of the wind. If no strength is specified, it's defaulted to 1.0


-worldWind <float>

A factor that specifies how much the particles are affected by the global wind force. By default it's 0.0 (not affected).


-worldGravity <float>

A factor that specifies how much the particles are affected by the global gravity force. By default it's 0.0 (not affected).

Extra Options (only for particles and metaParticles)

-bomb <float> (<vector3>)

This force pushes particles in all directions. The first argument is the strength, the second argument is the bomb origin (which is (0, 0, 0) by default). Multiple force statements with -bomb will not stack, they will replace the previous one.


-drag <float>


-presetAttractor <float: range> <float...: strength> -killRange <float>

-attractor <vector3> <float: range> <float...: strength> -killRange <float>

Attract particles around a point. -presetAttractor uses a default attraction point at the effect origin (0, 0, 0), whereas in the other you specify the attraction point.

The float values are the attraction strength; it's an animatable field, so different values can be used to change the attraction strength over the lifetime of the effect.

Apparently, particles that are farther than the range distance will not be attracted.

Attractors aren't untested, we don't know if they work.

⚠️ **GitHub.com Fallback** ⚠️