Source Code

effect: particles

Plays a particle effect.

Since 4.0 Beta 13 these options support dynamic values through numeric or string expressions.

Some particles have exceptions to how the above values are used in order to configure their custom data:

Coloring these particles requires:

• count: 0 - It'll then only spawn one particle. If you need to spawn more, you'll have to make the effect play multiple times, probably by using a Dummy Buff spell, and having the effect on the buff position, controlling the duration of the particles with the buff's duration, and the interval with the buff position's effect-interval: <ticks>.
• speed - Used to act like values instead of RGBE, where speed acts like an exponent that makes colors brighter or dimmer. The default for this is 128.
• x/y/z-offset will be used to control the color as (red, green, and blue) colors respectively. Values must be up to 1.0. This means that the value should be color/255.

Example below. Note that since 4.0 Beta 13, you don't have to calculate the color as the equation will be understood and calculated by MS. You can find a color picker here - set the red, green, and blue values to the RGB color values.

particle-name: entity_effect
count: 0
speed: 1
x-spread: red / 255
y-spread: green / 255
z-spread: blue / 255

Coloring these particles requires:

• count: 0 - It'll then only spawn one particle. See above for a way to spawn more.
• speed: 1 - Used as a multiplier for colors.
• x-spread will be used to control the color. Must be up to 1.0. There are 24 notes and their colors, so the color value should be note/24.
• y-spread: 0
• z-spread: 0

Example below. Note that since 4.0 Beta 13, you don't have to calculate the color as the equation will be understood and calculated by MS.

particle-name: note
count: 0
speed: 1
x-spread: note / 24
y-spread: 0
z-spread: 0

Some particles have motion. You apply it by having:

• count: 0 - It'll only spawn one particle.
• speed: 1 - Acts like a multiplier for the motion.
• x/y/z-spread - Moton vector

lava_buff:
    spell-class: ".buff.DummySpell"
    duration: 10
    effects:
      lava:
        effect-interval: 5
        position: buff
        effect: particles
        particle-name: lava
        horiz-spread: 0.3
        vert-spread: 0.3
        speed: 0.2
        count: 8