EzShows - Create Immersive In-Game Shows and Events

EzShows is a powerful and feature-rich Minecraft plugin designed to help server owners create immersive and dynamic in-game shows, events, and experiences. Whether you're hosting a fireworks display, a music concert, or a custom event, EzShows provides all the tools you need to captivate your players. With seamless OpenAudioMC integration, customizable effects, and an intuitive GUI, EzShows makes it easy to bring your creative visions to life.

───────────────────────────────────────────────────────────────────────────

Features

• Show Management:
  • Create, edit, and delete shows directly in-game.
  • Manage show settings such as region name, center location, and action distance.
• Dynamic Effects:
  • Add fireworks, particles, fountains, blocks, and text displays to your shows.
  • Customize effects with detailed options like colors, motion, duration, and more.
• Audio Integration:
  • Seamless integration with OpenAudioMC for synchronized music playback.
  • Preload audio for nearby players to ensure smooth playback during shows.
• Track Management:
  • Create, edit, and delete audio tracks using an intuitive GUI.
  • Manage track properties such as name, URL, and duration.
• Intuitive GUI:
  • User-friendly interfaces for managing shows, tracks, and effects.
  • Pagination support for handling large numbers of actions or tracks.
• Automation:
  • Schedule actions and effects with precise tick-based timing.
  • Automatically stop shows when all actions and audio are completed.

───────────────────────────────────────────────────────────────────────────

Commands
Here are the commands you can use with EzShows:

Command	Description	Permission
/show create [name]	Create a new show.	ezshows.use
/show edit [name]	Edit an existing show.	ezshows.use
/show start [name]	Start a show.	ezshows.use
/show stop [name]	Stop a running show.	ezshows.use
/show delete [name]	Delete a show.	ezshows.use
/show reloadtracks	Reload audio tracks from tracks.yml.	ezshows.admin
/show reload	Reload all shows from data.yml.	ezshows.admin

───────────────────────────────────────────────────────────────────────────

How to Set Up

1. Install the Plugin:
   • Download the EzShows.jar file and place it in your server's plugins folder.
   • Restart your server to generate the necessary configuration files (data.yml and tracks.yml).
2. Install OpenAudioMC (Optional):
   • If you want to use audio features, download and install OpenAudioMC on your server.
   • Ensure OpenAudioMC is configured correctly for audio playback.
3. Configure Your Shows:
   • Use /show create [name] to create a new show.
   • Use /show edit [name] to open the editor GUI and add effects, music, and settings to your show.
4. Add Audio Tracks:
   • Use the music selection GUI to create and manage audio tracks.
   • Add track URLs, set durations, and preview tracks before adding them to your show.
5. Start Your Show:
   • Use /show start [name] to start your show and watch the magic happen!

───────────────────────────────────────────────────────────────────────────

How to Use the GUI

• Show Editor:
  • Open the editor GUI with /show edit [name].
  • Add effects like fireworks, particles, fountains, blocks, and text displays.
  • Customize each effect with detailed options such as colors, motion, and duration.
• Music Selection:
  • Open the music selection GUI to manage audio tracks.
  • Preview tracks, set durations, and assign them to your shows.

───────────────────────────────────────────────────────────────────────────

Requirements

• Minecraft Version: Compatible with 1.16+ (tested on 1.20).
• Dependencies: OpenAudioMC (required for audio features).

───────────────────────────────────────────────────────────────────────────

Configuration Files

1. data.yml:
   • Stores all show data, including actions, effects, and settings.
   • Automatically generated when the plugin is installed.
2. tracks.yml:
   • Stores all audio track data, including names, URLs, and durations.
   • Automatically generated when the plugin is installed.

───────────────────────────────────────────────────────────────────────────

Support
If you encounter any issues or have questions about EzShows, we're here to help! Here's how you can get support:

• Discord: Join our community Discord server for real-time support and updates.
• Email: Contact us at [[email protected]] for assistance.
• Documentation: Check out our detailed documentation for setup guides and FAQs.

───────────────────────────────────────────────────────────────────────────

Known Issues

• Audio playback requires OpenAudioMC to be installed and configured correctly.
• Ensure valid URLs are used for audio tracks to avoid playback errors.
• Some effects may not work as expected if improperly configured.

───────────────────────────────────────────────────────────────────────────

Why Choose EzShows?
EzShows is designed to make creating in-game shows and events as easy and intuitive as possible. With its powerful features, seamless audio integration, and user-friendly GUI, EzShows is the perfect tool for server owners looking to create unforgettable experiences for their players.

───────────────────────────────────────────────────────────────────────────

Let me know if you'd like to refine this further or add more details!