---
description: Section 7.F.3
---

# Terastal: Animations

The Deluxe Battle Kit incorporates various animation utilities which it uses to animate Mega Evolution and Primal Reversion. This plugin utilizes these same utilities to implement a new animation for Terastallization that is built in the same animation style.

There's a bit to explain about these animations and how they work, so I'll provide a break down of everything in this section.

{% hint style="info" %}
Note: If you already have an existing Terastallization animation which is stored as a Common animation named `"Terastallization"`, that animation will take priority over the animation added by this plugin. This means that there's no risk of your animation being overwritten or ignored, nor do you need to change anything to make this plugin compatible.
{% endhint %}

***

<mark style="background-color:orange;">**Trainer Terastallization**</mark>

Terastallization typically requires a trainer with a Tera Orb and a Pokemon with a Tera Type to Terastallize into. If so, the option to Terastallize that Pokemon will appear in battle. When triggered, the Terastallization animation will play.

<figure><img src="https://2153694798-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvzqYxbzoSOVtGkOgfRUQ%2Fuploads%2F8qF9bk69IKDB0R4P1ji4%2Fdemo50.gif?alt=media&#x26;token=a392e623-51bb-4fdf-954d-2ac667e0c040" alt="" width="381"><figcaption><p>Terastallization on the player's side.</p></figcaption></figure>

There will be slight differences in the animation based on which side of the field the Terastallized Pokemon is on. Pokemon on the player's side of the field will face right, and their trainer will slide in from off screen on the left. If the Pokemon is on the opponent's side of the field, they will face left and their trainer will slide in from off screen on the right. This helps distinguish if the Terastallized Pokemon is friend or foe during the animation.

<figure><img src="https://2153694798-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvzqYxbzoSOVtGkOgfRUQ%2Fuploads%2FiTl3rcZyJQ0m80o5Xo3H%2Fdemo49.gif?alt=media&#x26;token=3e7d93eb-02c0-495b-acf5-204f82b6d24b" alt="" width="381"><figcaption><p>Terastallization on the opponent's side.</p></figcaption></figure>

Terastal Animations will always display the trainer's Tera Orb above the trainer during the animation. The trainer's item may not always be the same, however. The Tera Orb is the default item used, but it's possible to give trainers unique items that trigger Terastallization. If you create unique Tera items for a trainer to utilize along with the necessary sprites, then the sprite for that unique item will appear in this animation instead of the default Tera Orb.

***

<mark style="background-color:orange;">**Wild Terastallization**</mark>

Typically, wild Pokemon are incapable of Terastallizing. This is because a trainer with a corresponding Tera Orb is required. However, this plugin includes a feature that allows wild Pokemon to Terastallize on their own without a trainer, by utilizing the <mark style="background-color:green;">"wildTerastallize"</mark> Battle Rule (more details on this can be found in the "Terastal: Battle Rules" subsection). This bypasses the Tera Orb requirement, allowing the wild Pokemon to Terastallize.

<figure><img src="https://2153694798-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvzqYxbzoSOVtGkOgfRUQ%2Fuploads%2F7Ntu3nTHUxZjnuPSJZA2%2Fdemo51.gif?alt=media&#x26;token=fe147921-43be-4aeb-804c-fd9549082584" alt="" width="381"><figcaption><p>Wild Terastallization animation.</p></figcaption></figure>

The animation for wild Terastallization is mostly the same. The only obvious difference is that no trainer slides on screen during the animation, since no trainer exists.

***

<mark style="background-color:orange;">**Animation Utilities**</mark>

<mark style="background-color:yellow;">**Skipping Animations**</mark>

You may have noticed in the examples above that during the Terastal animation, a button prompt on the bottom left-hand corner of the screen appears. This "skip" button indicates that you can cut the animation short by pressing the `ACTION` key. Pressing it will immediately end the animation, allowing you to get right back to the battle if you grow tired of sitting through these animations.

<mark style="background-color:yellow;">**Turning Off Animations**</mark>

If you want to turn these animations off entirely, there are two ways to accomplish this. First, you may do so by turning off battle animations completely in the Options menu.&#x20;

<figure><img src="https://2153694798-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvzqYxbzoSOVtGkOgfRUQ%2Fuploads%2FwOMVVwf7z58G4TSKSGM6%2F%5B2024-01-12%5D%2011_58_20.948.png?alt=media&#x26;token=36cd6063-28d1-4886-9f6e-49bbf7642b8f" alt="" width="384"><figcaption><p>Battle animations in the Options menu.</p></figcaption></figure>

If so, this animation will also be turned off. Instead, it'll be replaced with a generic "quick-change" animation which happens instantaneously.

<figure><img src="https://2153694798-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvzqYxbzoSOVtGkOgfRUQ%2Fuploads%2FePzUFbCkbPLwJGKXlvqB%2Fdemo54.gif?alt=media&#x26;token=d6be105e-cea7-400f-b021-c07a383c6cfc" alt="" width="381"><figcaption><p>Quick-change animation.</p></figcaption></figure>

The second way to turn off the animation would be to open the settings file in this plugin. Here, you'll find the setting `SHOW_TERA_ANIM`. If you set this to `false`,  the Terastal animation will be shut off permanently, and will be replaced with the quick-change animation above, even when battle animations are turned on.

***

