ThunderFirework

A lightweight Paper/Youer plugin that turns high-star firework rockets into satisfying TNT-like explosions when shot from a crossbow.

Behaviour

Stars	Effect
1–5	Normal vanilla firework
6	TNT-strength explosion (no blocks, no fire)
7+	TNT-strength explosion + fire

Never breaks blocks
Purely based on the number of firework stars
Compatible with pure Paper and hybrid servers (Youer / NeoForge + Paper API)

Building

mvn clean package

The resulting jar will be at target/ThunderFirework-1.0.0.jar.

Installation

Drop the jar into your server’s plugins folder
Restart the server (or load it with a plugin manager)
Shoot a firework rocket that has 6 or more stars from a crossbow

Giving test rockets

# 6-star rocket (TNT explosion, no fire)
/minecraft:give @s firework_rocket[fireworks={flight_duration:3,explosions:[{shape:"large_ball",colors:[I;16711680]},{shape:"large_ball",colors:[I;16711680]},{shape:"large_ball",colors:[I;16711680]},{shape:"large_ball",colors:[I;16711680]},{shape:"large_ball",colors:[I;16711680]},{shape:"large_ball",colors:[I;16711680]}]}] 16

# 7-star rocket (TNT explosion + fire)
/minecraft:give @s firework_rocket[fireworks={flight_duration:3,explosions:[{shape:"large_ball",colors:[I;16711680]},{shape:"large_ball",colors:[I;16711680]},{shape:"large_ball",colors:[I;16711680]},{shape:"large_ball",colors:[I;16711680]},{shape:"large_ball",colors:[I;16711680]},{shape:"large_ball",colors:[I;16711680]},{shape:"large_ball",colors:[I;16711680]}]}] 16

Configuration

Hardcoded:

Constant	Default	Meaning
`MIN_STARS_EXPLOSION`	6	Minimum stars for TNT-style explosion
`MIN_STARS_FIRE`	7	Minimum stars for fire effects
`FIRE_TICKS`	100	Entity fire duration (5 seconds)
`FIRE_RADIUS`	5.0	Radius for setting entities on fire
`BLOCK_FIRE_RADIUS`	3	Radius for placing fire blocks