Arrows: Explosive Snowball - magemonkeystudio/divinity GitHub Wiki

❄️ Arrows: Explosive Snowball

The Explosive Snowball functions similarly to the Explosive Arrow but is based on the SNOWBALL material. It adds both damage and stat bonuses and detonates on impact, dealing area damage using the Actions System.

This item is part of the Arrows Module and is a creative alternative to projectile-based explosive weapons.

📂 File Overview

material: SNOWBALL
name: Explosive Snowball
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: {}

✈️ `on-fly-actions`

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: Emits smoke particles as the snowball flies, simulating a lit explosive.

💣 `on-hit-actions`

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:

Deals -50% AoE damage to nearby enemies.
Triggers large explosion particles and sound effects.
Targets both self and surrounding entities in a 5-block radius.

🧪 Summary of Features

Feature	Description
`BURN_RATE`	+15% chance to inflict burn effects.
`DODGE_RATE`	-10% dodge rate as a drawback.
`additional-damage`	Adds +10% physical damage.
`on-hit-actions`	Triggers area explosion damage.
`material`	Uses `SNOWBALL`, enabling projectile-style usage.