The Arrows Module allows you to define custom projectile items like arrows or snowballs with dynamic behaviors, particle effects, skills, sounds, and conditional logic. These items are often used with bows or other launch mechanisms and can behave differently on flight or impact.

The Arrows module consists of:

• settings.yml – Global settings for the arrow system (e.g., velocity, gravity, sound).
• items/ – Folder containing individual arrow definitions (*.yml files).
• plugins/Divinity/item_stats/ammo.yml – Controls which projectile types (e.g., ARROW, SNOWBALL) are allowed.
  → See: item_stats-ammo

• Each arrow is a standalone item with attributes like name, lore, material, effects, damage, and visual/audio cues.
• Arrow behavior can be split between:
  • on-fly-actions: While in motion.
  • on-hit-actions: When it collides with a target or block.

You can target:

• Specific mobs or players.
• Groups via radius.
• The shooter or projectile itself.

The following example arrow files are included by default and explained in detail on their own pages:

• arrow_explosive.yml
• arrow_flame.yml
• arrow_pierce.yml
• snowball_explosive.yml
• uncommon-magic-ammunition.yml

Allowed projectile types for custom arrow items are defined in:

plugins/Divinity/item_stats/ammo.yml

Only projectile types listed in this file (e.g., ARROW, SNOWBALL, EGG) will function properly. Using unsupported types may result in items that cannot be fired or triggered.

👉 See the item_stats-ammo page for detailed information.

← Return to Home