Creeper Firework

A small Minecraft Paper Plugin for 1.21.11+ that lets Creeper explode into beautiful fireworks instead of destroying blocks

Showcase

Firework from a normal Creeper

Firework from a Charged Creeper

Description

Creeper explode into a configurable amount of fireworks. Charged Creeper can create a larger and more spectaculous firework show

When exploding creeper still do damage to entities, but won't break any blocks.

Installation

1. Download the plugin from Modrinth
2. Put the jar file into your plugins folder
3. Restart your server (optional)
4. Change the amount of fireworks and other stuff in the plugins/Creeper-Firework/config.yml
5. Use /creeper_firework reload ingame to reload the config

Configuration

You can configure the normal creeper and charged creeper seperately.

You can control:

• how many waves of rockets should spawn
• the delay between the waves
• how "strong" the rockets in each wave should be
• how far the rockets can spread from the creeper origin

all values are provided as a min/max range which will be randomized each time.

This is how the default configuration looks:

# all values are provided in a min/max range which will be randomized every time

# wave_delay can be 0 if max_waves is 1, otherwise it should be 1 or greater otherwise nothing will happen
# max values should always be greater or equal to min values or else the plugin will crash on runtime


# --- normal creeper ----
normal_creeper:

  # how many individual firework rockets should be spawned if a creeper explodes
  min_explosion_strength: 3
  max_explosion_strength: 5

  # how far some rockets explode aside of the creepers position
  min_spread_distance: 0
  max_spread_distance: 0

  # how many times a firework with the selected explosion-strength should spawn with the delay provided below
  min_waves: 1
  max_waves: 1

  # the delay in ticks (20t = 1 sek) between two waves of explosions if there are more than one.
  # this is provided in min/max which will be randomized between these values
  min_wave_delay: 0
  max_wave_delay: 0


# --- charged creeper ----
charged_creeper:

  # how many individual firework rockets should be spawned if a creeper explodes
  min_explosion_strength: 5
  max_explosion_strength: 8

  # how far some rockets explode aside of the creepers position
  min_spread_distance: 0
  max_spread_distance: 0

  # how many times a firework with the selected explosion-strength should spawn with the delay provided below
  min_waves: 3
  max_waves: 5

  # the delay in ticks (20t = 1 sek) between two waves of explosions if there are more than one.
  # this is provided in min/max which will be randomized between these values
  min_wave_delay: 10
  max_wave_delay: 20


# don't touch
config_version: 1

Bugs, Feature Requests and Contributing

If you encounter any bugs please create a bug-report

If you have an idea for a new feature (or configuration addition) feel free to create an issue as well, it might be added!

If you like to you can also help me by fixing bugs or adding features by creating a pull request. (Even though i might not accept all new features if they don't fit into the plugin)

Updating

While i probably won't backport this plugin to older versions, i will try to always update this plugin to new Minecraft versions.

If you really need the plugin for an older version, feel free to create an issue and if it is not too much effort i might still backport it for you.

Also remind me via an issue if i ever forget to update the plugin and you need a new version.

Licence

This project is licenced under the MIT-licence