Trails

  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: <distance>

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

Hide_Trail_For: <distance>

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: <LINE/SPIRAL/POLAR>

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:
  • Straight line of particles, perfectly following the path of the projectile.
  • Takes no arguments.
• SPIRAL:
  • A circle of particles traveling around the path of the projectile.
  • Takes the arguments: Radius, Points, and Loops.
• POLAR:
  • A custom spiral function... Suitable for flowers or other effects.
  • Takes the arguments: Points, Loops, Function, and Cache.
• PARAMETRIC:
  • A custom x, y function... Suitable for offsets and spirals.
  • Takes the arguments: Points, Loops, Function, and Cache.
  • Make sure you specify two functions in Function, separated with a comma.

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: <STOP/RANDOM/LOOP>

Defines how to choose particles from the following list.

• STOP: After we reach the last particle in the list, repeat that last particle for the rest of the trail.
• RANDOM: Always choose a random particle from the list.
• LOOP: After we reach the last particle in the list, restart at the beginning.

Particles:

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