Script: Terastal Phenomenon [v20.1] [DEPRECATED]

[Lucidious89]

Terastal Phenomenon for v20.1

NOTICE:
This plugin is now deprecated, and no longer supported. An improved version for Essentials v21.1 has been released as part of the Deluxe Battle Kit, so use that instead if possible. I will leave the download link and installation instructions for this version below for the time being. I may remove these at a later date, however.​

​

-DOWNLOAD LINK-


Installation

Spoiler:

• Download and install the latest version of the Essentials Deluxe plugin. To reiterate, this is required for this plugin to work.
• If you have already installed (broken link removed), please uninstall it before installing this one.
• Download this plugin using the link provided and extract its contents to your root Essentials folder.
• If you are using the Generation 8 Pack, go to the 000_Config file in that plugin, and set SMOOTH_FRAMERATE to "false". Some of the new animations used by this plugin may be visually bugged when this setting is true. If you don't plan on using these animations, then this isn't necessary.
• Use the Settings file located in this plugin's folder to adjust things to your liking.
• IMPORTANT: If you plan on using other plugins that replaces or overwrites your entire Items or Moves PBS files, such as the Gen 9 Pack, then you must install this plugin AFTER installing those first. If you install this one first, then any PBS changes applied by this plugin will be overwritten the second those plugins are installed, thus rendering this plugin useless. Please keep that in mind before claiming that this plugin doesn't work.

Plugin Tutorials​

Player Terastallization

Spoiler:

Requirements
To use Terastallization, you'll first need to have an item in your inventory that unlocks the ability to use it. Any item given the TeraOrb flag in its PBS data will be considered a Tera Orb, which will allow you to Terastallize. By default, this plugin adds the Tera Orb introduced in Scarlet & Violet. Feel free to create your own custom Tera Orbs, too.

In addition, the player also requires that their Tera Orb be charged in order to use Terastallization. The player's Tera Orb is depleted upon use, and must be recharged each time. You can recharge your Tera Orb by healing at a Pokemon Center. If you're currently on a map that is flagged as AreaZero, your Tera Orb will have infinite charge, and won't require recharging.

While playing in Debug mode, a debug option is included which allows you to toggle the charge state of your Tera Orb. You may also hold CTRL while Terastallizing to keep your Tera Orb charged. You may also use the TERA_ORB_RECHARGE plugin setting to remove the recharge requirement for the player's Tera Orb, if you'd like.

Battle
To activate Terastallization in battle, press the ACTION button to toggle the mechanic on and off prior to selecting your move. When toggled on, the button will change to indicate which type the user will be Terastallizing into. Once a move has been selected, a brief animation will play showing the trainer using the Tera Orb in their inventory to allow the Pokemon to Terastallize. This animation can be skipped by pressing the ACTION button at any point during the animation. If battle animations have been turned off, this animation will automatically be skipped.

Typically, Terastallization may only be used once per battle. However, this plugin introduces a new custom item called a "Radiant Tera Jewel". When used in battle, this item will recharge your Tera Orb, allowing you to use Terastallize once more.

Terastallization cannot be used if the user is a Shadow Pokemon, or under the effects of Mega Evolution, Primal Reversion, Ultra Burst, Battle Styles, or Dynamax; or if the user meets the conditions of using another mechanic.

Enemy Terastallization

Spoiler:

Requirements
Opposing NPC trainers can be set up to use Terastallization against you as well. The requirements are the same as for the player, they are simply set up differently. The trainer must be given an eligible Tera Orb in their inventory. If all other conditions are met, they will always save Terastallization for their ace Pokemon, and use it as soon as it's available. A Trainer's "ace" Pokemon is whatever Pokemon appears last in their lineup, as defined in their PBS data. If you desire an earlier Pokemon in their lineup to be considered an ace, you may simply set Ace = yes in that Pokemon's data.

Note that unlike the player, opposing trainers Tera Orbs are always considered "charged", and don't require recharging between uses.

Wild Pokemon
Terastallization may also be utilized by wild Pokemon, without the use of a Tera Orb. These wild Tera battles replicate how they work in Scarlet & Violet, so they work a little differently than a standard battle. When encountered, a wild Tera Pokemon will immediately Terastallize at the start of battle. After which, the Pokemon will become uncatchable until you break their Terastallization by lowering their HP to a certain threshold (1/6th of their max HP). Any damage dealt by direct attacks cannot exceed this threshold until the wild Pokemon's Terastallization is removed. When removed, the Pokemon will become catchable again like a normal wild Pokemon.

