# Events

```yaml
events:
  enabled: true
  # Should we choose random event instead of start it by order
  random: false
  # The wait time for each event (in seconds)
  wait-time: 900
  # The placeholders that will be used
  placeholders:
    no-event: '&7ɴᴇxᴛ ᴇᴠᴇɴᴛ'
    no-event-timer: '&7ᴇᴠᴇɴᴛ ɪɴ: &f{timer}'
    active-event: '{display_name}'
    active-event-timer: '&7ᴛɪᴍᴇ ʟᴇғᴛ: &f{timer}'
  # List of events
  # Type: sell_multiplier, generator_upgrade, generator_speed, drop_multiplier, mixed_up
  # Please follow the current format, each event type will have its own unique value
  events:
    2x_sell:
      type: sell_multiplier
      # The display name of the event
      display-name: '&a&l2x Sell Multiplier'
      # The multiplier of the sell
      multiplier: 2.0
      # The duration of the event (in seconds)
      duration: 120
      # The start message
      start-message:
      - '&7'
      - '  #f69220&lEvent Started'
      - '&7'
      - '  #f69220Type: &f{name}'
      - '  #f69220Duration: &f{duration}'
      - '&7'
      - '  &7The value of every Generator drop'
      - '  &7has been increased by 2x &7(( /sell ))'
      - '&7'
      # The end message
      end-message:
      - '&7'
      - '  #f69220&lEvent Ended'
      - '&7'
      - '  #f69220Type: &f{name}'
      - '  #f69220Next Event In: &f{next_duration}'
      - '&7'
      - '  &7The value of all drops are back to normal.'
      - '&7'
      # Blacklisted generator that will not affected by this event
      blacklisted_generators:
      - disabled_generator_id
```

here is an example for how the Upgrade Event is configured you can configure how many tiers above the currently placed generator it will generate and also the duration in seconds the event will last.

```yaml
 1x_upgrade:
      type: generator_upgrade
      # The display name of the event
      display-name: '&b&l1x Generator Upgrade'
      # How many tier should the generator be upgraded
      tier-amount: 1
      # The duration of the event (in seconds)
      duration: 180
      # The start message
      start-message:
      - '&7'
      - '  #f69220&lEvent Started'
      - '&7'
      - '  #f69220Type: &f{name}'
      - '  #f69220Duration: &f{duration}'
      - '&7'
      - '  &7Now every generator will generate drop'
      - '  &7one tier above the current tier.'
      - '&7'
      # The end message
      end-message:
      - '&7'
      - '  #f69220&lEvent Ended'
      - '&7'
      - '  #f69220Type: &f{name}'
      - '  #f69220Next Event In: &f{next_duration}'
      - '&7'
      - '  &7Now every generator back to normal.'
      - '&7'
      # Blacklisted generator that will not affected by this event
      blacklisted_generators:
      - disabled_generator_id
```

here is an example for how the Speed Event is configured you can configure how much percentage the generator will be reducing the drop interval with and also the duration in seconds the event will last.

```yaml
2x_speed:
      type: generator_speed
      # The display name of the event
      display-name: '#f69220&l2x Generator Speed'
      # How much percentage should we reduce the drop interval
      percentage: 50
      # The duration of the event (in seconds)
      duration: 180
      # The start message
      start-message:
      - '&7'
      - '  #f69220&lEvent Started'
      - '&7'
      - '  #f69220Type: &f{name}'
      - '  #f69220Duration: &f{duration}'
      - '&7'
      - '  &7Now every generator will generate drop 2x faster'
      - '&7'
      # The end message
      end-message:
      - '&7'
      - '  #f69220&lEvent Ended'
      - '&7'
      - '  #f69220Type: &f{name}'
      - '  #f69220Next Event In: &f{next_duration}'
      - '&7'
      - '  &7Now every generator back to normal.'
      - '&7'
      # Blacklisted generator that will not affected by this event
      blacklisted_generators:
      - disabled_generator_id
```

here is an example for how the Drop Event is configured & works you can configure how many more dropped items the generators should generate and also the duration in seconds the event will last.

```yaml
2x_drop:
      type: drop_multiplier
      # The display name of the event
      display-name: '&d&l2x Drop Multiplier'
      # How many drop should we execute on every generator?
      drop-amount: 2
      # The duration of the event (in seconds)
      duration: 180
      # The start message
      start-message:
      - '&7'
      - '  #f69220&lEvent Started'
      - '&7'
      - '  #f69220Type: &f{name}'
      - '  #f69220Duration: &f{duration}'
      - '&7'
      - '  &7Now every generator will generate drop 2x more!'
      - '&7'
      # The end message
      end-message:
      - '&7'
      - '  #f69220&lEvent Ended'
      - '&7'
      - '  #f69220Type: &f{name}'
      - '  #f69220Next Event In: &f{next_duration}'
      - '&7'
      - '  &7Now every generator back to normal.'
      - '&7'
      # Blacklisted generator that will not affected by this event
      blacklisted_generators:
      - disabled_generator_id
```

Here is our custom Mixed up event it is fairly unique and mostly a random event so you cant only change the duration it lasts and not the items as it will pick a random item from each generator.

```yaml
3m_mixed_up:
      type: mixed_up
      # The display name of the event
      display-name: '#f69220&lMixed &e&lUp'
      # The duration of the event (in seconds)
      duration: 180
      # The start message
      start-message:
      - '&7'
      - '  #f69220&lEvent Started'
      - '&7'
      - '  #f69220Type: &f{name}'
      - '  #f69220Duration: &f{duration}'
      - '&7'
      - '  &7Now every generator will generate drop from random generator!'
      - '&7'
      # The end message
      end-message:
      - '&7'
      - '  #f69220&lEvent Ended'
      - '&7'
      - '  #f69220Type: &f{name}'
      - '  #f69220Next Event In: &f{next_duration}'
      - '&7'
      - '  &7Now every generator back to normal.'
      - '&7'
      # Blacklisted generator that will not affected by this event
      blacklisted_generators:
      - disabled_generator_id
```

here is an example for how the Sell multiplier Event is configured & works you can configure the multiplier depending on how big you want it to be and also the duration in seconds the event will last.&#x20;

```yaml
 1_5x_sell:
      type: sell_multiplier
      # The display name of the event
      display-name: '&a&l1.5x Sell Multiplier'
      # The multiplier of the sell
      multiplier: 1.5
      # The duration of the event (in seconds)
      duration: 180
      # The start message
      start-message:
      - '&7'
      - '  #f69220&lEvent Started'
      - '&7'
      - '  #f69220Type: &f{name}'
      - '  #f69220Duration: &f{duration}'
      - '&7'
      - '  &7The value of every items that are sellable now'
      - '  &7has been increased by 1.5x &7(( /sell ))'
      - '&7'
      # The end message
      end-message:
      - '&7'
      - '  #f69220&lEvent Ended'
      - '&7'
      - '  #f69220Type: &f{name}'
      - '  #f69220Next Event In: &f{next_duration}'
      - '&7'
      - '  &7Now the value of sellable items go back to normal.'
      - '&7'
      # Blacklisted generator that will not affected by this event
      blacklisted_generators:
      - disabled_generator_id
```

if you want more events then the plugin defaulted provides you can just add however many events you want and modify each type of event as much as you want.

If you are in need of further support or need to report issues or maybe you have suggestions related to NextGens plugin, please join our [Discord Server](https://bit.ly/md-temple).


---

# 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://md-software.gitbook.io/nextgens/configuration-guide/events.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.
