Projectile Spread Systems

Overview

The Projectile Spread system provides reusable handlers for creating various projectile patterns. It includes mechanics for arc-based spreads, alternating barrages, and piercing projectiles.

Projectile Spread

Fires projectiles in an arc pattern from a single origin point.

Basic Usage

my_spread_attack:
  Skills:
  - skill:projectile_spread{
      origin=@SelfEyeLocation;
      points=5;
      arc=45;
      radius=8;
      id=[
        - projectile{v=40;onHit=[- damage{a=10}]}
      ]
    } @forward{f=1;uel=true}

Parameters

points

integer

default:"3"

Number of projectiles to fire

arc

integer

default:"points * 8"

Total arc angle in degrees across which projectiles are distributed

radius

float

default:"6"

Distance from origin where projectiles are fired toward

duration

integer

default:"0"

Animation duration in ticks (0 for instant)

yaw

float

default:"0"

Yaw rotation offset

pitch

float

default:"0"

Pitch rotation offset

roll

float

default:"0"

Roll rotation offset

twoside

boolean

default:"true"

Randomize roll for varied patterns

skill[]

required

Skills to execute at each projectile spawn point (typically projectile mechanics)

Example: Five Arrow Spread

arrow_spread:
  Skills:
  - skill:projectile_spread{
      points=5;
      arc=60;
      radius=10;
      id=[
        - projectile{type=ARROW;v=60;md=40;onHit=[- damage{a=12}]}
      ]
    } @SelfEyeLocation

Example: Shotgun Pattern

shotgun_blast:
  Skills:
  - skill:projectile_spread{
      points=8;
      arc=30;
      radius=6;
      id=[
        - projectile{v=80;md=15;hR=0.3;vR=0.3;
            onHit=[- damage{a=8}];
            onTick=[- e:p{p=smoke;a=1}]
          }
      ]
    } @SelfEyeLocation

Projectile Barrage

Fires projectiles in an alternating left-right pattern, creating a barrage effect.

Basic Usage

my_barrage:
  Skills:
  - skill:projectile_barrage{
      points=12;
      spread=8;
      accuracy=0.95;
      id=[
        - projectile{v=50;onHit=[- damage{a=15}]}
      ]
    } @SelfEyeLocation

Parameters

points

integer

default:"3"

Number of projectiles to fire in sequence

spread

float

default:"points * 2"

Angular spread in degrees for left-right alternation

accuracy

float

default:"1.0"

Accuracy value (0.0-1.0). Lower values increase random deviation.

radius

float

default:"1"

Radial offset scale

skill[]

required

Skills to execute for each projectile

How It Works

The barrage alternates sides using:

projectile_barrage-fire:
  Skills:
  # Calculate which side (1 or -1)
  - setvar{var=side;val="2*(<skill.var.itr>%2)-1";type=INTEGER}
  
  # Apply roll based on side
  - setvar{var=roll;val="<skill.var.roll|0>+<skill.var.spread>+<skill.var.side>*180"}
  
  # Add random deviation based on accuracy
  - raytraceto{locationskill=[
      - setvarloc{var=targetloc;v=@RLNT{a=1;r=<skill.var.deviation|0>}}
    ]} @forward{f=12;uel=true}

Example: Rapid Fire Barrage

rapid_barrage:
  Skills:
  - skill:projectile_barrage{
      points=20;
      spread=15;
      accuracy=0.85;
      id=[
        - projectile{v=70;md=30;hR=0.4;vR=0.4;
            onHit=[- damage{a=8}];
            onTick=[- e:p{p=flame;a=2}]
          }
      ]
    } @SelfEyeLocation

Piercing System

Track and limit how many entities a projectile can hit before stopping.

Initialization

Call pierce-init when creating the projectile:

piercing_arrow:
  Skills:
  - skill:pierce-init{pierce=3} @self
  - projectile{v=60;i=20;md=40;
      onHit=piercing_arrow-hit;
      onTick=[- e:p{p=end_rod;a=1}]
    } @forward{f=2;uel=true}

On Hit Logic

Call pierce-hit when the projectile hits an entity:

piercing_arrow-hit:
  Skills:
  - damage{a=15}
  - skill:pierce-hit @self

Parameters

pierce

integer

default:"1"

Maximum number of entities the projectile can hit

debug

boolean

default:"false"

Show debug messages about pierce count

How It Works

pierce-init:
  Skills:
  - setvar{var=pierce;val=<skill.pierce|1>;type=INTEGER} @self
  - setvar{var=hits;val=0;type=INTEGER} @self

pierce-hit:
  Skills:
  - setvar{var=hits;val="<skill.var.hits|0>+1";type=INTEGER} @self
  - skill{s=pierce-end_projectile}

pierce-end_projectile:
  Conditions:
  - ( varinrange{var=hits;val=><skill.var.pierce>} || varequals{var=hits;val=<skill.var.pierce>} )
  - projectileHasEnded false
  Skills:
  - endprojectile

The projectile tracks hits and ends itself when reaching the maximum pierce count.

Example: Triple Pierce Arrow

triple_pierce:
  Skills:
  - skill:pierce-init{pierce=3} @self
  - projectile{v=50;i=20;md=50;
      onHit=triple_pierce-hit;
      onTick=[- e:p{p=crit_magic;a=2}]
    } @forward{f=2;uel=true}

triple_pierce-hit:
  TargetConditions:
  - isliving true
  Skills:
  - damage{a=20}
  - e:p{p=crit;a=8;y=1;hs=0.4}
  - skill:pierce-hit @self

Example: Piercing Fireball

piercing_fireball:
  Skills:
  - skill:pierce-init{pierce=5} @self
  - projectile{v=40;i=10;md=40;hR=0.8;vR=0.8;
      onHit=piercing_fireball-hit;
      onTick=[- e:p{p=flame;a=3}];
      onEnd=[- explosion{yield=2}]
    } @forward{f=2;uel=true}

piercing_fireball-hit:
  Skills:
  - damage{a=25;i=FIRE}
  - ignite{t=60}
  - skill:pierce-hit @self

Combining Systems

You can combine spread patterns with piercing:

piercing_spread:
  Skills:
  - skill:pierce-init{pierce=2} @self
  - skill:projectile_spread{
      points=7;
      arc=90;
      radius=10;
      id=[
        - projectile{v=60;i=20;md=40;
            onHit=[
              - damage{a=12}
              - skill:pierce-hit @self
            ];
            onTick=[- e:p{p=end_rod;a=1}]
          }
      ]
    } @SelfEyeLocation

When using piercing with spread, initialize piercing on the caster, not per-projectile, since the pierce counter needs to be per-projectile.

Aliases