# 🎆 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