# Raid: Raid Dens

Raid Dens are an alternative way of initiating raid battles. Instead of instantly entering a battle like you would with a normal battle event, you can set up a Raid Den event that will generate new Pokemon for you to encounter on a regular basis. This means you can revisit a den to capture new Pokemon, and earn new rewards. You can set up dens of various raid types, such as Max Raid Dens and Tera Raid Dens.

It's also possible to set up special dens that feature exclusive Pokemon that are distributed to players over the internet, like an online event. This can allow you to release special challenge raids to your players as a limited timed event.

Below, I'll explain how to set up your own Raid Dens and how they operate.

***

<mark style="background-color:orange;">**Setting Up a Raid Den**</mark>

To set up a Raid Den event, you need to create a new event with the following criteria:

<details>

<summary>Event name</summary>

The event name should be one of the following, depending on the type of Raid Den you'd like to make:

* `BasicRaidDen`
* `UltraRaidDen`
* `MaxRaidDen`
* `TeraRaidDen`

This is important, as the name of the event allows for certain den features to function, such as which graphic is used, how many tiles of space the event takes up, and other mechanics. Note that these names should have no spaces between each word.

</details>

<details>

<summary>Event animation and graphic</summary>

In the event's Options pane, you must make sure that `Move Animation` should be **unchecked**, while the `Stop Animation` setting should be **checked** off . This is important, otherwise certain visual features of the den event will not work correctly.

In addition, you should *not* set a graphic for the Raid Den event. An appropriate graphic will automatically be set based on the event name that you entered.

</details>

<details>

<summary>Event script command</summary>

The command list of the event should contain the script `pbRaidDen`. This script can either be left exactly as-is, or you may customize it by including up to two additional arguments.

This script accepts the same exact arguments as the `RaidBattle.start` command does, so refer to the "Raid: Battle Call" subsection of this guide for a breakdown on what arguments you may set to customize your Raid Den.

***

<mark style="background-color:orange;">**Argument Differences**</mark>

There are a few small differences between using `pbRaidDen` and `RaidBattle.start` when it comes to the keys that are set in the rules hash of the second argument.

* `:style`\
  Unlike regular raid battles, Raid Den events completely ignore the `:style` key. This is because the type of raid is automatically decided based on the name of the Raid Den event. So using the `:style` setting here will do nothing.\ <br>
* `:loot`\
  Raid Den events accept this key which can be used to set exclusive rewards that are added to a specific raid's loot tables. I'll go into more detail about this in the "Raid Den Rewards Screen" section below.\ <br>
* `:online`\
  Raid Den events accept this key which can be used to toggle whether or not this particular den should be capable of generating a Pokemon distributed by the developer over the internet. If set to `true`, then this den will *always* generate an online event, if one is available. If set to `false`, then this den will *never* generate an online event, even if one is available. If this key is omitted entirely, then by default it will be assumed that this den will have a 1 in 3 chance of generating an online event if one is available. I'll go into more detail about this in the table below, under the "Online Raids" tab.

</details>

The table below will provide a basic example of how each type of Raid Den event should look like both in and out of gameplay.

{% tabs %}
{% tab title="Basic Raids" %}
This is an example of what a Basic Raid Den event looks like.

<figure><img src="https://2153694798-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvzqYxbzoSOVtGkOgfRUQ%2Fuploads%2FCBPgX5ifmtC6etedXKk5%2Fbasic%20event.JPG?alt=media&#x26;token=9b80cc50-9984-4f7a-ae7e-c31159dcd3b9" alt="" width="506"><figcaption><p>Example of a Basic Raid event.</p></figcaption></figure>

Note that Basic Raid Dens take up 3x3 tiles worth of space during actual gameplay, so be mindful of where you place the event. Any event given the name `BasicRaidDen` will automatically load the following graphic to be displayed during gameplay, so no graphic should be manually set for the event.

The Raid Den graphic will automatically update and display differently depending on the current state of the Raid Den. Here are the different states a Basic Raid Den may be in:

