> For the complete documentation index, see [llms.txt](https://reb4ck.gitbook.io/ultimate-core/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://reb4ck.gitbook.io/ultimate-core/modules/dragon/events-explanation.md).

# Events Explanation

{% hint style="info" %}
Plugin Support Mobs From MythicMobs.
{% endhint %}

## EVENT TYPES

| KEY                             | Description                                                                                                           |
| ------------------------------- | --------------------------------------------------------------------------------------------------------------------- |
| GUARDIANS                       | This Event will spawn a certain amount of custom mobs (you can create it in game or you can use mobs from MythicMobs) |
| <p></p><p>NORMAL\_FIREBALLS</p> | <p></p><p>This event will make dragon launch a amount of Fireballs to players around.</p>                             |
| <p></p><p>LIGHTNING </p>        | <p></p><p>This Event will make dragon strike lightnings to players around.</p>                                        |
| <p></p><p>DRAGON\_FIREBALLS</p> | <p></p><p>This Event will make dragon launch Dragon Fireballs to players around.</p>                                  |

## GENERAL SETTINGS                                                                 &#x20;

| KEY          | DESCRIPTION                                                       |
| ------------ | ----------------------------------------------------------------- |
| type         | Type of event that you want.                                      |
| duration     | Duration of the event in seconds.                                 |
| freezeDragon | Set if dragon will be freezed during event.                       |
| dragonSpeed  | Dragon velocity during the event.                                 |
| repeatEvery  | How many seconds do you want the action of the event be repeated. |

## SPECIFIC SETTINGS

### DRAGON\_FIREBALLS

| KEY            | DESCRIPTION                                                                                                                                                                                              |
| -------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| ballsPerSecond | <p></p><p>Max amount of balls that dragon will launch, if you put 10 and there are 5 players dragon will shoot them 2 fireballs, if you put 5 and there are 5 players it will shoot them 1 fireball.</p> |

### NORMAL\_FIREBALLS

| KEY            | DESCRIPTION                                                                                                                                                                                |
| -------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| ballsPerSecond | Max amount of balls that dragon will launch, if you put 10 and there are 5 players dragon will shoot them 2 fireballs, if you put 5 and there are 5 players it will shoot them 1 fireball. |
| damage         | How much damage fireball will make.                                                                                                                                                        |
| particle       | enable or disable lava particle during event.                                                                                                                                              |

### LIGHTNING

| KEY    | DESCRIPTION                         |
| ------ | ----------------------------------- |
| damage | How much damage lightning will make |

### GUARDIANS

| KEY       | DESCRIPTION                                                                                                                                                                                                                                                                                              |
| --------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| amount    | Here you need to put how much guardians do you want.                                                                                                                                                                                                                                                     |
| guardians | <p></p><p>Here you need to put what guardians do you want and the percentage. If you want to add a guardian from guardians.yml use this format "GUARDIAN\_NAME:PERCENTAGE", in case you want to use mob from MythicMobs use this format "MYTHIC\_MOB\_ID:PERCENTAGE:MYTHIC\_MOB:MYTHIC\_MOB\_LEVEL" </p> |

## DragonEvents.yml

```
events:
  kid_dragon:
    1:
      general:
        type: "DRAGON_FIREBALLS"
        duration: 60
        freezeDragon: false
        dragonSpeed: 20
        repeatEvery: 10
      settings:
        ballsPerSecond: 2
    2:
      general:
        type: "NORMAL_FIREBALLS"
        duration: 10
        freezeDragon: true
        dragonSpeed: 0
        repeatEvery: 11
      settings:
        ballsPerSecond: 2
        damage: 100
        particle: true
    3:
      general:
        type: "LIGHTNING"
        duration: 10
        freezeDragon: true
        dragonSpeed: 0
        repeatEvery: 11
      settings:
        damage: 100
    4:
      general:
        type: "GUARDIANS"
        duration: 60
        freezeDragon: false
        dragonSpeed: 20
        repeatEvery: 10
      settings:
        amount: 5
        guardians:
          - "DRAGON_GUARDIAN:100"
          - "MYTHIC_GUARDIAN:90:MYTHIC_MOB:1"
  normal_dragon:
    1:
      general:
        type: "DRAGON_FIREBALLS"
        duration: 60
        freezeDragon: false
        dragonSpeed: 20
        repeatEvery: 10
      settings:
        ballsPerSecond: 2
    2:
      general:
        type: "NORMAL_FIREBALLS"
        duration: 10
        freezeDragon: true
        dragonSpeed: 0
        repeatEvery: 11
      settings:
        ballsPerSecond: 2
        damage: 100
        particle: true
    3:
      general:
        type: "LIGHTNING"
        duration: 10
        freezeDragon: true
        dragonSpeed: 0
        repeatEvery: 11
      settings:
        damage: 100
  ancient_dragon:
    1:
      general:
        type: "DRAGON_FIREBALLS"
        duration: 60
        freezeDragon: false
        dragonSpeed: 20
        repeatEvery: 10
      settings:
        ballsPerSecond: 2
    2:
      general:
        type: "NORMAL_FIREBALLS"
        duration: 10
        freezeDragon: true
        dragonSpeed: 0
        repeatEvery: 11
      settings:
        ballsPerSecond: 2
        damage: 100
        particle: true
    3:
      general:
        type: "LIGHTNING"
        duration: 10
        freezeDragon: true
        dragonSpeed: 0
        repeatEvery: 11
      settings:
        damage: 100
```
