Advanced Firework Show
Advanced Firework Show
This is a small plugin I made. It was made after a request on the Bukkit forums. It now has no more bugs visible to me, but surely it still has some. I am also not sure if the usage is understandable, but I do hope so.
Commands:
All commands can also be viewed ingame, either by tab completion or by typing "/afs help".
Command | Explanation |
---|---|
/AFS mortar <name> <add / remove> [y offset] | Self explanatory. Y offset is the difference on the y axis, relative to the mortar, the firework should spawn. |
/AFS mortar <edit> [y offset] | You must be looking at a mortar to execute that. You can redefine the y offset too. |
/AFS getFirework <name> | This just gives you the firework of the mortar. |
/AFS show <name> <remove / info / setView / getView> | Info gives you info about the show (when mortars start, at which time it will auto - start). setView sets the view position to your current, getView teleports you to the view point. |
/AFS show <name> <setTime> | Lets you set the time the show sould auto start at. |
/AFS show <name> <create> <mortar1> [mortar2]... | Lets you create a show. For detailed use please type "/AFS show help" in the chat and answer the question with "true". |
/AFS teleport <name> <all / player name> [player name 2]... | This teleports either all (if you typed "/AFS teleport <name> all") or just specific players to the view point of a show. |
/AFS list <mortar / show> | This lists all mortars or shows. |
/AFS launch <name> | This launches the mortar with the name <name>. |
/AFS lookup | This checks whether the cauldron you are looking at is a cauldron. |
/AFS start <name> | This starts a show |
/AFS reload <config / language / show / mortar> | Reloads the entry. |
/AFS help | Displays the help. |
Other:
You can "SHIFT+Left click" a mortar to get it's firework. If you're holding a firework obtained via "SHIFT+Left click" or "/AFS getFirework", you can "SHIFT+Right click" on a mortar to set it's firework to the one in your hand. If the cauldron you click on is no mortar, you will Quick-Create a new one with the firework in your hand. It will ask in chat for the name and the y offset. Just type that in the chat.
Shows are saved in the folder "/plugins/Advanced_Firework_Show/showSave". You will find a "<name>.yml" file for every show. This notes the order in which the mortars should fire and all the delay. Maybe you will find a second file named "<name>.txt". This holds the view Location and the start time. If the time is set to "-1" or "-1:-1", it WONT auto start the show.
I would highly suggest (and as written in the show help) to just create a show and do the rest in the file. You can add as many mortars with the command as fit in the chat. So not too many. However you can easily edit the file. Note, that every unit after the "|" sign in a Line starting with "PAUSE" was generated for YOUR help. It is never read in any way. You can add Pauses in Ticks ("t" - Suffix) Miliseconds ("ms" - Suffix) or Seconds ("s" - Suffix). The times after "Current time" show you were you are now, relative to the start of the show.
It also has a tab completion which is handy for selecting shows, mortars, etc.
Config:
Should be commented.
Language:
This plugin has a language file containing nearly every message the plugin will send. Be sure to read the header! You can adjust this as you want. If you screw up, it will try to fallback to the defaults and create the "defaultLanguage.yml" file. It will also tell you in the console which key you missed.
Permissions:
Permission | Explanation |
---|---|
afs.mortar.add | This lets you create mortars |
afs.mortar.add.quick | This lets you quick create mortars |
afs.mortar.delete | This lets you delete mortars |
afs.mortar.edit.command | This lets you use the mortar edit command |
afs.mortar.edit.setfirework | This lets you quick set the firework |
afs.mortar.lookup | This lets you lookup mortars |
afs.mortar.launch | This lets you launch mortars |
afs.mortar.getfirework | This lets you get the firework of a mortar |
afs.show.create | This lets you create shows |
afs.show.delete | This lets you delete shows |
afs.show.start | This lets you start shows |
afs.show.info | This lets you get the show info |
afs.show.setview | This lets you set the show view |
afs.show.getview | This lets you teleport to the show view |
afs.show.settime | This lets you set the start time of a show |
afs.show.teleport | This lets you teleport others/all to the show view |
afs.other.list | This lets you use the list command |
Comments