1.6.2
Compatibility
Changes
π 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
- Place
JoinFirework.jarin your/pluginsfolder - Start or restart the server
- Configure via
config.ymlor/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
Projects on Modrinth are automatically available through a Maven repository for use with JVM build tools such as Gradle. To learn more about the Modrinth Maven API, click here.
Note: When available, you should use the creator's maven repo instead as it will have transitive dependency information that the Modrinth Maven API does not. You may also end up with duplicate dependencies if you use a mix of Modrinth and non-Modrinth Maven repositories for your dependencies, because the group identifier will be different when served through the Modrinth Maven API.
Maven coordinates:
Version ID:
build.gradle:
repositories {
exclusiveContent {
forRepository {
maven {
name = "Modrinth"
url = "https://api.modrinth.com/maven"
}
}
// forRepositories(fg.repository) // Uncomment when using ForgeGradle
filter {
includeGroup "maven.modrinth"
}
}
}
// Standard Gradle dependency
dependencies {
implementation "maven.modrinth:HtCy2KrG:khOZrz8h"
}
// Legacy Loom dependency
dependencies {
modImplementation "maven.modrinth:HtCy2KrG:khOZrz8h"
}

