Custom Projectiles

Custom projectile types can be defined and applied to items in kits. These items effectively become either weapons that shoot the custom projectile, or the item form of the custom projectile itself.

Projectiles ElementDescriptionValue/Children
Node containing the custom projectile definitions.
Sub-elements
A custom projectile definition.Projectile Sub-elements
Projectile Attributes
AttributeDescriptionValueDefault
Unique identifier used to reference this projectile from other places in the XML.String
The display name of this projectile, used in "shot by" messages, etc.String
Items are consumed when using them to shoot this projectile (making them more like grenades than guns).true/falsetrue
The entity this projectile is materialized as.Entity TypeArrow
The amount of damage this projectile deals.Half-hearts0.0
The speed at which the projectile moves.Meters/tick1.0
The click action that fires the projectile.
Accepts , or .
Click Action
The potion effects to apply to players hit by this projectile.Potion Effect
PropertyFilter if/what blocks get destroyed when hit with this projectile.Filter
Minimum time between each firing of this projectile.Time Period
Projectile Sub-elements
ElementDescriptionValue/Children
PropertyFilter if/what blocks get destroyed when hit with this projectile.Filters
A potion effect to apply to players hit by this projectile.Potion Effect
<!-- Create the projectile "template" -->
<projectiles>
<projectile
id="lazer"
name="lazer"
projectile="Snowball"
velocity="3.5"
damage="50"
throwable="false"
cooldown="5s"/>
</projectiles>
<!-- Apply the projectile to an item -->
<kits>
<kit name="lazer-kit">
<item projectile="lazer" name="`alazer gun" material="stick"/>
</kit>
</kits>

Modifying Bow Projectiles

Bows can be modified to shoot a different projectile at a custom speed. The PGM plugin will calculate the damage the projectile does using the same formula as minecraft does for arrows. This means that a flying fish with a velocity of 40 will almost certainly kill you. Projectiles can also have custom potion effects which are applied to the target when it is hit. NOTE: You can currently only modify all bow projectiles, this means no normal and custom bow at the same time.

Projectiles ElementDescriptionValue/Children
Node containing the modify bow projectile settings.Bow Projectile Sub-elements
Sub-elements
The entity to use as the bows projectile.Entity Type
The velocity modifier of the bows projectile.Number
A potion effect to apply to players hit by the bow projectile.Potion Effect

Examples

<modifybowprojectile>
<projectile>EnderPearl</projectile>
<velocityMod>2.5</velocityMod>
<!-- Projectile potion effect -->
<effect duration="5" amplifier="1">poison</effect>
</modifybowprojectile>
<modifybowprojectile>
<effect duration="8" amplifier="1">wither</effect>
</modifybowprojectile>

All the following projectiles are guaranteed to work. See mrapple/Bukkit Entity Spawning.md for a list of tested entities.

Supported Entity Types