* **Purple Eyes**\
  ![](https://2153694798-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvzqYxbzoSOVtGkOgfRUQ%2Fuploads%2FBrW4ErAyva9QMYaCc3w9%2Fbasic%20den%204.png?alt=media\&token=7c9e5709-9e3c-4652-b345-e1dbf049bf28)\
  If the eye color of the Basic Raid Den are purple, that means this den contains an unknown Pokemon to battle. This color will be displayed when the den has been reset with a new Pokemon to encounter.\ <br>
* **Red Eyes**\
  ![](https://2153694798-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvzqYxbzoSOVtGkOgfRUQ%2Fuploads%2FCQOT3jb8X8cwU7dTJglb%2Fbasic%20den%202.png?alt=media\&token=e70da2f4-3a64-4d8f-88df-9c22092480dd)\
  If the eye color of the Basic Raid Den are red, that means this den contains a known Pokemon that has already been saved to this den. While the eyes of this den remain red, you will always encounter the same exact Pokemon each time you enter this den until it is forced to reset.\ <br>
* **Blue Eyes**\
  ![](https://2153694798-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvzqYxbzoSOVtGkOgfRUQ%2Fuploads%2F51dKWqRjDY3kBB72su3V%2Fbasic%20den%203.png?alt=media\&token=7143cbb3-c984-4914-9fc1-3badb6e6c781)\
  If the eye color of the Basic Raid Den are blue, that means this den contains a known Legendary or Mythical species that has already been saved to this den. While the eyes of this den remain blue, you will always encounter the same exact Pokemon each time you enter this den until it is forced to reset.\ <br>
* **Colorless Eyes**\
  ![](https://2153694798-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvzqYxbzoSOVtGkOgfRUQ%2Fuploads%2FCktHljs9QVdcN8FJYGtX%2Fbasic%20den%201.png?alt=media\&token=307fdbf7-07a6-4730-a274-cc9ac08586c9)\
  If the eyes of the Basic Raid Den are colorless, that means this den is empty and contains no Pokemon. You will be unable to enter this den until it has been reset through some means.
  {% endtab %}

{% tab title="Ultra Raids" %}
This is an example of what an Ultra Raid Den event looks like.

<figure><img src="https://2153694798-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvzqYxbzoSOVtGkOgfRUQ%2Fuploads%2FOflJRlL8yuks3LlJY1ej%2Fultra%20event.JPG?alt=media&#x26;token=aab7123b-7509-4fbd-b6fd-ded2d1c09178" alt="" width="504"><figcaption><p>Example of an Ultra Raid event.</p></figcaption></figure>

Note that Ultra Raid Dens take up 3x3 tiles worth of space during actual gameplay, so be mindful of where you place the event. Any event given the name `UltraRaidDen` will automatically load the following graphic to be displayed during gameplay, so no graphic should be manually set for the event.

The Raid Den graphic will automatically update and display differently depending on the current state of the Raid Den. Here are the different states an Ultra Raid Den may be in:

* **Dark Blue Portal**\
  ![](https://2153694798-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvzqYxbzoSOVtGkOgfRUQ%2Fuploads%2Fr5jwP45eOirp3LUrKJ5M%2Fultra%20den%204.png?alt=media\&token=53ca2ccc-bf4e-44ac-812e-3aded0efb73b)\
  If the portal color of the Ultra Raid Den is a dark blue, that means this den contains an unknown Pokemon to battle. This color will be displayed when the den has been reset with a new Pokemon to encounter.\ <br>
* **Red Portal**\
  ![](https://2153694798-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvzqYxbzoSOVtGkOgfRUQ%2Fuploads%2F5eo7zBaKbhA8j9FdKke8%2Fultra%20den%202.png?alt=media\&token=ef897fc8-5077-4715-ba87-366b8e292289)\
  If the portal color of the Ultra Raid Den is red, that means this den contains a known Pokemon that has already been saved to this den. While the portal of this den remains red, you will always encounter the same exact Pokemon each time you enter this den until it is forced to reset.\ <br>
* **Light Blue Portal**\
  ![](https://2153694798-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvzqYxbzoSOVtGkOgfRUQ%2Fuploads%2FOR6942yMPs4gefECt9vP%2Fultra%20den%203.png?alt=media\&token=5ff5686f-0b33-496f-8cf8-bc799bf0e87f)\
  If the portal color of the Ultra Raid Den is a light blue, that means this den contains a known Ultra Beast or Ultra Burst species that has already been saved to this den. While the portal of this den remains blue, you will always encounter the same exact Pokemon each time you enter this den until it is forced to reset.\ <br>
* **Colorless Portal**\
  ![](https://2153694798-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvzqYxbzoSOVtGkOgfRUQ%2Fuploads%2FvYzSyn1u4Sc4AyWgWown%2Fultra%20den%201.png?alt=media\&token=68fa0e14-a34f-4fb2-8696-b8d47502f2c1)\
  If the portal of the Ultra Raid Den is colorless, that means this den is empty and contains no Pokemon. You will be unable to enter this den until it has been reset through some means.
  {% endtab %}

{% tab title="Max Raids" %}
This is an example of what a Max Raid Den event looks like.

<figure><img src="https://2153694798-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvzqYxbzoSOVtGkOgfRUQ%2Fuploads%2FmviJWB3qvwVCPyaiI6ft%2Fmax%20event.JPG?alt=media&#x26;token=a8b7748a-8ea0-4777-9556-2a37262c9779" alt="" width="504"><figcaption><p>Example of a Max Raid event.</p></figcaption></figure>

Note that Max Raid Dens take up 2x2 tiles worth of space during actual gameplay, so be mindful of where you place the event. Any event given the name `MaxRaidDen` will automatically load the following graphic to be displayed during gameplay, so no graphic should be manually set for the event.

The Raid Den graphic will automatically update and display differently depending on the current state of the Raid Den. Here are the different states a Max Raid Den may be in:

* **Purple Beam**\
  ![](https://2153694798-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvzqYxbzoSOVtGkOgfRUQ%2Fuploads%2Fdhq8QJ7sqQX47QXT12bH%2Fmax%20den%204.png?alt=media\&token=8817e4b4-650a-4ec8-8a21-f20a3b80a905)\
  If the beam color of the Max Raid Den is purple, that means this den contains an unknown Pokemon to battle. This color will be displayed when the den has been reset with a new Pokemon to encounter.\ <br>
* **Red Beam**\
  ![](https://2153694798-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvzqYxbzoSOVtGkOgfRUQ%2Fuploads%2Fp8EaUxwmPrPeTyfopTYj%2Fmax%20den%202.png?alt=media\&token=67289173-095f-49cd-9f3d-c672156d737c)\
  If the beam color of the Max Raid Den is red, that means this den contains a known Pokemon that has already been saved to this den. While the beam of this den remains red, you will always encounter the same exact Pokemon each time you enter this den until it is forced to reset.\ <br>
* **Blue Beam**\
  ![](https://2153694798-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvzqYxbzoSOVtGkOgfRUQ%2Fuploads%2FlpYZ02vCvNI542mDR6sF%2Fmax%20den%203.png?alt=media\&token=fe4abae3-965b-47ca-a5d0-0fc39c4b248b)\
  If the beam color of the Max Raid Den is blue, that means this den contains a Calyrex that has already been saved to this den. While the beam of this den remains blue, you will always encounter the same exact Calyrex each time you enter this den until it is forced to reset.\ <br>
* **No Beam**\
  ![](https://2153694798-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvzqYxbzoSOVtGkOgfRUQ%2Fuploads%2FNTvl5P9CFCYY7BWdF66G%2Fmax%20den%201.png?alt=media\&token=04e7e2f7-3597-4091-9410-abbc574a47d0)\
  If there is no beam coming out of the Max Raid Den, that means this den is empty and contains no Pokemon. You will be unable to enter this den until it has been reset through some means.
  {% endtab %}

{% tab title="Tera Raids" %}
This is an example of what a Tera Raid Den event looks like.

<figure><img src="https://2153694798-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvzqYxbzoSOVtGkOgfRUQ%2Fuploads%2Fb7kpCB2x7pRwH4Ntw1Hf%2Ftera%20event.JPG?alt=media&#x26;token=fa1dd9a9-b5e3-4db2-abef-21b5ae5536b8" alt="" width="506"><figcaption><p>Example of a Tera Raid event.</p></figcaption></figure>

Note that Tera Raid Dens take up 2x2 tiles worth of space during actual gameplay, so be mindful of where you place the event. Any event given the name `TeraRaidDen` will automatically load the following graphic to be displayed during gameplay, so no graphic should be manually set for the event.

The Raid Den graphic will automatically update and display differently depending on the current state of the Raid Den. Here are the different states a Tera Raid Den may be in:

* **Light Blue Crystals (Sparkling)**\
  ![](https://2153694798-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvzqYxbzoSOVtGkOgfRUQ%2Fuploads%2FlCbiXJh9oZarC90D0vCH%2Ftera%20den%204.png?alt=media\&token=7f3803a4-1119-4d79-9949-e46f055cd711)\
  If the crystals of the Tera Raid Den are light blue and sparkling, that means this den contains an unknown Pokemon to battle. Sparkles will be displayed when the den has been reset with a new Pokemon to encounter.\ <br>
* **Light Blue Crystals (Not Sparkling)**\
  ![](https://2153694798-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvzqYxbzoSOVtGkOgfRUQ%2Fuploads%2FchoUOdkmA3gjlhGMtRmL%2Ftera%20den%202.png?alt=media\&token=aef4737b-d327-4afd-ad5b-d4ea0df43eb1)\
  If the crystal color of the Tera Raid Den is light blue with no sparkles, that means this den contains a known Pokemon that has already been saved to this den. While the crystals of this den remain in this state, you will always encounter the same exact Pokemon each time you enter this den until it is forced to reset.\ <br>
* **Dark Blue Crystals**\
  ![](https://2153694798-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvzqYxbzoSOVtGkOgfRUQ%2Fuploads%2FSrmwitohRstMcyiToee3%2Ftera%20den%203.png?alt=media\&token=58d44a4c-c142-4e01-bd84-db5c16c27496)\
  If the crystal color of the Tera Raid Den is dark blue, that means this den contains a known Paradox Pokemon or a Pokemon in a special Terastal form that has already been saved to this den. While the crystals of this den remain in this state, you will always encounter the same exact Pokemon each time you enter this den until it is forced to reset.\ <br>
* **Colorless Crystals**\
  ![](https://2153694798-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvzqYxbzoSOVtGkOgfRUQ%2Fuploads%2FPYFaWGAy7vKybXOTApR5%2Ftera%20den%201.png?alt=media\&token=a6556519-fa5f-4485-82b1-d8b1a82e6504)\
  If the crystals of the Tera Raid Den are colorless, that means this den is empty and contains no Pokemon. You will be unable to enter this den until it has been reset through some means.
  {% endtab %}

{% tab title="Online Raids" %}
As the developer, you have the ability to distribute special Raid Den events to your players over the internet. This is done by setting up all of the data for your raid distribution in a [**Pastebin**](https://pastebin.com/) link. If you're familiar with how to set up Mystery Gifts to your players, it's a somewhat similar idea to that.

{% hint style="warning" %}
**Raid Den Availability**

* Only one Raid Den distribution may be active at a time.
* When a Raid Den distribution is live, any Raid Den that the player accesses of a particular type will have a 1 in 3 chance of generating the distributed Raid Den. For example, if you distribute a Tera Raid Den, then all Tera Raid Dens the player accesses may generate the distributed Tera Raid.
* If you don't want a particular Raid Den to ever generate a distributed den, you may enter `:online ⇒ false` in the rules hash for that Raid Den event. This will flag this den so that it isn't able to read data sent over the internet.
* If you want a particular Raid Den to *always* generate a distributed den if one is available, you may enter `:online ⇒ true` in the rules hash for that Raid Den event. This will flag this den so that it always prioritizes data sent over the internet, if any is available.
* If the Raid Den being distributed has a fixed `RaidRank` set, only players that have an appropriate number of badges for that raid rank will be able to encounter this distribution. For example, if you distribute a 5-star Raid Den, only players with 8+ badges will be able to encounter this distribution.
  {% endhint %}

***

<mark style="background-color:orange;">**Pastebin Setup**</mark>

Setting up an online raid distribution is easy. All you have to do is follow the steps below before releasing your game:

1. Go to [**www.pastebin.com**](https://pastebin.com/), and click the green button at the top of the page that says **+ paste** to start a new paste.\ <br>
2. In the text box, enter all of the information you want for your online distribution. This includes all of the attributes the raid Pokemon should have, as well as all of the settings for this raid battle.\ <br>
3. Once you're done with your paste, click "Create New Paste" to save it.\ <br>
4. Once saved, click the "raw" button in the row of buttons above your paste, and it will bring you to a blank webpage that displays nothing but the contents of your paste. Copy the URL of this webpage.\ <br>
5. Go into the Settings file of this plugin. You will see a constant named `LIVE_RAID_EVENT_URL`. Delete the existing string that is set here by default, and paste your copied URL here as a string instead.\ <br>
6. Done! From now on, anything that this URL links to will be the content that is distributed to your players. If you ever want to end distributing any Raid Den data over the internet, you just have to delete all of the content in your paste and replace it with a single character. This is because Pastebin doesn't allow you to save an empty paste, so just replace it with any character as a placeholder.

***

<mark style="background-color:orange;">**Pastebin Content**</mark>

The information entered for your Raid Den distribution is entered similarly to the way you would enter information in most PBS files. This means that you **don't** need to enter quotation marks for strings, brackets for arrays, or colons for symbols.

Here is an example of a basic Raid Den distribution:

```
Species = CHARIZARD
AbilityIndex = 2
Moves = DRAGONPULSE,FLAMETHROWER,SOLARBEAM,AIRSLASH
Shiny = true
RaidRank = 5
RaidStyle = Basic
RaidLoot = CHARCOAL,1
```

This will distribute a 5-star Basic Raid Den vs. Charizard. This Charizard will be shiny and have its Hidden Ability; as well as having the moves Dragon Pulse, Flamethrower, Solar Beam, and Air Slash. In addition, one piece of Charcoal will be added to this Raid Den's loot table.

In the tables below, I'll list every possible criteria you may enter when setting up an online Raid Den distribution. I'll break this down into two groups of criteria: Pokemon attributes, and Raid attributes.

***

<mark style="background-color:orange;">**Pokemon Attributes**</mark>

These are settings that alter the attributes of the actual Pokemon that will be found within the distributed Raid Den. Note that `Species` is the only mandatory data required. All other data is optional.

<table><thead><tr><th width="177">Data</th><th width="145">Value</th><th>Description</th></tr></thead><tbody><tr><td><code>Species</code></td><td>Species ID</td><td>Sets the species for this raid Pokemon. This setting is mandatory.</td></tr><tr><td><code>Form</code></td><td>Integer</td><td>Sets the form number of this raid Pokemon.</td></tr><tr><td><code>Gender</code></td><td>String</td><td>Sets the gender of this raid Pokemon. Enter either <code>0</code>, <code>M</code>, or <code>Male</code> for male, or <code>1</code>, <code>F</code>, or <code>Female</code> for female.</td></tr><tr><td><code>AbilityIndex</code></td><td>Integer</td><td>Sets the ability index of this raid Pokemon.</td></tr><tr><td><code>Moves</code></td><td>Array</td><td>Sets the moves of this raid Pokemon by entering an array of Move ID's.</td></tr><tr><td><code>Item</code></td><td>Item ID</td><td>Sets the held item of this raid Pokemon.</td></tr><tr><td><code>Nature</code></td><td>Nature ID</td><td>Sets the nature of this raid Pokemon.</td></tr><tr><td><code>IV</code></td><td>Array</td><td>Sets the IV's of this raid Pokemon. Set to an array to set the IV values of each stat, or a single number to set the IV's of all stats to that number.</td></tr><tr><td><code>EV</code></td><td>Array</td><td>Sets the EV's of this raid Pokemon. Set to an array to set the EV values of each stat, or a single number to set the EV's of all stats to that number.</td></tr><tr><td><code>Shiny</code></td><td>Boolean</td><td>Sets whether this raid Pokemon is shiny.</td></tr><tr><td><code>SuperShiny</code></td><td>Boolean</td><td>Sets whether this raid Pokemon is super shiny.</td></tr><tr><td><code>HPLevel</code></td><td>Integer</td><td>Sets the wild boss HP scaling for this raid Pokemon. Only set this if you want to override the natural boss HP scaling that this den would normally use. Refer to the "Wild Boss Attributes" section for details.</td></tr><tr><td><code>Immunities</code></td><td>Array</td><td>Sets various wild boss immunities. Note that this will not replace any existing boss immunities that raid Pokemon naturally have; this can only be used to add additional immunities. Refer to the "Wild Boss Attributes" section for details.</td></tr><tr><td><code>Memento</code></td><td>Ribbon ID</td><td>This can only be set if the <a href="https://eeveeexpo.com/resources/1381/"><strong>Improved Mementos</strong></a> plugin is installed. Sets a memento on the raid Pokemon. If the memento grants the Pokemon a title, this title will be displayed above its HP bar in battle.</td></tr><tr><td><code>Scale</code></td><td>Integer (0-255)</td><td>This can only be set if the <a href="https://eeveeexpo.com/resources/1381/"><strong>Improved Mementos</strong></a> plugin is installed. Sets the raid Pokemon's size value.</td></tr><tr><td><code>GmaxFactor</code></td><td>Boolean</td><td>This can only be set if the <a href="https://eeveeexpo.com/resources/1495/"><strong>Dynamax</strong></a> plugin is installed. Sets whether or not the raid Pokemon has G-Max Factor.</td></tr><tr><td><code>TeraType</code></td><td>Type ID</td><td>This can only be set if the <a href="https://eeveeexpo.com/resources/1476/"><strong>Terastallization</strong></a> plugin is installed. Sets a specific Tera type for the raid Pokemon.</td></tr></tbody></table>

***

<mark style="background-color:orange;">**Raid Attributes**</mark>

These are settings that alter the attributes of the distributed Raid Den itself. Note that all of this data is entirely optional.

<table><thead><tr><th width="216">Data</th><th width="125">Value</th><th>Description</th></tr></thead><tbody><tr><td><code>RaidStyle</code></td><td>Raid Type ID</td><td>Sets the specific type of Raid Den to distribute. If omitted, this is always assumed to be a <code>Basic</code> Raid Den by default.</td></tr><tr><td><code>RaidRank</code></td><td>Integer (1-7)</td><td>Sets the difficulty rank of this Raid Den. If omitted, the raid rank will naturally be determined by the <code>Species</code> entered.</td></tr><tr><td><code>RaidSize</code></td><td>Integer (1-3)</td><td>Sets the number of battlers the player can send out in this raid battle. This is set to the value of <code>RAID_BASE_PARTY_SIZE</code> in the plugin Settings by default. This setting is ignored if the <code>RaidPartner</code> setting is used.</td></tr><tr><td><code>RaidPartner</code></td><td>Array</td><td>Sets a partner trainer that should accompany the player in this raid battle. This is set as an array containing a Trainer Type ID, followed by the trainer's name and version number. Optionally, you may also include <code>true</code> if you wish for this trainer to appear in battle exactly as defined in the <code>trainers.txt</code> PBS file (instead of scaling to fit the raid).</td></tr><tr><td><code>RaidTurns</code></td><td>Integer</td><td>Sets the turn counter used in this raid battle. If omitted, the natural turn counter that this raid battle would normally have is set. Set to <code>-1</code> to disable the turn counter entirely.</td></tr><tr><td><code>RaidKOs</code></td><td>Integer</td><td>Sets the KO counter used in this raid battle. If omitted, the natural KO counter that this raid battle would normally have is set. Set to <code>-1</code> to disable the KO counter entirely.</td></tr><tr><td><code>RaidShield</code></td><td>Integer</td><td>Sets the amount of HP the raid Pokemon's raid shield will have. If omitted, the natural amount of shield HP the raid Pokemon would normally have is set. Set to <code>-1</code> to disable the raid shield entirely.</td></tr><tr><td><code>RaidActions</code></td><td>Array</td><td>Overrides the natural extra raid actions the raid Pokemon may utilize during this raid battle. Set as an array containing any of the following to set the desired raid actions:<br><code>:reset_drops</code><br><code>:reset_boosts</code><br><code>:drain_cheer</code></td></tr><tr><td><code>RaidSupportMoves</code></td><td>Array</td><td>Overrides the natural extra support moves the raid Pokemon may select from during this raid battle. Set as an array of Move ID's to set the desired moves.</td></tr><tr><td><code>RaidSpreadMoves</code></td><td>Array</td><td>Overrides the natural extra spread moves the raid Pokemon may select from during this raid battle. Set as an array of Move ID's to set the desired moves.</td></tr><tr><td><code>RaidLoot</code></td><td>Array</td><td>Includes additional bonus rewards to appear in this Raid Den's loot table. This is entered as an array containing an Item ID followed by the quantity of that item to reward. You may add as many pairs of items and quantities as you'd like.</td></tr></tbody></table>
{% endtab %}
{% endtabs %}

***

<mark style="background-color:orange;">**Raid Den Entry Screen**</mark>

When interacting with a Raid Den, you will be asked to save your game prior to the species within being revealed. If you accept, the species will be decided and saved to that den event. Once saved, this den will not generate a new Pokemon until the current one has been defeated or captured, or if the Raid Den has been forced to reset.

<figure><img src="https://2153694798-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvzqYxbzoSOVtGkOgfRUQ%2Fuploads%2F4BRXbRGyTJ0mzsiFvAv0%2F%5B2024-11-28%5D%2008_21_18.116.png?alt=media&#x26;token=1645291c-cf26-4e0a-ad13-045c516345cb" alt="" width="384"><figcaption><p>Example of a Basic Raid Den entry screen.</p></figcaption></figure>

Once the Raid Den species has been decided, the raid entry screen will be displayed. This screen will display a variety of information such as the silhouette of the raid Pokemon, the conditions of this raid battle, and the overall difficulty of the raid indicated by star count.

<details>

<summary>General Displays</summary>

<img src="https://2153694798-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvzqYxbzoSOVtGkOgfRUQ%2Fuploads%2FA0JQCoyieoCRJhZGs5Ml%2F%5B2024-11-28%5D%2008_21_18.117.png?alt=media&#x26;token=d1ac2ff1-bf8b-4d22-a9af-c32f00ba29c0" alt="" data-size="original">

Every entry screen for a Raid Den will display general information that will give you an overall synopsis of what kind of challenge you can expect from this Raid Den. This includes the name of this specific type of Raid Den, the number of stars indicating its difficulty, and the silhouette and typing of the Pokemon you can expect to find inside.

The den name and visual style of the screen will also differ to reflect the specific type of Raid Den this is. Here are the other display styles used for each type of Raid Den:

* **Ultra Raid Den**\
  ![](https://2153694798-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvzqYxbzoSOVtGkOgfRUQ%2Fuploads%2FzTYpRuL6hhEsR9XTx92l%2F%5B2024-11-29%5D%2011_23_05.669.png?alt=media\&token=1e61f4b9-b95e-4d7d-a691-790145712998)
* **Max Raid Den**\
  ![](https://2153694798-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvzqYxbzoSOVtGkOgfRUQ%2Fuploads%2FjDnJF3Obr3IyakAKWGL3%2F%5B2024-11-29%5D%2011_23_13.797.png?alt=media\&token=299624a5-c658-44e9-9852-5a8bf508820d)
* **Tera Raid Den**\
  ![](https://2153694798-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvzqYxbzoSOVtGkOgfRUQ%2Fuploads%2FJbZqyDuwNxkEGVzZ4ihR%2F%5B2024-11-29%5D%2012_48_40.247.png?alt=media\&token=1e582b56-55a9-410c-b155-3123fc0525e4)

***

<mark style="background-color:orange;">**Raid Ranks**</mark>

Below the Raid Den name, you will see a row of 1-7 stars, depending on the raid. These stars indicate the raid's rank, which determines the overall difficulty of this Raid Den. Rank 1 raids are the easiest raids, with rank 5 being the most challenging raids that you can naturally find.

By default, rank 6 raids are exclusively used by Legendary Pokemon, but will never generate naturally unless you manually set the `:rank` to 6 in the den event's rules hash, or if you manually set a legendary species as the raid Pokemon.

Rank 7 raids are the most challenging possible raid rank. Similarly to rank 6 raids, rank 7 raids will never naturally generate, and can only be encountered if you manually set the den's `:rank` to 7.

Note that any Pokemon species that is capable of appearing in raid battles can be forced to appear in any raid rank. However, if no species is manually forced to appear, then only species that are naturally capable of appearing in the specified raid rank will be generated. For example, Mewtwo is exclusively found in rank 6 raids naturally, but you can force Mewtwo to be encountered in a rank 1 raid if you manually set the species and rank of a specific Raid Den.

Below, I'll list out each raid rank and describe when they become naturally available, and what the level ranges may be for the raid Pokemon encountered inside those raids.

* **Rank 1**\
  Naturally Available: Badges 0-7\
  Raid Pokemon Level: 10-15\ <br>
* **Rank 2**\
  Naturally Available: Badges 0-7\
  Raid Pokemon Level: 20-25\ <br>
* **Rank 3**\
  Naturally Available: Badges 3+\
  Raid Pokemon Level: 30-35\ <br>
* **Rank 4**\
  Naturally Available: Badges 6+\
  Raid Pokemon Level: 40-45\ <br>
* **Rank 5**\
  Naturally Available: Badges 8+\
  Raid Pokemon Level: 65-70\ <br>
* **Rank 6**\
  Naturally Available: ---\
  Raid Pokemon Level: 75-80\ <br>
* **Rank 7**\
  Naturally Available: ---\
  Raid Pokemon Level: 100

</details>

<details>

<summary>Raid Battle Conditions</summary>

<img src="https://2153694798-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvzqYxbzoSOVtGkOgfRUQ%2Fuploads%2FIROGBDzRR9WsZWRqira7%2F%5B2024-11-28%5D%2008_21_18.118.png?alt=media&#x26;token=8e0ed53e-45a9-424d-b308-554bbc4b606e" alt="" data-size="original">

In the bottom left quadrant of the Raid Den entry screen will be where the specific battle conditions for this raid battle will be displayed. This will typically display the number of turns you will have to complete the raid, and/or the number of times your Pokemon will be allowed to be KO'd before the raid is considered a loss.

If you manually edit or disable these counters for a specific Raid Den, this will be reflected in the text that is displayed here. If the turn counter and the KO counter are both disabled for this Raid Den, then a generic placeholder message will be displayed here instead.

</details>

<details>

<summary>Battle Participants</summary>

<img src="https://2153694798-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvzqYxbzoSOVtGkOgfRUQ%2Fuploads%2FAQYJm5XZ2kUVEmXb8L7e%2F%5B2024-11-28%5D%2008_21_18.119.png?alt=media&#x26;token=599c1d48-5a2b-4f68-98ab-f74815032c79" alt="" data-size="original">

In the bottom right quadrant of the Raid Den entry screen will be where all participating Pokemon in this raid battle will be displayed. This can display 1-3 Pokemon, depending on the raid settings and other conditions. This will always display your lead Pokemon by default, but you can select other party members to participate instead by selecting the "Change Party" option.

By default, raid battles will always assume to be fought in a 3v1 format, so you will have the option to select 3 Pokemon here. However, there may be various reasons why the raid would accept fewer participants:

* The `RAID_BASE_PARTY_SIZE` in the plugin settings is set to a smaller default party size.
* This particular Raid Den has a `:size` value set in the rules hash to a smaller party size.
* The player has fewer able Pokemon in their party than required by the raid.
* This particular Raid Den has a `:partner` set in the rules hash, forcing it to be a 2v1 battle instead.

***

<mark style="background-color:orange;">**Partner Participants**</mark>

<img src="https://2153694798-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvzqYxbzoSOVtGkOgfRUQ%2Fuploads%2FfnqVDJPbM3Nhrm6wABHc%2F%5B2024-11-29%5D%2011_22_51.853.png?alt=media&#x26;token=e7603c41-d75e-4fbb-b501-e284fb84f494" alt="" data-size="original">

When a raid partner trainer is set to participate with you in a Raid Den, then the entry screen will display a little differently to reflect this. Icons for both the player and the partner trainer will be displayed, with the Pokemon they will be bringing to the raid displayed next to each trainer.&#x20;

Both trainers will only be allowed to bring a single Pokemon with them into the raid battle. The partner trainer's Pokemon cannot be changed, but you will be allowed to select a specific Pokemon to bring like normal.

For more details related to raid partners, check out the "Raid: Battle Mechanics" subsection of this guide.

</details>

<details>

<summary>Battlefield Conditions</summary>

<img src="https://2153694798-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvzqYxbzoSOVtGkOgfRUQ%2Fuploads%2FhdniHwhXHuYCYucy5Yqj%2F%5B2024-11-28%5D%2008_23_03.460.png?alt=media&#x26;token=100d90e1-a5a1-445f-90bd-1a0c5d112cb5" alt="" data-size="original">

Sometimes there may be an additional display in the top right corner of the raid entry screen. This display will have various icons displayed which will indicate special battlefield conditions that will be in play during this raid battle. These conditions include weather, terrain, and the battle environment.

These conditions will be displayed if there is an effect in play that changes the default values for one or more of these conditions. For example, when you are on a map with the `:Storm` weather in play on the overworld, then this will make it so that the Rain weather condition and Electric Terrain will be permanently in play during any battle on this map. This will be carried over into raid battles too, so the Raid Den entry screen will display these icons to reflect that.

Another way this might be applied is through the use of the <mark style="background-color:green;">"weather"</mark>, <mark style="background-color:green;">"terrain"</mark>, and/or <mark style="background-color:green;">"environment"</mark> battle rules. If you manually set one of these rules to change one or more of the default battlefield conditions, then this will be represented in the Raid Den entry screen.

Below, I'll showcase the icons for each battlefield condition, and what they represent.

***

<mark style="background-color:orange;">**Weather Icons**</mark>

<img src="https://2153694798-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvzqYxbzoSOVtGkOgfRUQ%2Fuploads%2FdUbr0CQ6R9snJyKmnRwl%2Fweather_icons.png?alt=media&#x26;token=42540b7e-9d85-45df-977f-c775f4367ea9" alt="" data-size="original">

From left to right, these icons indicate the following weather conditions:

* None (no weather)
* Sun or Harsh Sun
* Rain or Heavy Rain
* Hail or Snow
* Sandstorm
* Strong Winds
* Shadow Sky

Note that icons are present for Primordial weather conditions despite Primordial weather being unable to be set normally. These icons are just here as placeholder.

***

<mark style="background-color:orange;">**Terrain Icons**</mark>

<img src="https://2153694798-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvzqYxbzoSOVtGkOgfRUQ%2Fuploads%2FdPMhZEGWrZYSYoLGzIvA%2Fterrain_icons.png?alt=media&#x26;token=422ea5e9-f217-42f2-9fe5-f509199eb731" alt="" data-size="original">

From left to right, these icons indicate the following battle terrain conditions:

* None (no terrain)
* Grassy Terrain
* Electric Terrain
* Misty Terrain
* Psychic Terrain

***

<mark style="background-color:orange;">**Environment Icons**</mark>

<img src="https://2153694798-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvzqYxbzoSOVtGkOgfRUQ%2Fuploads%2Fcnm8GzpxQxkheeSFeBM0%2Fenviron_icons.png?alt=media&#x26;token=efd4f352-e8a1-41a4-a1d0-9b5106181c2a" alt="" data-size="original">

From left to right, these icons indicate the following environments:

* None (urban areas, interiors)
* Grass or Tall Grass
* Forest or Forest Grass
* Moving Water or Still Water
* Underwater
* Puddle
* Sand
* Rock
* Cave
* Volcano
* Graveyard
* Snow or Ice
* Sky
* Space
* Ultra Space

Note that most Raid Dens take place in the Cave environment by default, unless a rule is in place that manually alters this. The one exception is Ultra Raids, which take place in the Ultra Space environment by default.

***

<mark style="background-color:orange;">**Adding Custom Icons**</mark>

If your game has any custom battlefield conditions that you'd like to be represented by this plugin, you may add custom icons for these conditions in the folder:

```
Graphics/Plugins/Raid Battles/Raid Dens/Field Icons
```

In here, you can add your condition by naming the file based on the ID of that condition with either `weather_`, `terrain_`, or `environ_` as a prefix to the filename, depending on the type of condition it is.

For example, if you created a new terrain called "Lava Terrain" with the ID of `:Lava`, then your new icon would have to be named `terrain_Lava`.

Note that all icons should be 28x28 pixels large to properly fit in the UI.

</details>

<details>

<summary>Other Icons</summary>

In some situations, there may be additional icons that appear just above the selection window of a Raid Den's entry screen, in the upper right quadrant. These icons indicate specific data about this particular Raid Den.

Note that it's possible for multiple icons to appear here at once if more than one conditions are met.

***

<mark style="background-color:orange;">**Bonus Loot Icon**</mark>

<img src="https://2153694798-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvzqYxbzoSOVtGkOgfRUQ%2Fuploads%2FR9kGw2bkwgUsqiw1pfNc%2F%5B2024-12-02%5D%2006_44_22.139.png?alt=media&#x26;token=977ee55c-5411-4021-9361-952607f70171" alt="" data-size="original">

If this particular Raid Den has had extra rewards added to its loot table with the `:loot` property in the den event's rule hash, then this icon will appear to indicate that this den yields exclusive rewards.

***

<mark style="background-color:orange;">**Online Event Icon**</mark>

<img src="https://2153694798-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvzqYxbzoSOVtGkOgfRUQ%2Fuploads%2FJ0LoTR8xO3m6Xiqo08CO%2F%5B2024-12-02%5D%2008_49_41.128.png?alt=media&#x26;token=b04dca9c-2e1c-49fb-89c2-a95cb2dd71b7" alt="" data-size="original">

This icon will appear if the specific Pokemon found in this den is being distributed over the internet via an online event, rather than being naturally generated. Online raid events override whatever Pokemon the particular den would normally spawn.

***

<mark style="background-color:orange;">**Z-Crystal Icon**</mark>

<img src="https://2153694798-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvzqYxbzoSOVtGkOgfRUQ%2Fuploads%2FXhSuGXjEDURX8Z58bY1V%2F%5B2024-11-29%5D%2012_40_16.302.png?alt=media&#x26;token=82b317b1-898c-4547-bfe7-23370c929acf" alt="" data-size="original">

In Ultra Raid Dens specifically, the icon for the specific Z-Crystal that the raid Pokemon will be holding will be displayed in this region of the den's entry screen. This will allow you to prepare for the raid better, as you will have a more general idea of what sort of Z-Moves you can expect to have to deal with during this fight.

***

<mark style="background-color:orange;">**Gigantamax Icon**</mark>

<img src="https://2153694798-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvzqYxbzoSOVtGkOgfRUQ%2Fuploads%2FK21AzGVWruY2zRHzsfcQ%2F%5B2024-11-29%5D%2012_40_23.121.png?alt=media&#x26;token=c73ea805-e9dd-4745-a4a4-6dcd9411eb01" alt="" data-size="original">

In Max Raid Dens specifically, you may occasionally encounter a den with the G-Max Factor icon in this region of the den's entry screen. This icon will indicate that the raid Pokemon encountered in this den will be in its Gigantamax form.

***

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

<img src="https://2153694798-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvzqYxbzoSOVtGkOgfRUQ%2Fuploads%2FsuUdJj8fFCaLpeeClErp%2F%5B2024-11-29%5D%2012_45_58.895.png?alt=media&#x26;token=5ccb77ec-d568-4d2b-a0d7-c52a10a2591e" alt="" data-size="original">

In Tera Raid Dens specifically, the icon for the specific Tera type that the raid Pokemon will have will be displayed in this region of the den's entry screen. This will allow you to prepare for the raid batter, as you will know which type the Terastallized Pokemon will be when encountered.

</details>

***

<mark style="background-color:orange;">**Raid Den Rewards Screen**</mark>

Upon exiting a Raid Den, you will be immediately presented with the raid rewards screen. Depending on the outcome of the raid battle, this window will display various information. If you successfully cleared the raid, you will be granted several rewards that are randomly generated based on the specific raid's reward table. If you captured the raid Pokemon, extra information about the captured Pokemon will be displayed, too.&#x20;

If you failed to clear the raid however, no rewards will be granted.

<figure><img src="https://2153694798-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvzqYxbzoSOVtGkOgfRUQ%2Fuploads%2FbKAWGWA5OXHcyPaM6l4H%2F%5B2024-11-28%5D%2014_44_54.436.png?alt=media&#x26;token=84cfcda9-6720-4cf7-bbb4-f8b70a711eb4" alt="" width="384"><figcaption><p>Example of a Basic Raid Den rewards screen.</p></figcaption></figure>

Below, I'll explain all of the rewards that may be possible to obtain through clearing Raid Dens.

<details>

<summary>Base Reward Tables</summary>

Each raid will grant rewards based on a particular loot table that is generated for that raid. The exact list of rewards and quantities for each item will be random, but follow a general pattern based on the difficulty of the raid.

Generally speaking, the rewards yielded by each raid rank is cumulative with the previous ranks. So for example, a 4-star raid will grant all the same rewards found in ranks 1-3, plus the additional rewards granted by a rank 4 raid. However, the quantities of each item rewarded will be dramatically increased based on the rank of the raid. Lower-ranked raids may only yield 1-3 of each item, while higher-ranked raids may yield as much as 10-25+, depending on the item.

Below, I'll list out every item you may hope to find in a raid's loot table, and what raid ranks you can expect to start seeing those items appear as rewards.

***

<mark style="background-color:yellow;">**Base Rewards**</mark>

* Exp. Candy XS
* Exp. Candy S
* EV-Reducing Berry (Random)
* EV-Increasing Feather (Random)

<mark style="background-color:yellow;">**Raid Ranks 3+**</mark>

* Exp. Candy M
* Rare Candy
* TM/TR (Random; based on raid Pokemon's typing; only 1)
* EV Vitamin (Random)
* PP Up/PP Max (Low odds; only 1)
* Ability Capsule/Ability Patch (Low odds; only 1)
* Low-value sell item (Low odds; only 1)

<mark style="background-color:yellow;">**Raid Ranks 4+**</mark>

* Exp. Candy L (High odds)
* Nature Mint (Random; only 1)
* High-value sell item (Low odds; only 1)

<mark style="background-color:yellow;">**Raid Ranks 5+**</mark>

* Exp. Candy L (Guaranteed)
* Exp. Candy XL (High odds)

<mark style="background-color:yellow;">**Raid Ranks 6+**</mark>

* Exp. Candy XL (Guaranteed)
* Very high-value sell item (Low odds)

</details>

<details>

<summary>Raid-Specific Rewards</summary>

Some rewards are only administered when clearing a certain type of raid. Below, I'll list the specific items that may be earned as rewards in certain types of raids.

***

<mark style="background-color:orange;">**Ultra Raid Dens**</mark>

* <mark style="background-color:yellow;">**Z-Booster**</mark>\
  This item is guaranteed to appear in an Ultra Raid Den's loot table if the raid Pokemon is Necrozma.

***

<mark style="background-color:orange;">**Max Raid Dens**</mark>

* <mark style="background-color:yellow;">**Dynamax Candy**</mark>\
  This item is guaranteed to appear in a Max Raid Den's loot table. The quantity depends on the raid rank.<br>
* <mark style="background-color:yellow;">**Max Soup**</mark>\
  This item has a 50% chance of appearing in a Max Raid Den's loot table if the raid Pokemon was in Gigantamax form.<br>
* <mark style="background-color:yellow;">**Max Honey**</mark>\
  This item is guaranteed to appear in a Max Raid Den's loot table if the raid Pokemon is Vespiquen.<br>
* <mark style="background-color:yellow;">**Max Mushrooms**</mark>\
  This item is guaranteed to appear in a Max Raid Den's loot table if the raid Pokemon is Parasect, Breloom, Amoongus, Shiinotic, or Toedscruel.<br>
* <mark style="background-color:yellow;">**Wishing Star**</mark>\
  This item is guaranteed to appear in a Max Raid Den's loot table if the raid Pokemon is Eternatus.

***

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

* <mark style="background-color:yellow;">**Tera Shards**</mark>\
  These items are guaranteed to appear in a Tera Raid Den's loot table. The specific type of shard depends on the raid Pokemon's Tera type. The quantity depends on the raid rank. If the player has the Glimmering Charm key item in their inventory, the number of Tera Shards awarded will be dramatically increased.<br>
* <mark style="background-color:yellow;">**Mystery Tera Jewel**</mark>\
  This item has a low chance to appear in a Tera Raid Den's loot table.<br>
* <mark style="background-color:yellow;">**Radiant Tera Jewel**</mark>\
  This item is guaranteed to appear in a Tera Raid Den's loot table if the raid Pokemon is Terapagos.

Note that any TM or TR rewards earned from Tera Raid Dens will be randomly decided based on the raid Pokemon's Tera type instead of their natural typing.

</details>

<details>

<summary>Conditional Rewards</summary>

Certain rewards may only appear in a raid's loot table depending on certain battlefield conditions that were in play during the battle. These are the same conditions outlined under "Battlefield Conditions" in the "Raid Den Entry Screen" section above.

It's quite rare for these items to drop from a raid, and when they do, you will only obtain one of each item that drops. These items are more for flavor to match the theme of the raid; so some of them are valuable, while others may be useless. The quality of the items weren't considered when assigning them.

***

<mark style="background-color:orange;">**Weather-Based Rewards**</mark>

* Heat Rock (Sun)
* Damp Rock (Rain)
* Icy Rock (Hail/Snow)
* Smooth Rock (Sandstorm)
* Life Orb (Shadow Sky)
* Smoke Ball (Fog; not in Essentials by default)

***

<mark style="background-color:orange;">**Terrain-Based Rewards**</mark>

* Electric Seed (Electric Terrain)
* Grassy Seed (Grassy Terrain)
* Misty Seed (Misty Terrain)
* Psychic Seed (Psychic Terrain)

***

<mark style="background-color:orange;">**Environment-Based Rewards**</mark>

* Cell Battery (None)
* Miracle Seed (Grass)
* Absorb Bulb (Tall Grass)
* Mystic Water (Moving Water)
* Fresh Water (Still Water)
* Light Clay (Puddle)
* Shoal Shell (Underwater)
* Luminous Moss (Cave)
* Hard Stone (Rock)
* Soft Sand (Sand)
* Shed Shell (Forest)
* Silver Powder (Forest Grass)
* Snowball (Snow)
* Never-melt Ice (Ice)
* Charcoal (Volcano)
* Rare Bone (Graveyard)
* Pretty Feather (Sky)
* Stardust (Space)
* Comet Shard (Ultra Space)

</details>

<details>

<summary>Bonus Rewards</summary>

You may set additional rewards that appear in a specific Raid Den's loot table by setting the `:loot` key in the rule hash used in `pbRaidDen`. This can be set either to an item ID, or an array of item ID's and quantities for each item. You can use this to customize the rewards granted by a specific Raid Den.

For example:

```
:loot ⇒ :NUGGET
```

This will reward the player 1 Nugget for clearing the Raid Den. If you'd like to set a specific number of Nuggets, you can instead set this to something like this:

```
:loot ⇒ [:NUGGET, 5]
```

This would reward 5 Nuggets, instead. You can add as many additional item rewards as you'd like in this manner. Here's a more extreme example:

```
:loot => [:NUGGET, 5, :ENIGMABERRY, 8 :SACREDASH, 1, :ABILITYCAPSULE, 10] 
```

This would reward 5 Nuggets, 8 Enigma Berries, 1 Sacred Ash, and 10 Ability Capsules. Note that these additional rewards will always be granted on top of the base rewards that clearing the raid would normally grant.

If you include bonus rewards through this manner that would already be normally granted by the raid as a base reward, then the additional quantities you manually included here will just be added to the total quantity granted to the player.&#x20;

</details>

***

<mark style="background-color:orange;">**Resetting a Raid Den**</mark>

Once the Pokemon within a Raid Den has been captured or defeated, that den is considered "clear," and will now appear empty. If so, you will no longer be able to interact with that den to initiate a new raid battle until the den has been reset.

Raid Dens may be reset through various means, which I'll outline below.

<details>

<summary>Natural Reset</summary>

Raid Dens will naturally reset each day when the device's clock reaches midnight. If so, all Raid Dens on all maps will generate a new Pokemon to encounter. This includes empty dens as well as dens that have an existing Pokemon saved to them.

</details>

<details>

<summary>Manual Reset</summary>

In *Pokemon Sword & Shield*, you had the ability to manually reset a Max Raid Den by consuming a Wishing Piece from your inventory, and tossing it into the den to lure a new raid Pokemon to battle. This feature did not return for Tera Raid Dens in *Pokemon Scarlet & Violet*, but I chose to include this feature in this plugin and apply it to all Raid Den types.

<img src="https://2153694798-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvzqYxbzoSOVtGkOgfRUQ%2Fuploads%2Fkbfc4UY61L9BZeO2zu0O%2Fraid%20bait.gif?alt=media&#x26;token=bf5b9891-edca-4a2d-ace5-9706dd8c0907" alt="" data-size="original">

Instead of Wishing Pieces, I introduced a more generic item called "Raid Bait" that may be tossed into any type of Raid Den to manually reset it and force a new raid Pokemon to appear. As long as you have at least 1 serving of Raid Bait in your inventory, you will be able to reset any den you wish.

Note that while playing in debug mode, you can manually reset any Raid Den by holding `CTRL` while interacting with a den. This will allow you to reset the den in the same way as show above, but without consuming any Raid Bait, or without even needing the item in your inventory.

</details>

<details>

<summary>Debug Reset</summary>

Finally, there is a third way of resetting Raid Dens while playing in debug mode. In the debug menu, navigate to "Deluxe plugin settings..." and then to "Other plugin settings..." and then "Raid settings...". When selected, you can choose to manually empty or reset all Raid Dens.&#x20;

<img src="https://2153694798-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvzqYxbzoSOVtGkOgfRUQ%2Fuploads%2FZ2DkFJighJXcWoQLZFPp%2F%5B2024-12-01%5D%2008_48_50.555.png?alt=media&#x26;token=ed0aab5c-533a-4e4a-bd44-99ca52bad19b" alt="" data-size="original">

This will affect every single Raid Den event on every map in your game, so keep that in mind when using these options.

</details>