🎆 JoinFirework
A lag-free, highly configurable Minecraft join firework plugin for Paper / Spigot / Purpur 1.20+, built with Java 21.
Give every player a beautiful, always-visible firework when they join — including instant ground explosions, presets, an in-game GUI editor, BossBar, and more.
✨ Features
- 🎇 Firework on player join
- 💥 Instant detonation option (explode at feet)
- 🎨 Fully configurable colors, fade colors, trail & flicker
- 🧩 Multiple firework effect layers
- 🎲 Random or weighted presets
- 🎛 In-game GUI editor (no config editing required)
- 🧪 Test commands for players & presets
- 📊 Optional BossBar and ActionBar
- 🔊 Optional sound effects
- ⛔ Fireworks deal zero damage
- 🧠 Smart delays → always visible, no "sound-only" bug
- 🔄 Automatic config migration for older versions
- ⚡ Lightweight & optimized (no lag)
📦 Requirements
- Minecraft 1.20+
- Paper / Spigot / Purpur
- Java 21
🚀 Installation
- Place
JoinFirework.jarin your/pluginsfolder - Start or restart the server
- Configure via
config.ymlor/joinfirework gui
🧾 Commands
| Command | Description |
|---|---|
/joinfirework reload |
Reload the configuration |
/joinfirework gui |
Open the in-game GUI editor |
/joinfirework test |
Test the firework on yourself |
/joinfirework test <player> |
Test the firework on another player |
/joinfirework test preset <name> |
Test a specific preset |
/joinfirework test preset <name> <player> |
Test a preset on another player |
🔐 Permissions
| Permission | Description |
|---|---|
joinfirework.show |
See join fireworks |
joinfirework.reload |
Reload the config |
joinfirework.gui |
Open the GUI editor |
joinfirework.test |
Use test commands |
joinfirework.test.others |
Test on other players |
joinfirework.cooldown.bypass |
Bypass the join cooldown |
joinfirework.preset.<name> |
Access a preset |
✅ Server operators (OP) always have access, even without a permissions plugin.
🎛 GUI Editor
Open the editor with:
/joinfirework gui
