This plugin builds upon the Deluxe Battle Kit to add the Wonder Launcher functionality to your trainer battles. The Wonder Launcher was a feature that was introduced in Pokemon Black & White. In these games, you had the ability to queue for special PvP battles online where players had the ability to use items from their inventory during a competitive match - a first in the series.
However, these were not ordinary items from your bag. Instead, each player was given a special set inventory of items that could be launched onto the battlefield. These included typical healing items such as Potions, Revives, and status cures, as well as X items that would boost a Pokemon's stats. Additionally, each player had to earn the right to use one of these items during battle by spending a number of points relative to the quality of the selected item; points which were earned at the start of each turn. This plugin aims to replicate this mechanic which will allow you to participate in Wonder Launcher battles against NPC trainers in Essentials.
In the following subsections, I'll go into detail about the various aspects and features of this plugin.
General Plugin Utilities
Enabling Wonder Launcher battles
You can enable the Wonder Launcher globally for all trainer battles by default by using a switch. The switch number used for this can be found by going into this plugin's files and opening the Settings file.
Here, you will find a setting called WONDER_LAUNCHER_SWITCH. This is where the switch number used to toggle Wonder Launcher battles on or off is stored. By default, this switch number is set to 72, but please set this to whatever switch number you want if this overlaps with an existing switch that you are using elsewhere. While playing in debug mode, you can quickly toggle this switch by going to "Deluxe plugin settings..." in the debug menu, and using the "Toggle Wonder Launcher" setting.
Once your preferred switch number is set and you turn this switch on in-game, all trainer battles will use the Wonder Launcher.
If you ever want to turn this feature off and disable the Wonder Launcher mechanic for all trainer battles, you can do so by simply turning this game switch off again.
Customizing Launcher Points (LP)
LP Gains
During a Wonder Launcher battle, each trainer gains LP at the start of each turn. By default, this is only a single point per turn. However, you can customize the number of points gained each turn in the plugin Settings by setting WONDER_LAUNCHER_POINTS_PER_TURN to your desired amount.
Maximum LP
Each trainer can only carry a max number of LP before they will no longer gain any more. By default, this is capped at 14 points. However, you can customize what the max number of points should be in the plugin Settings by setting WONDER_LAUNCHER_MAX_POINTS to your desired amount.
LP Splash Bars
During a Wonder Launcher battle, a splash bar will appear on screen each time a trainer's LP totals change to indicate what their current totals are. Because LP is gained at the start of each turn, this also means that these splash bars will appear on screen for each trainer at the start of each turn. If you dislike this and don't want this to display every turn, you can simply disable it by opening the plugin Settings and setting SHOW_LAUNCHER_SPLASH_EACH_TURN to false.
Wonder Launcher Count
Essentials internally keeps track of a variety of the player's game statistics. I've added trackers which will keep count of various statistics related to the Wonder Launcher, too.
Below are all of the new statistics tracked by this plugin, and how to call them.
Launched item count
This plugin keeps count of how many times the player has spent LP to launch an item with the Wonder Launcher. This can be called with the script $stats.wonder_launcher_item_count.
Wonder Launcher battles won
This plugin keeps count of how many Wonder Launcher battles the player has won. This can be called with the script $stats.wonder_launcher_battles_won.