🎆 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

1. Place JoinFirework.jar in your /plugins folder
2. Start or restart the server
3. Configure via config.yml or /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