Trails

Spawn particles behind projectiles

Trails tutorial

  Trail:
    Distance_Between_Particles: <distance>
    Hide_Trail_For: <distance>
    Shape: <LINE/SPIRAL/POLAR/PARAMETRIC>
    Shape_Data:
      Radius: <distance>
      Points: <amount>
      Loops: <amount>
      Function: <String>
      Cache: <true/false>
    Particle_Chooser: <STOP/RANDOM/LOOP>
    Particles:
      - <Particle1>
      - <Particle2>
      - <etc...>

Distance_Between_Particles

This is the distance, in blocks, between each particle spawn. Usually, you want this number to be a little bit less than 1.0. Using a tiny number like 0.1 may allow you to create a "perfect line," but this will cause both server/player lag.

Hide_Trail_For

This is the distance, in blocks, before the trail starts showing particles. This creates a small gap between the shooter and the trail, so it doesn't cover the player's screen. Defaults to 0.5 blocks. I recommend a value between 0.5 and 1.5, but you can set these numbers as high as you want.

Shape

Defines the shape of the trail. For most use cases, you would only ever want to use LINE. However, the other options are great for magic/energy weapons.

LINE

A straight line of particles, perfectly following the path of the projectile.

Takes no arguments.

SPIRAL

POLAR

PARAMETRIC

Shape_Data

• Radius -> How far away from the projectile to spawn the spiral particles

• Points -> How many points will the circle have? Bigger numbers = more detail. Recommend 16 or higher.

• Loops -> How many spirals should we draw at once?

• Function -> A polar equation that supports math operations. Try "2 * cos(4 * theta)".

  • If you use PARAMETRIC, use a parametric equation.

  • Separate two equations with a comma. Try "0.1805,0.0805"

  • This also supports equations. Try "0.1805 / exp(-theta), 0.0805 / exp(-theta)"

• Cache -> Use true to calculate the values once and store them. 99% of the time, you want this to be true.

Particle_Chooser

Defines how to choose particles from the following list.

STOP

Loop through the particle list 1 time. Once we reach the end of the list, repeat the last particle for the rest of the trail.

RANDOM

LOOP

Particles

This list of particles will be spawned to visualize the trail. Check out the Particle mechanic to learn how to create particles.

Example

This example spawns 3 smoke particles with some variation every 1 block. This effectively makes small smoke clouds every block.

  Trail:
    Distance_Between_Particles: 1.0
    Particle_Chooser: LOOP
    Particles:
      - "Particle{particle=SMOKE_NORMAL, count=3, noise=0.01 0.01 0.01}"