JoinFirework

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