Arrows: Flame Arrow - magemonkeystudio/divinity GitHub Wiki

🔥 Arrows: Flame Arrow

The Flame Arrow ignites enemies on impact and applies a fire-themed particle trail while in flight. It also boosts Fire Damage and applies a Fire Defense debuff to enemies.

This arrow is defined using the Arrows Module and powered by the Actions System Hub for custom behavior.

📂 File Overview

material: ARROW
name: Flame Arrow
lore:
- '&f➐ &7Fire Damage: &a+10%'
- '&f➐ &7Fire Defense: &c-3%'
- ''
- '&7This arrow will &fignite&7 the enemy'
- '&7for &f5 seconds&7 on hit.'
tier: common
level:
  min: 1
  max: 1
bonuses-by-level:
  '1':
    additional-stats:
      BURN_RATE: 100.0
    additional-damage:
      fire: 10.0%
    defense-ignoring:
      fire: 3.0%

🔥 Actions & Effects

🎯 `on-fly-actions`

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

Effect: Creates a continuous flame trail behind the arrow as it travels.

💥 `on-hit-actions`

on-hit-actions:
  default:
    conditions:
      list: []
      actions-on-fail: 'null'
    action-executors:
    - '[PARTICLE_SIMPLE] ~name: LAVA; ~offset:0.3,0.3,0.3; ~speed: 0.2; ~amount: 20; ~target: sight;'
    target-selectors:
    - '[FROM_SIGHT] ~distance: 3; ~party-member: false; ~attackable: true; ~allow-self: false; ~name: sight;'

Effect:

Emits lava particles around the impacted enemy.
Uses [FROM_SIGHT] to identify and affect enemies in the arrow’s direct line of sight.

🧪 Summary of Features

Feature	Description
`BURN_RATE`	Guarantees that the target ignites on hit.
`additional-damage`	Adds +10% fire damage.
`defense-ignoring`	Reduces fire defense of the target by 3%.
`on-fly-actions`	Flame particle trail effect.
`on-hit-actions`	Lava burst particles on contact.
`tier`, `level`	Common-tier, level 1 item.