<mark style="background-color:orange;">**Other Animations**</mark>

There are some additional animations added by this plugin related to Terastallization.

<mark style="background-color:yellow;">**Tera Break**</mark>

This is the animation used when a Pokemon's Terastallization is forcefully ended. This may only happen if a Terastallized Pokemon is KO'd, or if a wild Tera Pokemon reaches a certain HP threshold where their Terastallization state is abruptly ended. If so, their crystallized form will "shatter" and break off of the Pokemon. It's a simple animation, but it helps to emphasize a more dramatic end to the Terastal state than simply fading away as it does in most other scenarios.

<figure><img src="https://2153694798-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvzqYxbzoSOVtGkOgfRUQ%2Fuploads%2F8nVOnGSr5cLiGhpUemzF%2Fdemo55.gif?alt=media&#x26;token=4772ef5a-82fc-4de1-99be-fedc0dbdc662" alt="" width="381"><figcaption><p>Example of a Tera Break animation.</p></figcaption></figure>

<mark style="background-color:yellow;">**Tera Burst**</mark>

This animation is used whenever a Pokemon in a Terastal state is about to execute a damage-dealing move that is receiving a power boost due to Terastallization. For example, if a Pokemon has Terastallized into a Fire-type, moves used by that Pokemon that deal Fire-type damage will display this animation before use. This is even true if the move isn't Fire-type naturally, but has been turned into a Fire-type move due to an effect, such as Tera Blast.

<figure><img src="https://2153694798-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvzqYxbzoSOVtGkOgfRUQ%2Fuploads%2FhO7klNdqD8JTLKdwd9nA%2Fdemo56.gif?alt=media&#x26;token=72caf413-1e85-4211-ab1f-2c8b59f05c38" alt="" width="381"><figcaption><p>Example of a Tera Burst animation.</p></figcaption></figure>

Note that if the user is Terastallized into the Stellar-type, this animation will play whenever their selected move is being boosted by the Stellar type. This can happen once per type in a single battle. The only exception to this is Terapagos, who's moves are boosted indefinitely while Terastallized into the Stellar type, so it will always play this animation.

***

<mark style="background-color:orange;">**Tera Visuals**</mark>

<mark style="background-color:yellow;">**Tera Type Icons**</mark>

When a Pokemon Terastallizes, the Tera Type icon of their new type will be displayed next to their databoxes, similar to icons for other mechanics such as Mega Evolution and Primal Reversion. This will allow the player to see the current type of all Terastallized Pokemon at all times, since no Tera hats are displayed here, unlike in Scarlet & Violet.

<figure><img src="https://2153694798-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvzqYxbzoSOVtGkOgfRUQ%2Fuploads%2Fc2wQnMMvUYSeL0w1t2HH%2F%5B2024-01-26%5D%2011_29_27.067.png?alt=media&#x26;token=85ddea7d-fe44-4e36-b1df-91341e0c8fe8" alt="" width="384"><figcaption><p>Example of Tera Type icons.</p></figcaption></figure>

<mark style="background-color:yellow;">**Terastal Overlays**</mark>

While in the Terastal state, a Pokemon's sprite will be overlayed with a crystallized pattern. This color of this pattern will reflect their current type while Terastallized. If you would rather turn this pattern off and display the Pokemon's sprites normally, you may do so by setting `SHOW_TERA_OVERLAY` to `false` in the plugin settings.

<figure><img src="https://2153694798-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvzqYxbzoSOVtGkOgfRUQ%2Fuploads%2FQB2stranJslMGdS9Sbyj%2F%5B2024-01-26%5D%2011_30_57.074.png?alt=media&#x26;token=cfb59fc3-f976-4f77-b81b-86d9d69e9d28" alt="" width="384"><figcaption><p>Example of a Tera crystal overlay.</p></figcaption></figure>

Each Tera type has its own colored overlay pattern. These can be found in `Graphics/Plugins/Terastallization/Patterns`, and are named `tera_pattern_TYPE`, where `TYPE` is the ID of the Tera type for that overlay. If you add a custom Tera type without an overlay pattern, then the default white overlay will be used instead, which is the same pattern used for Tera Normal.

<mark style="background-color:yellow;">**Animating Terastal Overlays**</mark>

The overlay displayed on Terastal sprites is a pattern than can actually move around in a loop, creating an animation of sorts. By default, this overlay will scroll to the right in an erratic fashion, creating a shimmery effect.

<figure><img src="https://2153694798-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvzqYxbzoSOVtGkOgfRUQ%2Fuploads%2FRTIp7LmHsDyBJPKbiA8s%2Fterastal.gif?alt=media&#x26;token=a1bd2a33-e1bc-45c6-bde4-1ef99cb78c06" alt="" width="382"><figcaption><p>Example of an animated terastal pattern.</p></figcaption></figure>

To edit how this pattern moves, you simply have to open the plugin Settings and find the setting `TERASTAL_PATTERN_MOVEMENT`. You will see that this is set to an array containing two symbols.

The first element in this array corresponds to how the overlay animates along the X-axis. The second element in this array corresponds to how the overlay animates along the Y-axis. By combining different settings for each axis, you can control how the pattern moves.

If you'd prefer that the pattern is a still image that doesn't animate, then you would just set this as `[:none, :none]` to prevent any movement on either axis.