To allow for a wild Pokemon to Terastallize, they must be flagged as an "ace", in the same way trainer's Pokemon are. This can be easily done by setting Pokemon#.ace = true, or by setting :ace to true using a Deluxe battle setting. When playing in Debug mode, you may also use the Debug options to set the ace flag on a Pokemon prior to battle.

Battle
The AI for NPC trainers will simply use Terastallization as soon as it is available to them on their compatible ace Pokemon.

Disabling Terastallization

Spoiler:

Gameplay
If you want to temporarily remove the ability to use Terastallization (for both you and opponents), you can set the NO_TERASTALLIZE game switch to "true". The number for this switch is located in the Essentials Deluxe plugin's Settings script. Please change this number if it conflicts with an existing switch number used by Essentials, or any other plugin. You may also toggle Terastallization availability through the in-game Debug menu, under the "Deluxe Plugin" settings.

Visuals
If you want to permanently turn off the Terastallization battle animation from playing, you can do so by setting SHOW_TERA_ANIM to "false" in the plugin Settings. If you'd like to hide the crystal pattern overlay that appears on Terastallized Pokemon, you may use the SHOW_TERA_OVERLAY setting to disable this.

By default, a Pokemon's Tera Type is displayed in both the Summary and Storage screens. You may toggle this display with the SUMMARY_TERA_TYPES and STORAGE_TERA_TYPES plugin settings, respectively.

Changing Tera Types

Spoiler:

Player's Pokemon
Like in Scarlet & Violet, you may use Tera Shards to change a Pokemon's Tera Type. Unlike in those games though, you may simply use these items directly on your Pokemon to change their Tera Type, instead of visiting an NPC to do it for you. Like in the main games, 50 Tera Shards of a specific type are required to change a Pokemon's Tera Type to that type. However, the plugin setting TERA_SHARDS_REQUIRED allows you to tweak this to a different amount to suit your game. Any item given the flag TeraShard_TYPE will be considered a Tera Shard, where "TYPE" is a specific type ID. For example, the Fire Tera Shard item has the flag TeraShard_FIRE.

I've also included two custom items not found in the main games. The first is called Mystery Tera Jewel, with the flag TeraShard_Random. When used, this item will give your Pokemon a completely random Tera Type. The second item is called Master Tera Jewel, with the flag TeraShard_Choose. When used, this item will give your Pokemon a specific Tera Type of your choosing. Any item given these flags will allow you to randomize or choose a Tera Type on a Pokemon, respectively. Unlike Tera Shards, these items only consume 1 item per use, like normal items.

You may also manually edit a Pokemon's Tera Type by simply setting Pokemon#.tera_type equal to a specific type ID of your choosing. While in Debug mode, there is also a Debug tool under "Deluxe Options.." to edit a Pokemon's Tera Type in your party.

Opponent Pokemon
To set a specific Tera Type on an NPC trainer's Pokemon, you may simply set TeraType = TYPE for that Pokemon in the trainers.txt PBS file, where "TYPE" is the specific type ID you want their Tera Type to be for that Pokemon. You may also accomplish this in the in-game Trainer Editor while playing in Debug mode. If editing a wild Pokemon's Tera Type, you may manually edit the Pokemon object by setting Pokemon#.tera_type equal to a specific type ID, like you can with any Pokemon. If setting up a Deluxe wild battle, you may also set :teratype equal to a specific type ID in the Pokemon hash, instead.

 

[DrawnToast]

This script works great so far, but somehow I can't get wild Pokémon to Terastallize, even when I set the ace to yes in Deluxe Battle, have the switch on, and the Tera Orb in my inventory.
I could just be overlooking something minor, but I need to make sure.

 

[Lucidious89]

This script works great so far, but somehow I can't get wild Pokémon to Terastallize, even when I set the ace to yes in Deluxe Battle, have the switch on, and the Tera Orb in my inventory.
I could just be overlooking something minor, but I need to make sure.

What does your battle code look like, and what other plugins do you have installed? Terastallization is set to have the lowest priority of all the battle mechanics (Mega, Z-Move, Dynamax, etc..), so if it meets the requirements first for one of those, it will be considered ineligible for Terastallization.

 

