Made in Germany with love (and beer )

Did you always want prettier fireworks in the game? Or just more effects in general for your shows? Maybe you wanted the explosion to draw text or pictures? Then ExtraFireworks will do exactly what you want!

ExtraFireworks adds several new crafting recipes for unique firework effects including ones that can display user-defined texts (with PlaceholderAPI support) and map images as well as the ability to configure your own unique effects via its configuration system!

Also included is a command do display all effects allowing you to create complex shows via command blocks or plugins!

Test server: test.phoenix616.dev:25542
Issue tracker and repo: GitLab
Wiki: https://wiki.phoenix616.dev/plugin/extrafireworks/
IRC channel: #extrafireworks on irc.esper.net
Discord channel: https://discord.gg/4CBpBqhkYk
Joining through that invite auto subscribes you to update notifications, if you don't want that use this one.

Please note that some older versions (currently 1.12 and 1.13) require a modified default config! Those can be obtained here for 1.12 and here for 1.13 .
Also right now only ASCII characters and numbers are supported in text fireworks!

Effects added by this plugin:

• Text via Name Tags (Supports PlaceholderAPI placeholders)
• Fountains
• Snow
• Maps
• Player Heads
• Explosion sound effect
• Your own custom effects based on images

Some of the effects can also be colored (text, fountain, maps) by using dyes or put into a box shape (text, maps, player heads)!

All new effects are craftable the same way normal fireworks can be crafted by creating a star and then a rocket from that.

Permissions
The plugin has the following permissions to control crafting:

• extrafireworks.craft.text - Allows crafting of the text effect
• extrafireworks.craft.map - Allows crafting of the map effect
• extrafireworks.craft.head - Allows crafting of the player head effect
  
• extrafireworks.craft.fountain - Allows crafting of the fountain effect
  
• extrafireworks.craft.snow - Allows crafting of the snow effect
  
• extrafireworks.craft.explosion - Allows crafting of the explosion effect
  
• extrafireworks.craft.<custom id> - Allows crafting of a custom effect using its ID as defined in the section of the config
• extrafireworks.updatenotification - Receive update notifications ingame

Command
The plugin's main command is /extrafireworks (aliases: /extrafirework and /ef, permission: extrafireworks.command)

Possible sub commands:

• /ef reload - Reload the plugin config
  
• /ef give <player> rocket <effect> <power> [<config>] - Give a firework rocket
  
• /ef give <player> star <effect> [<config>] - Give a firework star
• /ef launch <effect> [<world>,]<x>,<y>,<z> <power> [<config>] - Launch a firework at a specific location
• /ef show <effect> [<world>,]<x>,<y>,<z> [<config>] - Show an effect at a specific location

For a full explanation see the commands wiki page.

Todo
The following functionality will be added in future updates:

• Firework creator
• Run effects via commands at specific locations Added in 1.1.0
  
• Launch fireworks via commands Added in 1.2.0
• Get rockets and stars via commands Added in 1.2.8
• Multi-colored effects Added in 1.2.21 (for 1.13+ servers)

• More effects. Post them in the discussion thread or in the chat if you have ideas!

• Your requests!

Contact
If you have any questions feel free to contact me any time! The best way is via a private message here or the discussion thread.
Generally I should be able to get back to you with an answer in less then 12 hours ‒ during East Coast working hours it can even be under 1 hour!

Alternative Payment Methods
If you for some reason cannot pay with PayPal then I also accept automatic payments with BTC, ETH, XMR, LTC or DOGE (Other crypto currencies might be supported manually) Please note that the resource is still distributed through SpigotMC.org in that case and that you will need an account with this page.

External Requests
This plugin makes certain web requests to external servers which might disclose some information about your machine, your game server and the plugin usage. You can opt out of all requests and none of those requests will download any executable data!
It submits metrics to bStats.org as well as my own servers. You can opt-out by changing the config option disable-metrics in the plugin's config.yml or in the plugins/bStats/config.yml file!
It also includes an update checker to provide you with information regarding new versions in the console/log or if you have certain permissions, that checker can be disabled with the setting update-check.

Terms
This plugin is free software (as in freedom, not beer) licensed under GPLv3. By downloading this resource through SpigotMC.org you are gaining the rights stated in the license. E.g. you can receive the source code either in form of GitHub or GitLab repo access, a manual download, or a physical copy (if shipping is paid). Contact me for that.

You are not allowed to distribute this plugin in any form to anyone who has not obtained the right to use the plugin themselves unless you follow the terms described in the previously mentioned license. All of the rights given to you can be revoked at any time by the author in the case that the terms were violated as outlined in the license.

By downloading you accept the previous terms and the license this resource is under! If applicable in your jurisdiction you also waive your rights to return this digital good by downloading it.
Purchases are not subject to VAT according to §19 (1) of the German UStG.

This product is not affiliated with Mojang or Microsoft nor does it use copyrighted material of the game "Minecraft" unless under the assumption of Fair Use. (Screenshots/Videos)


My Resources