Perks

a commands based perks system

Overview

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