# \ud83c\udf86 JoinFirework<\/p>\n
A **lag-free**, highly configurable **Minecraft join firework plugin** for **Paper \/ Spigot \/ Purpur 1.20+**, built with **Java 21**.<\/p>\n
Give every player a beautiful, always-visible firework when they join \u2014 including **instant ground explosions**, **presets**, an **in-game GUI editor**, **BossBar**, and more.<\/p>\n
—<\/p>\n
## \u2728 Features<\/p>\n
– \ud83c\udf87 Firework on player join
\n– \ud83d\udca5 **Instant detonation** option (explode at feet)
\n– \ud83c\udfa8 Fully configurable colors, fade colors, trail & flicker
\n– \ud83e\udde9 Multiple firework **effect layers**
\n– \ud83c\udfb2 Random or weighted **presets**
\n– \ud83c\udf9b **In-game GUI editor** (no config editing required)
\n– \ud83e\uddea Test commands for players & presets
\n– \ud83d\udcca Optional **BossBar** and **ActionBar**
\n– \ud83d\udd0a Optional sound effects
\n– \u26d4 Fireworks deal **zero damage**
\n– \ud83e\udde0 Smart delays \u2192 **always visible**, no \u201csound-only\u201d bug
\n– \ud83d\udd04 Automatic **config migration** for older versions
\n– \u26a1 Lightweight & optimized (no lag)<\/p>\n
—<\/p>\n
## \ud83d\udce6 Requirements<\/p>\n
– Minecraft **1.20+**
\n– **Paper \/ Spigot \/ Purpur**
\n– **Java 21**<\/p>\n
—<\/p>\n
## \ud83d\ude80 Installation<\/p>\n
1. Place `JoinFirework.jar` in your `\/plugins` folder
\n2. Start or restart the server
\n3. Configure via `config.yml` **or** `\/joinfirework gui`<\/p>\n
—<\/p>\n
## \ud83e\uddfe Commands<\/p>\n
| Command | Description | —<\/p>\n ## \ud83d\udd10 Permissions<\/p>\n | Permission | Description | > \u2705 **Server operators (OP)** always have access, even without a permissions plugin.<\/p>\n —<\/p>\n ## \ud83c\udf9b GUI Editor<\/p>\n Open the editor with:<\/p>\n \/joinfirework gui<\/p>\n","protected":false},"excerpt":{"rendered":" JoinFirework<\/p>\n A lag-free, highly configurable Minecraft join firework plugin for Paper Spigot Purpur<\/p>\n","protected":false},"featured_media":88253,"template":"","meta":{"_minecraft_slug":"joinfirework","_minecraft_project_id":"HtCy2KrG","_minecraft_author":"mysticalcraft-ancientvipers","_minecraft_license":"LicenseRef-All-Rights-Reserved","_minecraft_downloads":91,"_minecraft_follows":2,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"joinfirework.zip","_minecraft_size_bytes":30025,"_minecraft_version_count":1,"_minecraft_updated_at":"2026-05-15T19:53:42.692607Z","_minecraft_date_created":"2025-12-18T00:13:02.168558Z","_minecraft_date_modified":"2025-12-14T02:42:48.382359Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/joinfirework","_minecraft_icon_attachment_id":88253,"_minecraft_imported_at":"2026-06-05T01:04:55+00:00","_minecraft_import_hash":"659efa129f3328afb31a724bb7bba011","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[126,127,92],"mod_loader":[132],"minecraft_version":[59,36,60,93,94,101,102,62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-88252","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-management","mod_category-paper","mod_category-utility","mod_loader-paper","minecraft_version-1-20","minecraft_version-1-20-1","minecraft_version-1-20-2","minecraft_version-1-20-3","minecraft_version-1-20-4","minecraft_version-1-20-5","minecraft_version-1-20-6","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n
\n|——-|————-|
\n| `\/joinfirework reload` | Reload the configuration |
\n| `\/joinfirework gui` | Open the in-game GUI editor |
\n| `\/joinfirework test` | Test the firework on yourself |
\n| `\/joinfirework test
\n| `\/joinfirework test preset
\n| `\/joinfirework test preset
\n|———–|————-|
\n| `joinfirework.show` | See join fireworks |
\n| `joinfirework.reload` | Reload the config |
\n| `joinfirework.gui` | Open the GUI editor |
\n| `joinfirework.test` | Use test commands |
\n| `joinfirework.test.others` | Test on other players |
\n| `joinfirework.cooldown.bypass` | Bypass the join cooldown |
\n| `joinfirework.preset.