# Config Documentation about ExtraFirework's config.yml options. The default values are always compatible for the latest version, if you need to set the plugin up with an older version (currently only necessary for 1.12 and 1.13) then please take a look at these [default configs](https://gist.github.com/Phoenix616/eeec41ce3db5b3fa535341bfaab3ad8b). ## debug Log some more debug information //Default:// `true` ## language The language file to be used for the plugin's messages and item names. (Already created items will not be effected if this is changed!) //Default:// `en` ## disable-metrics By default the plugin submits some metrics to [bStats](https://bstats.org/plugin/bukkit/ExtraFireworks/9800) and my own server, this disables that. //Default:// `false` ## update-check Whether or not to check for updates. Ingame notifications are controlled by the extrafireworks.updatenotification permission. //Default:// `true` ---- ## skins Section to specify where to download the skins for the player face/head effect. ### download #### name Where to download skins from when only the skull owner name is known. Use `%name%` as the placeholder for the name. //Default:// `https://minotar.com/skin/%name%` #### uuid Where to download skins from when the skull owner uuid is known. Use `%uuid%` as the placeholder for the name. //Default:// `https://minotar.com/skin/%uuid%` #### texture Where to download skins from when only the skull texture ID is known. Use `%texture%` as the placeholder for the name. //Default:// `http://textures.minecraft.net/texture/%texture%` ### cache-time How many hours the skin data should be cached before it is re-downloaded. //Default:// `24` ---- ## transparency-threshold Colors with RGB values below this will be treated as transparent when displaying maps in transparent mode //Default:// `100` ## far-away-particles Toggle whether or not particles will be shown to a player even when the explosion happens further away. This might cause client-side lag and maybe server lag with large amounts of fireworks! //Default:// `true` ## effect-duration Amount of seconds that certain static effects (text, map, heads, custom) should be displayed for. Setting this to a too high value might cause client/server lag! //Default:// `3.0` ---- ## recipes Define the [material name](https://hub.spigotmc.org/javadocs/spigot/org/bukkit/Material.html) that you add additionally to the gunpowder to craft a firework star for the respective effect. None of them support fade colors or twinkles (glowstone)! Trails (diamond) works though as that doesn't affect the effect but the trail left behind by the rocket! ### explosion Normal explosion (doesn't destroy blocks), the more TNT the loader/bigger it gets. Dyes don't do anything //Default:// `tnt` ### text Show the custom name of the item that is used for crafting as a text. Without dyes this will use fire particles for the text for best visibility, with dye it uses the respective color. //Default:// `name_tag` ### map This will show the content of the map. The colors will be the ones on the map. Might work with image to map plugins depending on how they apply the images //Default:// `filled_map` ### coloring What item should be used for coloring. This is only for internal use and can be any of the dyes, it will only need to be changed if running the plugin on an older server version. The plugin will automatically register recipes for all possible dyes. //Default:// `black_dye` ### transparency What to add to only show light colors with particles and dark transparent. //Default:// `glass` ### head Use the texture on a skull to show the face as a 2D image. When adding the box item it will display all sides. This will only need to be changed for older server versions. //Default:// `player_head` ### box What item should be added to make the map and text effect display a box (without the top or bottom side) //Default:// `paper` ### snow A snowing effect with white particles that float towards the ground. The more of the item gets added when crafting the more of the effect is shown. //Default:// `snowball` ### fountain A simple fountain effect that points in the direction of the firework rocket when it explodes. Without dye: fire particles, with dye: the respective color. //Default:// `torch` ---- ## custom You can define custom (2D) effects based on images here. Works similar to the maps, if you use real transparencies it works best though. ### Options #### image The image in the images folder on which the custom effect is based on. #### scale The scale of the image (blocks per pixel) #### density How many particles should be used to display one pixel #### recipe The [material(s)](https://hub.spigotmc.org/javadocs/spigot/org/bukkit/Material.html) to use for crafting a firework star with the defined effect. Can be a list too if you want to require multiple items. #### box Whether the effect should always be in a box shape. (`true`/`false`) Enabling this will disallow crafting the item to a box automatically. #### transparent Whether the effect should always display dark color as transparent. (`true`/`false`) Enabling this will disallow crafting the item with the transparent modifier automatically. #### particle The [particle](https://hub.spigotmc.org/javadocs/spigot/org/bukkit/Particle.html) to use to display the effect. Use `redstone` if you want the particles to have RGB colors #### colors The color the effect should have, forces the particle to redstone. Set to an empty string if you don't want a color. E.g. if you want only a red outline use `colors: "255,0,0"` #### sounds Specify custom sounds to play at the explosion location when the effect gets displayed. See [this list](https://minecraft.fandom.com/wiki/Sounds.json#Java_Edition_values) for sounds available in the Vanilla game. (Resource pack sounds are supported too!) Defining a custom sound will not play the normal explosion sound if the firework doesn't have a Vanilla firework effect! Can be multiple and omit the category or volume or pitch and uses the following syntax: `[,][,[,]]` #### allow Allow certain options to be applied by the player by adding items while crafting. If not set it's assumed that it's allowed! ##### box Whether or not to allow adding the box item (default: `paper`) to display the effect as a box. ##### transaprency Allow user to toggle transparency by adding the transparent item (default: `glass`) ##### coloring Allow user to color the image effect by adding a dye item while crafting. Will force the particle to redstone if the player uses a dye. Coloring works best with images with lots of transparency or single colors. If no dye is provided it will use the specified particle. ### Example custom: cowface: image: cowface.png scale: 1 density: 4 recipe: leather box: false transparent: false particle: "redstone" colors: "" sounds: - "entity.cow.ambient,master,10,1" allow: box: true transparency: false coloring: false