# Perks

<figure><img src="https://2632487102-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvCCMvOKTEzMEbJlMFpfJ%2Fuploads%2F36N5OwEsgz8kMKGNuCD8%2FVid%C3%A9o%20sans%20titre%20%E2%80%90%20R%C3%A9alis%C3%A9e%20avec%20Clipchamp.gif?alt=media&#x26;token=98b0442e-c849-4dce-8aaa-2e930e1107ac" alt=""><figcaption></figcaption></figure>

<details>

<summary>Overview</summary>

<img src="https://2632487102-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvCCMvOKTEzMEbJlMFpfJ%2Fuploads%2FMPiF1Qu8JLvhgnv84KC6%2Fimage.png?alt=media&#x26;token=e597994f-3a41-4883-9f2b-7111089434cc" alt="" data-size="original">

<img src="https://2632487102-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvCCMvOKTEzMEbJlMFpfJ%2Fuploads%2FV7xRnlathd1jLqV7DFOC%2Fimage.png?alt=media&#x26;token=af35df61-e371-489b-a732-f7d41fb0929b" alt="" data-size="original">

<img src="https://2632487102-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvCCMvOKTEzMEbJlMFpfJ%2Fuploads%2F0J6SbonAXLiojDfNUcm1%2Fimage.png?alt=media&#x26;token=438d98a7-5077-469b-a045-851111e55426" alt="" data-size="original">

</details>

**Perks System**

The Perks system is a customizable plugin for Minecraft servers that allows players to unlock and use various perks. The configuration is defined in a YAML file, which includes settings for the GUI, perks, and their respective properties.

#### Configuration Breakdown:

* **Title**: The title of the GUI, displayed as “\&b\&lPerks”.
* **Size**: The size of the GUI, set to 36 slots.

#### Perks:

Each perk has several configurable properties:

1. **target-type**: Specifies whether the perk affects the attacker or defender.
2. **event-type**: Defines the event that triggers the perk (e.g., MINE, KILL, HIT).
3. **chance**: The percentage chance of the perk activating.
4. **selector-slot**: The slot in the GUI where the perk is displayed.
5. **cost**: The cost to unlock the perk.
6. **commands**: The commands executed when the perk activates.
7. **random-command**: If true, selects a random command from the list to execute.
8. **Items**: Defines the appearance of the perk in the GUI when it is locked or unlocked.

#### Example Perks:

* **Haste Perk**: Grants Haste II for 10 seconds when mining, with a 25% chance of activation.
* **Strength Perk**: Grants Strength I for 3 seconds when hitting, with a 5% chance of activation.
* **Speed Perk**: Grants Speed II for 10 seconds when mining, with a 20% chance of activation.
* **Jump Perk**: Grants Jump Boost I for 3 seconds when hitting, with a 10% chance of activation.

#### Editing the Configuration:

To edit the Perks system, follow these steps:

1. **Open the Configuration File**: Locate and open the `Perks.yml` file in your server’s plugin directory.
2. **Modify Properties**: Adjust the properties for each perk as needed. For example, you can change the `chance`, `cost`, or `commands`.
3. **Customize Items**: Edit the `Items` section to change the display name, type, and lore of the perk items in the GUI.
4. **Save and Reload**: Save the changes to the `Perks.yml` file and reload the plugin or restart the server to apply the updates.

***

| Commands | permission           |
| -------- | -------------------- |
| /Perks   | No permission needed |