Skip to main content

Particles.ParticleDescription

Custom particle type params object.

Index

Properties

Properties

optionalacceleration

acceleration?: [number, number, number] = [number, number, number]

Particle's acceleration, if it's spawned without this parameter.

optionaladdLifetimeAfterImpact

addLifetimeAfterImpact?: number = 0

Particle will lose given number of ticks from it's maximum lifetime, when touching a block.

More about capabilities

This value makes sense only if collision param is true.

optionalanimators

animators?: { alpha?: AnimatorDescription; color?: ColorAnimatorDescription; icon?: AnimatorDescription; size?: AnimatorDescription; texture?: AnimatorDescription }

Animators allow to change some properties of the specific particle depending on the time, each animator is described as an object of definite format and can be not described, if it's not needed.

Type declaration

  • optionalalpha?: AnimatorDescription

    Describes the particle's opacity, for the unit value the alpha in the color parameter from the type's description is taken.

  • optionalcolor?: ColorAnimatorDescription

    Describes the animated color value, if particle supports it. Accepts values in RGBA ranges, like color property in descriptor.

  • optionalicon?: AnimatorDescription

    Describes the animation frame, if particle supports it. Must have the value between 0 and 1.

  • optionalsize?: AnimatorDescription

    Describes the behavior of particle's size, for the unit size the size from the type's description is taken.

  • optionaltexture?: AnimatorDescription

    Describes the animation frame, if particle supports it. Must have the value between 0 and 1.

    That feature is obsolete

    Use icon instead.

optionalcollision

collision?: boolean = false.

If true, particle won't go through blocks. It reduces performance if there are lots of these particles.

optionalcolor

color?: [number, number, number, number] = [number, number, number, number]

Four component color of the particle (RGBA).

optionalcolor2
since: 2.0.4b38

color2?: [number, number, number, number]

optionalemitters

emitters?: { death?: SubEmitterDescription; idle?: SubEmitterDescription; impact?: SubEmitterDescription }

Sub-emitters (don't confuse with emitters) describe how specific particle can emit other particles, according to some events, that may happen to it. Each sub-emitter is described as an object of definite format and can be not described if it's not needed.

Type declaration

optionalframesX
since: 2.0.4b38

framesX?: number

Animation frame grid size around width.

optionalframesY
since: 2.0.4b38

framesY?: number

Animation frame grid size around height.

optionalfriction

friction?: { air?: number; block?: number }

Particle's speed modifier in the air and when touching a block. Usually it's a number between 0 and 1, close to 1, but in fact it can be any value. Both values are 1 by default.

Type declaration

  • optionalair?: number
  • optionalblock?: number
    More about capabilities

    This value makes sense only if collision param is true.

optionalisUsingBlockLight

isUsingBlockLight?: boolean = false.

If true, the particle will be exposed to the world's lighting. If false, the particle will always have maximum brightness. Enabling this parameter may reduce the performance when having lots of particles.

optionalkeepVelocityAfterImpact

keepVelocityAfterImpact?: boolean

If false, particle's speed will be set to zero when touching a block. If true, the speed will be saved.

More about capabilities

This value makes sense only if collision param is true.

lifetime

lifetime: [number, number]

Minimum and maximum particle's lifetime in ticks.

optionalrebuildDelay
since: 2.0.4b38

rebuildDelay?: number

Time in ticks between particle mesh updates.

optionalrender

render?: number

Particle's render type:

  • 0 - additive
  • 1 - without blending
  • 2 - with blending

size

size: [number, number]

Minimum and maximum size of the particle.

texture

texture: string

Particle's texture name from /particle-atlas resource directory.

optionalvelocity

velocity?: [number, number, number] = [number, number, number]

Particle's initial velocity, if it's spawned without initial speed parameter.