# Animation: Primal Reversion

Though Primal Reversion is incorporated into Essentials by default, it doesn't contain any built-in animations related to the mechanic. To address this, the Deluxe Battle Kit includes its own set of animations for Primal Reversion. The animation style used for Primal Reversion is based on the same animation style this plugin utilizes for Mega Evolution.

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 Primal Reversion animation which is stored as a Common animation named `"Primal"` plus a species ID such as `"PrimalGroudon"` or `"PrimalKyogre"`, then the animations for those species will take priority over the animation added by this plugin. This means that there's no risk of your animations being overwritten or ignored, nor do you need to change anything to make this plugin compatible.
{% endhint %}

***

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

When a Pokemon that meets the conditions for Primal Reversion enters the field, it will immediately Primal Revert. When this occurs, the Primal Reversion animation will play.

<figure><img src="https://2153694798-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvzqYxbzoSOVtGkOgfRUQ%2Fuploads%2FOQXhfHEB41m20f5TAS5S%2Fdemo26.gif?alt=media&#x26;token=9f772dfd-71f4-4980-8970-334e6e173543" alt="" width="381"><figcaption><p>Primal Reversion on the player's side.</p></figcaption></figure>

There will be slight differences in the animation based on which side of the field the Primal Pokemon is on. Pokemon on the player's side of the field will face right, while Pokemon is on the opponent's side of the field will face left. This helps distinguish if the Primal 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%2F473gY3ab8TRi2hNSVBWE%2Fdemo27.gif?alt=media&#x26;token=73c79aca-3207-4066-8db8-abb2c4b99f0f" alt="" width="381"><figcaption><p>Primal Reversion on the opponent's side.</p></figcaption></figure>

Unlike with Mega Evolutions, the animation for Primal Reversion doesn't include a trainer. This is due to Primal Reversion happening independently of any trainer, since it's something that happens passively and not manually activated.

Since Primal Reversion is a mechanic that is exclusive to Groudon and Kyogre by default, their animations are more unique to each of them, whereas the Mega Evolution animation is more generic since it can apply to any Pokemon. With the Primal Reversion animation, an image of the user's specific orb crystallizes around them before they emerge in their Primal forms. The background of the animation also differs to indicate the user, with Groudon's background being red and Kyogre's background being blue.

If you want to include your own custom Primal forms to utilize this animation, you'll have to include the appropriate graphics for the animation to use. These can be stored in \
`Graphics/Plugins/Deluxe Battle Kit/Primal`.&#x20;

You'll need both an icon graphic, as well as a white silhouette for the icon.

***

<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 Primal Reversion 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%2F8CFBfRYI9gQTfeXgVC3k%2Fdemo25.gif?alt=media&#x26;token=25e825af-f7a2-45e4-bd61-9e1299a010a6" alt="" width="381"><figcaption><p>Quick-change animation.</p></figcaption></figure>

The second way to turn off the animation would be to open the Deluxe Battle Kit plugin, and head into the Settings. Here, you'll find the setting  `SHOW_PRIMAL_ANIM`. If you set this to `false`,  the Primal Reversion animation will be shut off permanently, and will be replaced with the quick-change animation above, even when battle animations are turned on.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://lucidious89-tutorials.gitbook.io/deluxe-battle-kit-tutorial/deluxe-battle-kit-for-v21.1/deluxe-animations/animation-primal-reversion.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
