shoot_firework

Launches a firework projectile from the player with configurable visual effects.

Categories: combat, visual

Optional arguments

Key(s)DescriptionTypeDefault
effectsList of firework effect subsections defining the firework's appearance.DYNAMIC
powerThe flight duration power of the firework (0-255).INT0
inherit_velocityWhether the firework should inherit the player's current velocity.BOOLEANfalse
launch-at-locationWhether the firework should be teleported to the trigger location after launch.BOOLEANfalse
no_sourceWhether the firework should have no shooter, preventing attribution to the player.BOOLEANfalse

effects entries

KeyDescriptionTypeRequired
typeThe explosion shape: ball, ball_large, star, burst, creeper.
Choices: ball, ball_large, star, burst, creeper
STRING_LISTyes
colorsThe hex colors of the explosion.STRING_LISTno
fade-colorsThe hex colors the explosion fades to.STRING_LISTno
trailWhether the firework leaves a trail.BOOLEANno
flickerWhether the explosion flickers.BOOLEANno

Trigger parameters required

  • PLAYER

Example

effects:
  - id: shoot_firework
    args:
      effects: 
        - type: ball|ball_large|star|burst|creeper
          colors: <value> # ← Optional
          fade-colors: <value> # ← Optional
          trail: <value> # ← Optional
          flicker: <value> # ← Optional # ← Optional
      power: 1 # ← Optional
      inherit_velocity: true # ← Optional
      launch-at-location: true # ← Optional
      no_source: true # ← Optional

Behaviour

SettingValue
Run orderNORMAL
Supports delaytrue
Reloads on plugin reloadtrue