Arrows: Pierce Arrow - magemonkeystudio/divinity GitHub Wiki

🗡️ Arrows: Pierce Arrow

The Pierce Arrow is designed to penetrate enemy armor and deal damage to multiple enemies in a line. It leverages both armor-ignoring stats and piercing damage, and uses an advanced targeting mechanic to simulate a "piercing" projectile.

This arrow is part of the Arrows Module and utilizes the Actions System Hub for execution.

📂 File Overview

material: ARROW
name: Pierce Arrow
lore:
- '&f➐ &7Piercing Damage: &a+20%'
- '&f➐ &7Armor Penetration: &a+15%'
- ''
- '&7This arrow can &fpass through enemies&7'
- '&7and deal damage to all in its path.'
tier: uncommon
level:
  min: 1
  max: 1
bonuses-by-level:
  '1':
    additional-stats:
      PENETRATION: 15.0
    additional-damage:
      piercing: 20.0%
    defense-ignoring: {}

🎯 `on-fly-actions`

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

Effect: Adds a crit-style visual effect as the arrow travels, hinting at its armor-piercing nature.

💥 `on-hit-actions`

on-hit-actions:
  default:
    conditions:
      list: []
      actions-on-fail: 'null'
    action-executors:
    - '[PARTICLE_SIMPLE] ~name: SWEEP_ATTACK; ~offset:0.5,0.5,0.5; ~speed: 0.1; ~amount: 15; ~target: line;'
    - '[DAMAGE] ~amount: -30%; ~target: line;'
    target-selectors:
    - '[LINE] ~distance: 7; ~step: 1; ~attackable: true; ~allow-self: false; ~name: line;'

Effect:

Damages all enemies in a 7-block straight line from the hit point.
Simulates a piercing shot that hits multiple targets.
Uses [LINE] target selector for linear pathing and hit detection.

🧪 Summary of Features

Feature	Description
`PENETRATION`	Boosts ability to ignore target armor.
`additional-damage`	Adds +20% piercing-type damage.
`on-hit-actions`	Affects all enemies in a straight line.
`on-fly-actions`	Crit particles for visual clarity.
`tier`, `level`	Uncommon-tier, level 1 arrow.