> For the complete documentation index, see [llms.txt](https://wiki.innouniq.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://wiki.innouniq.com/plugins/archieve/advent-season-2022-edition/configuration/options/grinch.md).

# Grinch

Green Elf which hates Christmas. Everyone know this story, right?

He is coming to steal rewards to players. At the end of season, Grinch will change his behaviour and all stolen rewards are given back to players.

## Module

If you are using this resource because of other features and Grinch is not used, you can to disable this module and increase performance of the server.

```yaml
Options:
  Grinch:
    Active: true #false, if module is not used
```

## Season duration

Range of days, while module is active.

```yaml
Options:
  Grinch:
    Season:
      DateFormat: "dd.MM.yyyy HH:mm"
      StartDateTime: "01.12.2022 00:00" #The datetime when the season starts.
      GapDateTime: "24.12.2022 00:00" #The datetime when the rude behaviour is changed to polite.
      EndDateTime: "31.12.2022 23:59" #The datetime when the season ends.
```

{% hint style="warning" %}
Before and after this season, players won't be able to interact with Grinch's figure.
{% endhint %}

## Loot

At claiming reward, Grinch has probability to stole this reward.

```yaml
Options:  
  Grinch:
    Loot:
      DefaultProbability: 25.0 #Min 0%, Max 100%.
```

## Figure (Grinch)

Via **Figure**, players are able to open Grinch's chamber of stolen rewards. Grinch also displays current status of the season.

System offers pre-defined **Armor Stand**, with clothes and head. All values can be changed in the configuration file. System also supports **NPC**, you can aslo equip it with armor or items.

{% hint style="warning" %}
Warning at placing the Figure. Grinch copies your locations and also facing direction!
{% endhint %}

{% hint style="info" %}
To place Assistant type: `/`Grinch `Figure Place`
{% endhint %}

If you have own Armor Stand, you can link it with Advent Figure. It only creates Holograms above the Armor Stand.

{% hint style="info" %}
To link Grinch with the nearest Armor Stand in your range type: `/`Grinch `Figure Link`
{% endhint %}

### Mode

List of modes mentioned above:

* NONE
* ARMOR\_STAND
* PLAYER
* HOLOGRAM

```yaml
Options:
  Grinch:
    Figure:
      Mode: "ARMOR_STAND"
```

### Particle

At location where the Grinch is placed, **particles** are spawned.

```yaml
Options:
  Grinch:
    Figure:
      Particle:
        Active: true
```