🧠 Core Concepts: How It Works

Helutilities is built on a simple yet powerful loop: Trigger -> Condition -> Reward. Understanding this structure will make configuring the plugin much easier.

1. Triggers

The plugin actively "listens" for specific player actions on your server. When an action occurs, the reward process begins.

• Block Breaking: When a player breaks a block.

• Entity/Player Kills: When a player kills a mob or another player.

• Fishing: When a player successfully catches something.

2. Conditions

When a trigger occurs, the plugin runs a series of checks based on your config.yml. All conditions must be met for a reward to be given.

• Is the relevant module (e.g., mob-kills) enabled?

• Is the player in a disabled world?

• Is the player on cooldown for PvP rewards?

• Was the killed mob spawned from a spawner that is set to be ignored?

3. Rewards

If all conditions are met, the plugin checks the config for rewards defined for that specific trigger (e.g., for DIAMOND_ORE or zombie). It then "rolls the dice" for each potential reward based on its chance percentage to determine what the player receives. It is possible to win multiple rewards from a single event.