> For the complete documentation index, see [llms.txt](https://luxurydev.gitbook.io/luxry-club/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://luxurydev.gitbook.io/luxry-club/resources/skymines/perks.md).

# Perks

<figure><img src="/files/8UtukbXTKxjJ2S9Zm7OX" alt=""><figcaption></figcaption></figure>

<details>

<summary>Overview</summary>

<img src="/files/9edRWc1jcdgpwBZhPSGy" alt="" data-size="original">

<img src="/files/DZCFm2pBjlHfADYGsclH" alt="" data-size="original">

<img src="/files/vbtxodgq9lxMIvTIffwR" 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 |