Show - Make amazing spectaculars in Minecraft

This code is Licensed under the GNU GPL v3 license. Read more here

This plugin allows you to make amazing 'shows' in Minecraft. By creating simple show files and running them alongside vanilla command blocks, the outcome can be spectacular as seen below:



All of the effects shown in that video are from vanilla commands working alongside two unique show files.



This one has slight editing for youtube but anything in minecraft was done via the shows plugin/actors/command blocks

Installation

Drag and Drop the .jar into plugins. You'll also need the following plugins installed:

Worldedit:
https://dev.bukkit.org/projects/worldedit

OpenAudioMC:
https://www.spigotmc.org/resources/...-music-and-effects-bungeecord-velocity.30691/

ProtocolLib:
https://www.spigotmc.org/resources/protocollib.1997/

Once installed, it'll auto generate folders.

Tutorials
All available 'actions' can be found here:

https://github.com/CubitsDev/Show/blob/master/actions.md

To start, make a folder in the plugins 'shows' folder and name it the same as the world the show will run in. By default this is called 'world' on spigot servers. Within this create a file with your favorite editor such as VSCode, called 'test.show'. To start, you'll need the following lines at the top (not the # lines obviously):



These 3 lines are some of the most important lines. Without these, the show will not run.

Next lets make our show do something. We're going to add a line of text to show in chat 1 second in and at 0 seconds play a sound once to all nearby players. The sound link has to comply with what OpenAudioMC considers a link. To do this we do this like below:


Congratulations, you just made your first super basic show! As of writing I don't have a lot of time to write in depth tutorials on how to make complex shows. However I plan on expanding the wiki soon.

Showgen
Showgen allows for the quick and easy generation of 'FakeBlocks' to change an existing structure to something completely different (but only to your clients, the actual build is safe and not updated).

Showgen has a prerequisite of needing a GitHub token to post the show lines it generates to a 'GitHub gist'. It's super easy to setup, follow this guide GitHub provides . The only scope needed is called 'gists'. I would recommend having a 'service' account for this, as to not spam your own GitHub gists. Once you have obtained a token, open the config.yml file in the Show folder and add your key to the appropriate line.

Once added and your server restarted, you can follow the below instructions to generate the show file.

Start by selecting your 'scene' with a WorldEdit wand (typically the wooden axe). Your new scene has to be the same size so make sure you know how big the region is.
Following this, run /showgen setinitialscene

This will set your initial scene. Next head to the North West bottom corner of your initial scene. This is super important that it's the north west corner as this is the corner used to determine where to build your new scene. Once found, enter it in as:
/showgen setcorner x,y,z

Next, head to your new scene. Select it the same as you did the initial one, same size, same 1st position, etc (but different co-ordinates). Finally, do /showgen generate FakeBlock [top/bottom] [delay per layer in seconds] [timestamp to start at]

If you have done everything correct, this should send a link with your new lines you can add to your show file.

Commands
/show - Main command - show.main (permission)
/showdebug - Debug Command - show.debug (permission)
/showgen - Generation Commands - show.showgen (permission)

FAQ
Q: My show says it has started but does nothing!
A: Run /showdebug to see any errors. It should give a reason and which line has caused it.

Q: Is this the plugin palace used?
A: Yes! This is a fork of the original code that people such as Legobuilder0813, Innectic, Parker and myself worked on. However this has been modified to work outside the 'Palace ecosystem'.

Q: The audio isn't in time!
A: This tends to be from users' internet connections and OpenAudioMC playing files. For the regions, it'll auto catch up, but single sounds may be out of time. Having a CDN would be the best but most expensive solution.

Missing/Future stuff
Right now certain things such as Showbuild had to be removed as they would require some reworking to get them in a nice way again. That's not to say they won't be added back in future.

Please leave any bugs or questions on here and I'll do my best to answer, but the plugin might not be actively worked on past it's current state.

Credit to Legobuilder0813, Innectic, Parker as well as me for working on the plugin over the years <3