GitLab

Description

The Projectile skill fires a meta-"projectile" that can be decorated using particle and sound effects.
It's great for creating complex, aesthetically pleasing skills, such as shadow bolts, balls of ice, or even meteors.
It has a lot of options (more than any other mechanic) and can be a bit of a nightmare to jump into without knowing what you're doing.
It will disappear after hitting an entity or location that is able to stop the projectile. This behavior can be configured via attributes like stopatblock, stopatentity and stopconditions

It is of importance to note that other mechanics (such as Missile) are an "extension" of this mechanic, and can as such use a great deal of this mechanic's attributes. The attributes that those mechanics can use are listen in Inheritable Attributes

• Description
• Attributes
  • Inheritable Attributes
  • Projectile-Specific Attributes
• Special Notes
• Projectile Bullets
  • Universal Bullet Attributes
  • ARROW Bullet
  • BLOCK Bullet
  • SMALLBLOCK Bullet
  • ITEM Bullet
  • MOB Bullet
  • TRACKING Bullet
  • REALTRACKING Bullet
  • DISPLAY Bullet
• ME Bullet
  • SMALLBLOCK Bullet
  • TEXT Bullet
• Examples

Attributes

Inheritable Attributes

Projectile-Specific Attributes

Special Notes

For the onStart Skill: onStart skills work in a special way - any buff or "special effect" mechanics fired by onStart that have a duration (such as ParticleTornado) will attach to the projectile for their duration, which allows for some interesting effects.

For the onTick Skill: using the @origin targeter will cause any skills or effects to target the projectile's location. This is the intended way to configure how the projectile looks.

For the onHit Skill: Any targets the projectile hits are passed to the skill inherently. Any targeters you put in the onHit skill will override these and cause your skill to likely not work as you intend.

For the onEnd Skill: Special effects for the projectile's end also use @origin. Also, If you want entities near the end-point of the projectile to be hit in a certain way (such as a final large fireball explosion) you can use the @PlayersNearOrigin{r=[radius]} targeter.

Types:
There are two types of projectiles, the normal variant and also the Meteor variant.
Meteor projectiles are created above the target, rather than at the mob that is firing the projectile.
Because of this, meteor projectiles cannot use certain attributes (which ones are pending further testing).

Projectile Bullets

The bullet type that will represent the projectile. These can be specified via the BulletType attribute. These work with the projectile, missile, and orbital mechanics.

Examples:

  - projectile{bulletType=ARROW;arrowType=TRIDENT;...}
  - projectile{bulletType=BLOCK;material=STONE;...}
  - projectile{bulletType=ITEM;material=MyMythicItem;...}
  - projectile{bulletType=MOB;mob=SkeletonKing;...}

Universal Bullet Attributes

ARROW Bullet

BLOCK Bullet

SMALLBLOCK Bullet

ITEM Bullet

MOB Bullet

TRACKING Bullet

REALTRACKING Bullet

DISPLAY Bullet

ME Bullet

SMALLBLOCK Bullet

TEXT Bullet

Examples

This example shoots a fast-moving ball of ice that damages and slows the first entity it hits:
Mob File

Mob:
  Type: SKELETON
  Skills:
  - skill{s=IceBolt} @target ~onTimer:100

Skills File

IceBolt:
  Skills:
  - projectile{onTick=IceBolt-Tick;onHit=IceBolt-Hit;v=8;i=1;hR=1;vR=1;hnp=true}
IceBolt-Tick:
  Skills:
  - effect:particles{p=snowballpoof;amount=20;speed=0;hS=0.2;vS=0.2} @origin
IceBolt-Hit:
  Skills:
  - damage{a=10}
  - potion{type=SLOW;duration=100;lvl=2}

hitConditions usage example:

  - projectile{hitConditions=[  - isMonster true  - isFrozen false ]}