> For the complete documentation index, see [llms.txt](https://khramcovs-organization.gitbook.io/customworldsystem/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://khramcovs-organization.gitbook.io/customworldsystem/modeling/event-creation.md).

# Event creation

A system designed to manage world events and disasters

### Example

```yaml
events:
  fire_drop:
    eventType: AIR_DROP
    world: world
    timeMinutes: 15 #Cooldown event
    color: BLACK #Color home
    random: true #true | false
    randomCord:
      x1: 5300
      x2: 5301
      z1: 5300
      z2: 5301
    speedBlock: 1 #Falling speed
    message: |-
      &c[&lAir Drop&f] &fAn air drop has appeared in the world &6%world&f!
      &fCoordinates: &cX:&l%randomCord.x1 - %randomCord.x2 &cZ:&l%randomCord.z1 - %randomCord.z2
    loot:
      '1':
        ==: org.bukkit.inventory.ItemStack
        v: 2586
        type: DIAMOND
        amount: 64
      '2':
        ==: org.bukkit.inventory.ItemStack
        v: 2586
        type: NETHERITE_INGOT
      '3':
        ==: org.bukkit.inventory.ItemStack
        v: 2586
        type: ENCHANTED_BOOK
        meta:
          ==: ItemMeta
          meta-type: ENCHANTED
          stored-enchants:
            LOOT_BONUS_BLOCKS: 3
      '4':
        ==: org.bukkit.inventory.ItemStack
        v: 2586
        type: NETHERITE_CHESTPLATE
      '5':
        ==: org.bukkit.inventory.ItemStack
        v: 2586
        type: ARROW
        amount: 64
      '6':
        ==: org.bukkit.inventory.ItemStack
        v: 2586
        type: BOW
      '7':
        ==: org.bukkit.inventory.ItemStack
        v: 2586
        type: NETHERITE_PICKAXE
```

* **timeMinutes** - cooldown in minutes.
* **block** - Block, default is `STONE`.
* **eventType** - Type of event.
* **world** - World specified by name.
* **randomCord** - Coordinates for random placement.
* **radius** - Radius.
* **radiusCrashBlock** - Radius for crash block.
* **time** - Time (in seconds).
* **max\_size** - Maximum size.
* **randomSpawn** - Flag for random spawning.
* **chest\_name** - Name of the chest.
* **x** - X coordinate.
* **y** - Y coordinate.
* **z** - Z coordinate.
* **loot** - List of loot items.
* **speedBlockInTick** - Speed of block per tick.
* **color** - Color.
* **message** - Message.
* **particle** - Particle.
* **level** - Level.
* **type** - Meteorite type.
* **crator** - Crater size.
* **item** - Relic.
* **hologram** - Hologram (not implemented yet).
* **timeInMinute** - Time in minutes.
* **chanceSuperLinghing** - Chance of superlinghing.
* **chanceSuperVortex** - Chance of supervortex.
* **customMob** - Mob.
* **block** - Block specified in the configuration.

<mark style="color:purple;">If you want to set spawn not in range, but at exact coordinates</mark>

```
events:
  fire_drop:
    x: 2000
    y: 200
    z: 2000
```

### <mark style="color:blue;">Setting up event messages</mark>

```
%name
%x
%y
%z
%world
%type
%radius
%cratorSize
%relic
%time
%speedBlock
%chestname
%chanceSuperLinghing
%chanceSuperVortex
%randomCord.x1
%randomCord.x2
%randomCord.z1
%randomCord.z2|
```

### <mark style="background-color:purple;">All event types</mark>

1. AIR\_DROP
2. BLACK\_HOLE
3. METEORIT
4. RELICS\_DROP
5. SECRET\_CARGO
6. STORM
7. HUNTING\_DAY
8. BOSS
9. ZOMBIE\_APOCALYPSE
10. ORE\_FEVER
11. NETHER\_PORTAL\_MOBS
12. EARTHQUAKE
13. SUPER\_NOVA
14. BLOCK\_RAIN
15. FROST
16. INFINITY\_NIGHT
17. QUICK\_HARVEST
18. BLACK\_HOLE

You can find examples of everyone’s work in the YouTube video (it hasn’t been filmed yet)