Projectile

Projectile is an entity that can be shot in any direction.

NeoForge 26.1.2NeoForge 1.21.1

Step-by-step guide: how to make projectile →

Fields you fill in

Projectile launch action sound

This parameter controls the sound played when the projectile is shot.

Projectile model bounding box

This parameter controls the size of your projectile's hitbox in block units.

The first option sets the width and depth, whilst the second option sets the height.

Projectiles with either width/depth or height of more than 0.5 will not collide with

their shooter to prevent initial collisions due to their size. If shooter is not known, they

will collide with the nearest entity in all cases, meaning shooting them with e.g. command may

cause them to collide with the command sender.

Very big projectile bounding box sizes may also cause the projectile to collide with the blocks

very often and may prevent them from going far due to early collisions.

Default projectile hit damage

Higher the number the stronger the damage the projectile deals to the entity hit.

Remain on the ground after landing

Enabling this parameter prevents the projectile from being discarded after landing on a block.

This can be used to create trident-like projectiles that can return to the player or be picked up.

Disable gravity

Select this parameter to disable the effect of gravity on this projectile.

You probably don't want this parameter in most cases as it makes projectile behave in non-realistic way.

A better option is to set a very high projectile power.

This means that the projectile will not fall to the ground and will move in a straight line until it hits something or is despawned.

Keep in mind if shot vertically, the projectile will not fall back down and will keep moving in the same direction.

Does projectile ignite fire on hit

Check this parameter if you want it to light a fire when the projectile hits a block.

NOTE: this does not catch mobs on fire

Required item for the projectile

The item texture representing the projectile. It will look the same as the item selected here.

For custom shapes, use the model parameter.

Default projectile hit knockback

The higher the number, the further the entity hit will be pushed by the projectile.

Projectile model

Projectile model is the model of your ranged item.

This parameter will override item for texture parameter when used.

Projectile model texture

This is the texture of the projectile model if custom model is used.

Default projectile power

This parameter controls the speed of the projectile (its kinetic energy).

Does projectile spawn particles in-flight

Check this parameter if you want particles to be emitted in midair.

When flying tick

While the projectile is flying, the selected procedure will be executed each tick.

When hits block

When the projectile hits a block, it will execute the selected procedure.

Passed x, y, and z are the coordinates of the block hit.

When hits entity

If the projectile hits a living entity (cow, creeper, player, etc.), it will execute the selected procedure.

When hits player

When the projectile hits a player, it will execute the selected procedure.

Keep in mind this procedure might trigger when the projectile hits the entity firing the projectile too.