🎆 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