Minecraft Fireworks icon

Minecraft Fireworks -----

A plugin that help you launch fireworks automatically.



What is "Minecraft-Fireworks-2023"
[​IMG]

[​IMG]


Minecraft-fireworks 2023 is a Minecraft server plugin. This plugin supports all Minecraft versions from 1.14 to 1.19.3. The plug-in is only supported for installation on Java version servers because it is developed according to the Spigot API.

After installing this plug-in, your server will be able to automatically set off fireworks according to the rules you set. The plug-in also supports fireworks effects with specified shapes, heights, flicker, trail, and unlimited color mixes (Now it can automatically mix 128 colours maximum).

Features
Lightweight

This plug-in does not consume too much server resources, but whether it is a heavy load on your server depends on your Settings. This plugin can customize the interval between fireworks. Normally, if you set it within a reasonable range, there will be no load on the server. But if you go to the extreme of firing 100 fireworks a second, your server may be at risk of going down.

Support almost all new version of MC

The developers of this plugin focus on changes and updates to the Spigot API. These will determine whether the code compiles with new versions of Minecraft. This plugin is dedicated to keeping up with new versions of Minecraft.

Multilanguage support

You can easily change the language by changing the name of the language file to which the configuration file points. However, some other language files (except English and simplified Chinese) may require you to translate them yourself. If you would like to help us translate, please feel free to contact us.

Usage Instructions
  • /fw create <PointName> [randomly] : Create a fireworks point at your location, only Player in game can execute. ("randomly" is a optional argument). If you use randomly, the point will generate with a random property. If not, the point will generarte with configuration in default.yml in your Datafoler.
  • /fw launch <PointName1> [PointName2] ... : Launch the specific fireworks point using point name. At least 1 of point name should be used.
  • /fw createLoop <loopName> <interval=?> <pointName1> [PointName2] ... : Create a loop, where interval=? indicates the interval time of each point in this loop. Please replace "?" with a Integer value, whose unit is ticks.
  • /fw startLoop <loopName1> [loopName2] ... : Start loop(s) by loop name.
  • /fw stopLoop <loopName1> [loopName2] ... : Stop loop(s) by loop name.
  • /fw loops : Inspect the status and information of all loops.
  • /fw update : Check update. (Note: Current version is not able to check automatically, please check update manually in this page)
  • /fw addPoints <loopName> <pointName1> [pointName2] ... : Add one or more fireworks point in a loop.
  • /fw removePoints <loopName> <pointName1> [pointName2] ... : Remove one or more fireworks point in a loop. However, at least 1 point must be reserved in this loop, otherwise, the plugin will show error message and this remove operation will be cancelled.
  • /fw helps : Show this help in the server.
  • /fw reload : Reload this plugin.
Permission nodes
The preceding commands and operations consume certain server resources. Therefore, all the preceding commands require the fw.admin permission (default value). You can change this permission node name in the default configuration file config.yml and reload the plug-in.

Lauguage File
As a plugin for Minecraft server users around the world, we take the design and modification of language files very seriously. The plug-in default language is simplified Chinese, but you can also create your own copy by copying the default language file to change the language schema. Next, this article focuses on how language files are configured.

Step 1: Make a copy of default language file zh-cn.yml
In order to be able to create new language files, you must first copy the default language file zh-cn.yml

Step 2: Rename the new language file with a specific name.
To differentiate, rename the new language file.

Step 3: Modify the internal value
When you open the language file, you will find a large number of key-value pairs. However, make sure you are familiar with YAML syntax before editing this file. If the server cannot read the language file due to ignorance of the syntax, the consequences of java.lang.NullPointerException will be taken at its own risk.

Each key in the file represents the name of an event. Each value is the response text to the command sender after the event. Where, the content with the percent sign "%" is the variable name. Note that although the name of these variables and look PlaceholderAPI plug-in provided by the variable name is somewhat similar, but these variables and PlaceholderAPI has nothing to do. The variable name is replaced with the variable associated with the event during the actual run, so the variable name cannot be changed at will, nor can the external percent sign be omitted.

Step 4: Save file and modify the configuration file config.yml
Save the file in the root directory of your plug-in folder (that is, in the same directory as zh-cn.yml). Then, change the value of the language entry in the configuration file config.yml to your file name, but do not suffix it. (For example, if your custom language filename is called en-US.yml, you would put en-US in the language). If the path you entered does not exist or is inaccessible, the server may output some error messages.

Step 5: Reload the plugin, or restart your server
Reload the plug-in or restart the server to take effect

Self-check on configuration files
In order to prevent the plug-in loading failure or even server crash caused by the non-standard or ungrammatical content of the configuration file config.yml, the plug-in designed the automatic check function of the configuration file. If your configuration file is wrong or not conforming, in order to ensure the security of server operation, the plug-in will inform you of the error and the reason in the console, and automatically shut down the plug-in. But all of this assumes that your language files are configured correctly.

Currently, it is not equipped with automatic repair function, please follow the prompts to repair yourself.

Note: The plug-in may output some error messages on the console when it detects that the configuration file is invalid. This is a normal phenomenon. Do not report it to the community.

Join us
First of all, we would like to thank you for your great support of our development efforts. If you need to join the collaboration, you can Fork the project on GitHub and launch a Pull Request.

If you have any questions, you can contact us via email or email on GitHub.
[​IMG]
Resource Information
Author:
----------
Total Downloads: 38
First Release: Jan 19, 2023
Last Update: Jan 19, 2023
Category: ---------------
All-Time Rating:
0 ratings
Find more info at github.com...
Version -----
Released: --------------------
Downloads: ------
Version Rating:
----------------------
-- ratings