Arrows: Explosive Arrow - magemonkeystudio/divinity GitHub Wiki

🎯 Arrows: Explosive Arrow

This is a sample arrow file configured for use with the Arrows Module in Divinity. This arrow explodes on hit, dealing area damage and playing visual effects. Arrows like this can be generated or assigned to specific bows using the Ammo Types option in the Item Generator.

📂 File Overview

material: ARROW
name: Explosive Arrow
lore:
- '&f➐ &7Dodge Rate: &c-10%'
- '&f➐ &7Burn Rate: &a+15%'
- ''
- '&7This arrow will &fexplode &7on'
- '&7hit and damage all enemies in a'
- '&7range of &f5 blocks&7.'
tier: common
level:
  min: 1
  max: 1
bonuses-by-level:
  '1':
    additional-stats:
      BURN_RATE: 15.0
      DODGE_RATE: -10.0
    additional-damage:
      physical: 10%
    defense-ignoring: {}

💥 Actions & Effects

This arrow uses the Actions System to define behavior when flying and on hit.

Refer to the Actions System Hub for syntax and explanation of the sections below.

🎯 `on-fly-actions`

These actions play while the arrow is flying through the air.

on-fly-actions:
  default:
    conditions:
      list: []
      actions-on-fail: 'null'
    action-executors:
    - '[PARTICLE_SIMPLE] ~name: SMOKE_NORMAL; ~amount: 1; ~offset:0,0,0; ~speed: 0; ~target: self;'
    target-selectors:
    - '[SELF] ~name: self;'

Effect: A small smoke trail appears as the arrow flies.

💣 `on-hit-actions`

These actions trigger when the arrow hits a target or block.

on-hit-actions:
  default:
    conditions:
      list: []
      actions-on-fail: 'null'
    action-executors:
    - '[PARTICLE_SIMPLE] ~name: EXPLOSION_LARGE; ~offset:2,2,2; ~speed: 0.1; ~amount: 50; ~target: self;'
    - '[SOUND] ~name: ENTITY_GENERIC_EXPLODE; ~target: all;'
    - '[DAMAGE] ~amount: -50%; ~target: near;'
    target-selectors:
    - '[RADIUS] ~distance: 5; ~party-member: false; ~attackable: true; ~allow-self: false; ~name: near;'
    - '[RADIUS] ~distance: 5; ~allow-self: true; ~name: all;'
    - '[SELF] ~name: self;'

Effect:

Plays a large explosion particle.
Plays explosion sound to nearby entities.
Deals 50% damage to enemies within 5 blocks of the impact.

🧪 Summary of Features

Feature	Description
`material`	Sets the base item type (ARROW).
`bonuses-by-level`	Adjusts stats like dodge, burn, and damage.
`on-fly-actions`	Creates a visual smoke trail.
`on-hit-actions`	Triggers an AOE explosion with damage and sound.
`tier`, `level`	Standard rarity and level metadata.