[DrawnToast]

What does your battle code look like, and what other plugins do you have installed? Terastallization is set to have the lowest priority of all the battle mechanics (Mega, Z-Move, Dynamax, etc..), so if it meets the requirements first for one of those, it will be considered ineligible for Terastallization.

I have all the required plugins, and the wild Pokémon doesn't have a Z-Move or can Dynamax. None of my other scripts edit the battles.
It's pretty odd because Trainers can Terastallize, but not wild Pokémon.

 

[Lucidious89]

I have all the required plugins, and the wild Pokémon doesn't have a Z-Move or can Dynamax. None of my other scripts edit the battles.
It's pretty odd because Trainers can Terastallize, but not wild Pokémon.

Let me see the code youre using for the wild battles.

 

[DrawnToast]

Let me see the code youre using for the wild battles.

I'm testing this using a wild Foongus, so I used this: WildBattle.dx_start([:FOONGUS, 15], { :ace => true }, {}, :WILD_TERA_ACTIVE)
That leads to Essentials Deluxe's midbattle script where the ace is set to true.

 

[Lucidious89]

I'm testing this using a wild Foongus, so I used this: WildBattle.dx_start([:FOONGUS, 15], { :ace => true }, {}, :WILD_TERA_ACTIVE)
That leads to Essentials Deluxe's midbattle script where the ace is set to true.

Ace is a Pokemon property. You have it set in the "Rules" hash.

 

[DrawnToast]

Ace is a Pokemon property. You have it set in the "Rules" hash.

Ahh, that makes sense. It works for me now! Thank you!

 

[A.I.R]

Can you officially annouce support for this add-on by wrigty? (broken link removed)

 

[A.I.R]

Hello! Every time i want to open t he pokemon summery screen i get this error msg. And the game shuts down.😔

Here is the message:-------------------

Spoiler:

[2023-02-07 16:14:21 +0600]
[Pokémon Essentials version 20.1]
[v20.1 Hotfixes 1.0.7]

Exception: ArgumentError
Message: Invalid argument passed to method.
Expected [:ICE] to be one of [Symbol, GameData::Type, String], but got Array.

Backtrace:
Validation:29:in `validate'
GameData:92:in `get'
[Terastal Phenomenon] [003] Miscellaneous.rb:58:in `pbDisplayTeraType'
[Terastal Phenomenon] [003] Miscellaneous.rb:52:in `drawPageOne'
[BW Summary Screen] BW Summary Screen.rb:554:in `drawPage'
[ZUD Mechanics] UI_Summary.rb:19:in `drawPage'
[Enhanced UI] [001] Pokemon UI.rb:40:in `drawPage'
[BW Summary Screen] BW Summary Screen.rb:215:in `pbStartScene'
[BW Summary Screen] BW Summary Screen.rb:1698:in `pbStartScreen'
[BW Party Screen] BW Party Screen.rb:739:in `pbSummary'

Note that that :ICE depends on the pokemon type.

like another

Spoiler:

[2023-02-07 16:09:59 +0600]
[Pokémon Essentials version 20.1]
[v20.1 Hotfixes 1.0.7]

Exception: ArgumentError
Message: Invalid argument passed to method.
Expected [:ELECTRIC] to be one of [Symbol, GameData::Type, String], but got Array.

Backtrace:
Validation:29:in `validate'
GameData:92:in `get'
[Terastal Phenomenon] [003] Miscellaneous.rb:58:in `pbDisplayTeraType'
[Terastal Phenomenon] [003] Miscellaneous.rb:52:in `drawPageOne'
[BW Summary Screen] BW Summary Screen.rb:554:in `drawPage'
[ZUD Mechanics] UI_Summary.rb:19:in `drawPage'
[Enhanced UI] [001] Pokemon UI.rb:40:in `drawPage'
[BW Summary Screen] BW Summary Screen.rb:215:in `pbStartScene'
[BW Summary Screen] BW Summary Screen.rb:1698:in `pbStartScreen'
[BW Party Screen] BW Party Screen.rb:739:in `pbSummary'

 

[Lucidious89]

Hello! Every time i want to open t he pokemon summery screen i get this error msg. And the game shuts down.😔

Here is the message:-------------------

Spoiler:

[2023-02-07 16:14:21 +0600]
[Pokémon Essentials version 20.1]
[v20.1 Hotfixes 1.0.7]

Exception: ArgumentError
Message: Invalid argument passed to method.
Expected [:ICE] to be one of [Symbol, GameData::Type, String], but got Array.

Backtrace:
Validation:29:in `validate'
GameData:92:in `get'
[Terastal Phenomenon] [003] Miscellaneous.rb:58:in `pbDisplayTeraType'
[Terastal Phenomenon] [003] Miscellaneous.rb:52:in `drawPageOne'
[BW Summary Screen] BW Summary Screen.rb:554:in `drawPage'
[ZUD Mechanics] UI_Summary.rb:19:in `drawPage'
[Enhanced UI] [001] Pokemon UI.rb:40:in `drawPage'
[BW Summary Screen] BW Summary Screen.rb:215:in `pbStartScene'
[BW Summary Screen] BW Summary Screen.rb:1698:in `pbStartScreen'
[BW Party Screen] BW Party Screen.rb:739:in `pbSummary'

Note that that :ICE depends on the pokemon type.

like another

Spoiler:

[2023-02-07 16:09:59 +0600]
[Pokémon Essentials version 20.1]
[v20.1 Hotfixes 1.0.7]

Exception: ArgumentError
Message: Invalid argument passed to method.
Expected [:ELECTRIC] to be one of [Symbol, GameData::Type, String], but got Array.

Backtrace:
Validation:29:in `validate'
GameData:92:in `get'
[Terastal Phenomenon] [003] Miscellaneous.rb:58:in `pbDisplayTeraType'
[Terastal Phenomenon] [003] Miscellaneous.rb:52:in `drawPageOne'
[BW Summary Screen] BW Summary Screen.rb:554:in `drawPage'
[ZUD Mechanics] UI_Summary.rb:19:in `drawPage'
[Enhanced UI] [001] Pokemon UI.rb:40:in `drawPage'
[BW Summary Screen] BW Summary Screen.rb:215:in `pbStartScene'
[BW Summary Screen] BW Summary Screen.rb:1698:in `pbStartScreen'
[BW Party Screen] BW Party Screen.rb:739:in `pbSummary'

I don't have a clue why your Tera Types would be saved as an array, my plugin isn't designed to do that. Probably whatever add-on you installed is improperly setting Tera Types in the wrong format.

 

[A.I.R]

May be you are right I should try removing some of my plugins and try again. This is not the Zud Plugin thread but thanks for adding support for Animated Sprites.

 

[Lucidious89]

May be you are right I should try removing some of my plugins and try again. This is not the Zud Plugin thread but thanks for adding support for Animated Sprites.

It's probably the wrigty add-on you mentioned, as that's the only possible thing that would alter how Tera Types are saved.

 

[A.I.R]

Nah, That is not the wrigty add-on. I started a new save and all is done.

 

[ardicoozer]

when I'm testing on JoiPlay,
This error' come up
[img]https://i.ibb.co/PtnCvnc/Scree...57-6f222323860cb8b3cbff0909a5afd514.jpg[/img]

 

[Lucidious89]

when I'm testing on JoiPlay,
This error' come up
[img]https://i.ibb.co/PtnCvnc/Scree...57-6f222323860cb8b3cbff0909a5afd514.jpg[/img]

I mean, this is obviously a ZUD issue, not this plugin. But regardless, do you have any context behind what triggered the error? And do you have any other plugins installed that edit sprite data?

 

[Lucidious89]

Minor Update (v1.0.1)

• Made it so that the button display for triggering Terastallization in battle will now automatically scale properly to the amount of types you have defined in your game, even if this is more or less than the number of types in the core series.
• While playing in Debug mode, you may now flag whether or not individual trainers are capable of using Terastallization through the in-battle debug tool.

 

[Lucidious89]

Minor Update (v1.0.2)

• Moved the tera item check into the Essentials Deluxe plugin for better compatibility with other plugins.

 

[SuperSpyroDragon64]

How do I remove the power bonus granted when you Terrastalize a Pokemon's type into a type it already has?

 

[Lucidious89]

How do I remove the power bonus granted when you Terrastalize a Pokemon's type into a type it already has?

It's in Battle_Move.rb. It's pretty clearly labeled in the comments; shouldn't be hard to edit from there.